# YiXuan 的开发随笔 > 一个专注于技术分享与知识沉淀的个人网站。 ## Docs - [异步编程](https://mhaibaraai.cn/raw/docs/fundamentals/async-await.md): 深入理解 Promise 和 async/await 异步编程模式 - [CSS 高级特性](https://mhaibaraai.cn/raw/docs/fundamentals/css.md): CSS 变量、Flexbox 响应式布局等现代 CSS 特性 - [全局变量](https://mhaibaraai.cn/raw/docs/fundamentals/declare-global.md): 在 TypeScript 中使用全局类型。 - [网络请求](https://mhaibaraai.cn/raw/docs/fundamentals/fetch.md): 使用 fetch API 进行网络请求和数据交互 - [Sass 预处理器](https://mhaibaraai.cn/raw/docs/fundamentals/sass.md): Sass 模块化、构建工具配置和弃用警告处理 - [踩坑笔记](https://mhaibaraai.cn/raw/docs/vue/troubleshooting/common.md): 记录 Vue 与 Vite 相关的打包异常、运行时错误等常见问题及详细的解决方案，持续更新前端工程化最佳实践经验。 - [按需自动导入](https://mhaibaraai.cn/raw/docs/vue/auto-import.md): 组件、API 和图标按需自动导入，简化代码并提升开发效率。 - [Element Plus](https://mhaibaraai.cn/raw/docs/vue/element-plus.md): 在使用 Element Plus 组件库时遇到的常见问题及其解决方案。 - [Nuxt UI (Vue + UnoCSS)](https://mhaibaraai.cn/raw/docs/vue/nuxt-ui.md): 在 Vue + Vite 项目中使用 UnoCSS 替代 Tailwind CSS 集成 Nuxt UI 组件库。 - [Vite 资源导入](https://mhaibaraai.cn/raw/docs/vue/resources-import.md): Vite 提供了多种灵活的静态资源导入方式，无需手动管理文件路径。 - [Nuxt Layer ESM/CJS 兼容问题](https://mhaibaraai.cn/raw/docs/nuxt/troubleshooting/esm-cjs-fix.md): 在 Nuxt Layer 架构中使用 pnpm 时，解决 ESM/CJS 模块互操作错误的方法 - [Node.js 版本兼容](https://mhaibaraai.cn/raw/docs/nuxt/troubleshooting/node-version-compatibility.md): Node.js 版本升级导致的原生模块 ABI 不兼容问题及解决方案 - [Nuxt Layer reka-ui SSR 500 错误](https://mhaibaraai.cn/raw/docs/nuxt/troubleshooting/nuxt-layer-reka-ui-ssr.md): 解决在 Nuxt Layer 架构下，reka-ui 多实例加载导致 Vercel SSR 500 错误（Cannot read properties of null (reading 'ce')）的问题。 - [Nuxt UI componentDetection 漏检](https://mhaibaraai.cn/raw/docs/nuxt/troubleshooting/nuxt-ui-component-detection.md): 解决 @nuxt/ui 开启 componentDetection 后，部分组件主题 CSS 未生成、样式完全缺失的问题。 - [Vercel 部署 llms-full.txt](https://mhaibaraai.cn/raw/docs/nuxt/troubleshooting/vercel-llms-deployment.md): 解决 Vercel 平台上 llms-full.txt 动态路由导致 500 错误的问题，并提供完整的 LLM 友好部署方案。 - [Copy Page](https://mhaibaraai.cn/raw/docs/nuxt/copy-page.md): 为用户与 LLM 提供「干净的 Markdown 原文」，可直接复制或在新标签页查看。 - [Nuxt LLMs](https://mhaibaraai.cn/raw/docs/nuxt/llms.md): 使用 nuxt-llms 生成 /llms.txt，并规范化站内链接以便 LLM 抓取。 - [Nuxt SEO](https://mhaibaraai.cn/raw/docs/nuxt/seo.md): Nuxt 搜索引擎优化 (SEO) 入门与进阶配置指南，涵盖 Meta 标签、站点地图、Robots，以及社交平台分享信息优化配置以提升曝光率。 - [Nuxt SSR + PM2 部署](https://mhaibaraai.cn/raw/docs/nuxt/ssr-pm2-deploy.md): 在 Ubuntu 上使用 PM2 集群模式部署 Nuxt SSR，并通过 Nginx（Docker）反向代理与 Cloudflare 前置加速。 - [Vercel + Cloudflare 部署](https://mhaibaraai.cn/raw/docs/nuxt/vercel-cloudflare-deploy.md): 使用 Vercel 和 Cloudflare 部署 Nuxt 项目，绑定自定义域名并实现自动化 CI/CD 流程。 - [全局依赖缓存位置](https://mhaibaraai.cn/raw/docs/java/global-cache.md): 说明 Maven 与 Gradle 全局依赖缓存位置 - [安装 Java 与构建工具](https://mhaibaraai.cn/raw/docs/java/mac-install.md): 如何使用 Homebrew 在 macOS 上安装和管理多个 Java 版本。 - [Docker](https://mhaibaraai.cn/raw/docs/guides/deployment/docker.md): 全面的 Docker 容器化指南，从基础安装配置到进阶使用技巧、常见报错排查，帮助你在各类系统中快速上手构建部署应用。 - [数据库部署](https://mhaibaraai.cn/raw/docs/guides/deployment/database.md): 使用 Docker Compose 部署 PostgreSQL 和 Redis - [GitHub Actions 自动部署](https://mhaibaraai.cn/raw/docs/guides/deployment/github-actions.md): 使用 GitHub Actions + GHCR + Watchtower 实现 Docker 容器自动部署 - [DigitalOcean](https://mhaibaraai.cn/raw/docs/guides/deployment/digitalocean.md): DigitalOcean (DO) 云服务器选购及最佳配置实践，详细记录从基础资源购买绑定、安全配置到通过云应用部署完整站点的所有步骤。 - [GitHub CI 镜像加速](https://mhaibaraai.cn/raw/docs/guides/deployment/github-ci-mirror-acceleration.md): 在腾讯云服务器上加速拉取 GitHub Actions 构建并推送到 GHCR 的 Docker 镜像。 - [SSL 证书配置](https://mhaibaraai.cn/raw/docs/guides/deployment/ssl-certificate.md): SSL 证书配置指南，包含 Cloudflare Origin 证书和 Let's Encrypt 自动续签方案 - [故障排查](https://mhaibaraai.cn/raw/docs/guides/deployment/troubleshooting.md): 部署过程中常见问题及解决方案 - [浙政钉开发](https://mhaibaraai.cn/raw/docs/guides/platforms/dingtalk.md): 浙政钉 H5 应用开发实用技巧，涵盖 VConsole 调试工具集成、企业级应用路由权限管理等常见场景的解决方案以及开发踩坑经验。 - [GitLab CI/CD 完全指南](https://mhaibaraai.cn/raw/docs/guides/platforms/gitlab-ci.md): 一份涵盖从入门、配置到问题排查的完整 CI/CD 实践文档，实现快速上手并高效利用自动化流水线。 - [IServer 踩坑归集](https://mhaibaraai.cn/raw/docs/guides/platforms/iserver.md): 记录使用超图 iServer 服务调用过程中遇到的各种异常问题、错误排查方案，以及最佳实践开发指南，帮助开发者提高排障效率。 - [Linux](https://mhaibaraai.cn/raw/docs/guides/linux.md): Linux 常用命令、服务器管理、开发环境配置等 - [macOS](https://mhaibaraai.cn/raw/docs/guides/macos.md): macOS 环境重装必看指南，记录从零配置系统环境、安装常用工具包及修改关键系统设置的完整步骤，帮助高效进入开发状态。 - [Node](https://mhaibaraai.cn/raw/docs/guides/node.md): Node 的配置和使用指南。 - [Homebrew](https://mhaibaraai.cn/raw/docs/tools/managers/homebrew.md): Homebrew 的配置和使用指南。 - [IntelliJ IDEA](https://mhaibaraai.cn/raw/docs/tools/managers/idea.md): 在 macOS 上安装和配置 IntelliJ IDEA，优化你的 Java 开发环境。 - [Pnpm](https://mhaibaraai.cn/raw/docs/tools/managers/pnpm.md): pnpm 的配置和使用指南。 - [VS Code](https://mhaibaraai.cn/raw/docs/tools/managers/vscode.md): VS Code 的配置和使用指南。 - [Fnm](https://mhaibaraai.cn/raw/docs/tools/version-control/fnm.md): fnm 的安装、配置、使用、常见问题等。 - [Git](https://mhaibaraai.cn/raw/docs/tools/version-control/git.md): Git 的配置、使用、常见问题等。 - [个人配置](https://mhaibaraai.cn/raw/docs/tools/ai.md): 集中维护 Claude、Codex 与 VS Code 等开发工具的个性化设置，便于在不同设备间快速同步环境。 - [OpenRouter](https://mhaibaraai.cn/raw/docs/tools/ai/open-router.md): 通过 OpenRouter 使用各种开源和商业模型 - [2025 年度工作总结](https://mhaibaraai.cn/raw/docs/work-summary/2025.md): 2025 年度个人工作总结，记录在 AI 辅助开发、技术架构优化、以及个人成长与反思等方面的关键成果与未来规划 ## Landing - [YiXuan - 开发随笔](https://mhaibaraai.cn/raw.md): YiXuan 的技术博客——分享 Vue、Nuxt、TypeScript、Java 全栈开发经验，从代码片段到架构思考，记录成长为优秀工程师路上的每一步。 ## Documentation Sets - [YiXuan 的开发随笔](https://mhaibaraai.cn/llms-full.txt): 一个专注于技术分享与知识沉淀的个人网站。从代码片段到架构思考，这里是我在成为更优秀全栈工程师路上的所有笔记。 ## Notes - 技术分享 - 知识沉淀 - 开发随笔