个人博客自建指南 · 专栏导览
简介
从零搭建一个属于自己的技术博客，总共分几步？
本专栏共 7 篇主线 + 7 篇番外，完整记录了一个个人博客从环境搭建到自动化部署的全过程。无论你是刚入门的开发者，还是想把自己的博客从“项目”变成“家”的技术写作者，这份导览都能帮你快速找到需要的篇章。
专栏结构一览
主线（必读，按顺序）
第1篇：环境搭建 —— fnm + Node.js
第2篇：工具链 —— VSCode + pnpm + Vite
第3篇：代码托管 —— Git + Gitee
第4篇：博客本体 —— VitePress 搭建
第5篇：主题微调 —— 品牌色 / 字体 / Logo
第6篇：上线部署 —— ECS + Nginx
第7篇：自动化部署 —— Gitee WebHook
番外（按需阅读）
3.1：AI 协作方法论
4.1：Markdown 生产力配置
5.1：文章信息标准化与 SEO
7.1：新站 SEO 配置
7.2：草稿与私密文章管理
7.3：从乙方思维到需求思维（心路复盘）
品牌故事：阶进遐的诞生
主线篇章（建议按顺序阅读）
第1篇：从零搭建 Node.js 运行环境 —— 用 fnm 实现丝滑版本管理
解决的问题：不同项目需要不同 Node.js 版本，手动卸载重装太麻烦。
核心内容：
- fnm 离线安装（国内代理下载）
- 环境变量配置与 PowerShell 初始化
- 国内镜像加速
- LTS 版本安装与切换
- 项目级
.node-version自动切换
适合读者：刚入门前端开发、需要搭建稳定 Node.js 环境的 Windows 用户。
第2篇：编辑器与工具链 —— VSCode、包管理与 Vite 脚手架
解决的问题：光有 Node.js 还不够，需要编辑器、包管理器和项目骨架。
核心内容：
- VSCode 安装与必备插件
- npm 国内镜像源配置
- pnpm 安装与环境变量配置
- Vite 创建 Vue + TypeScript 项目
- 镜像源 502 的处理办法（含备用源列表）
适合读者：已完成 Node.js 安装、需要搭建完整前端开发环境的用户。
第3篇：代码托管 —— Git 入门与码云实战
解决的问题：代码仅存储在本地不方便，需要托管到云端。
核心内容：
- Git 国内镜像下载安装
- Git Graph 可视化插件
- Gitee 私有仓库创建
- 本地项目关联远程仓库
- Windows 凭据管理器免密推送
- 日常开发流程
适合读者：已完成本地项目搭建、需要将代码托管到云端的初学者。
第4篇：博客构建 —— VitePress 从零到本地预览
解决的问题：从 Vue 项目过渡到真正的博客系统。
核心内容：
- VitePress 脚手架初始化
- 依赖版本升级（ncu 一键更新）
- pnpm 11 构建白名单配置
- 首页与文章编写
- 核心配置（导航 / 侧边栏 / 页脚）
- Markdown 写作入门（含完整示例文章）
适合读者：已完成开发环境搭建、希望快速拥有本地博客的前端新手。
第5篇：主题微调 —— 让博客更像你的
解决的问题：默认主题千篇一律，想让博客有自己的风格。
核心内容：
- 品牌色更换（亮色 / 暗黑双模式）
- 中文字体与代码字体配置
- Logo 与站点名设置（图片 / Base64 双方案）
- 首页 Hero 区域增强
- 导航栏与页脚备案号配置
- 本地搜索启用与汉化
- 文章导览与 404 页面中文配置
适合读者：已完成 VitePress 搭建、希望快速拥有个性化视觉风格的作者。
第6篇：上线部署 —— 从方案选择到 ECS 落地
解决的问题：博客只在本地能看，需要部署到公网。
核心内容：
- 多种部署方案对比（GitHub Pages / Netlify / ECS 等）
- 本地构建生成静态文件
- scp 上传到 ECS
- Nginx 配置（HTTP 自动跳转 HTTPS、SSL 证书、缓存策略）
- 验证上线与后续维护
适合读者：已完成 VitePress 搭建、需要将博客部署到公网的读者。
第7篇：自动化部署 —— git push 直达线上
解决的问题：每次手动 build + scp 太繁琐，想实现一键部署。
核心内容：
- 方案选型对比
- ECS 上安装 fnm / Node.js / pnpm
- 部署脚本编写
- SSH 部署密钥配置
- Node.js WebHook 服务搭建
- pm2 进程托管
- Nginx 反代配置
- Gitee WebHook 对接
- 日常维护与故障排查
适合读者：已完成手动部署、希望实现自动化上线的博客作者。
番外篇章（按需阅读）
3.1 番外：AI 协作二轮三阶段法
解决的问题：用 AI 写技术文章时，AI 凭记忆出错、反复修正效率低。
核心内容：
- “AI 出草稿 → 人逐节迭代 → 终稿打磨”的协作框架
- 三阶段投喂 / 反馈 / 终检模板（可直接复制使用）
- 适用边界说明
适合读者：用 AI 辅助写作的技术博主和内容创作者。
4.1 番外：VSCode 里的 Markdown 生产力配置
解决的问题：手打序号、手动对齐表格、手写目录，每次多耗十分钟。
核心内容：
- Markdown All in One 插件配置
- 目录生成、有序列表自动续号、表格对齐
- 键位冲突修复（一键粘贴 settings.json）
- 快捷键总览与记忆口诀
适合读者：经常用 VSCode 写 Markdown 的技术写作者。
5.1 番外：文章信息标准化 —— SEO 模板与作者时间组件
解决的问题：每篇文章手写作者名、日期、文末落款，容易不一致。
核心内容：
- Front Matter 模板规范
- 自定义 AuthorDate 组件（自动渲染作者与发布日期）
- 全局注入 SEO meta 标签
- 验证清单
适合读者：已完成博客搭建、希望规范化文章信息的作者。
7.1 番外：新站上线后的初级 SEO 配置
解决的问题：新站上线后百度搜不到、必应搜不到，搜索引擎不知道你的存在。
核心内容：
- 站点基础 SEO 设置
- 每篇文章 frontmatter 规范
- sitemap 生成与 robots.txt 配置
- 百度 / 必应站长平台提交
- 知乎回链与 favicon 配置
- 最小 SEO 检查清单
适合读者：已完成博客部署、希望被搜索引擎收录的作者。
7.2 番外：草稿与私密文章 —— 构建但不公开
解决的问题：有些文章写了一半不想公开，但又不想离开写作工作流。
核心内容：
- sitemap 过滤私密目录
- 自动注入 noindex 标签
- robots.txt 禁止抓取
- 屏蔽站内搜索
- 三层保险配置一览
- 验证清单
适合读者：需要在同一工作流中管理公开文章和私密草稿的作者。
7.3 番外：从乙方思维到需求思维 —— 我的博客终于搭起来了
解决的问题：为什么以前搭博客总是搭到一半就放弃了？
核心内容：
- “乙方思维”的陷阱：追求完整系统，忽视真实需求
- “需求思维”的转变：先有内容，再找载体
- 博客是“家”不是“项目”
- 数字宅基地的概念
适合读者：所有在“搭框架热情耗尽”循环里挣扎过的技术人。
品牌故事：阶进遐的诞生
解决的问题：这个博客为什么叫“阶进遐”？
核心内容：
- 从“久行空”到“阶进遐”的完整心路历程
- 与 AI 数十轮对话、查询十几个域名、淘汰二十余个候选方案
- “拾阶递进，渐至遐明”的八字箴言
- X 的多重寓意（遐 / 极客 / 无限可能）
适合读者：对品牌命名感兴趣、想了解博客背后故事的读者。
阅读路线推荐
| 你的身份 | 推荐阅读顺序 |
|---|---|
| 纯新手，从零开始 | 第1篇 → 第2篇 → 第3篇 → 第4篇 → 第5篇 → 第6篇 → 第7篇 |
| 已有 Node.js 环境 | 第2篇 → 第3篇 → 第4篇 → 第5篇 → 第6篇 → 第7篇 |
| 已有博客，想优化 | 第5篇 → 第6篇 → 第7篇 → 7.1 番外 → 7.2 番外 |
| 只想看心路历程 | 7.3 番外 → 品牌故事 |
| 对 AI 协作感兴趣 | 3.1 番外 |
| 想提升写作效率 | 4.1 番外 → 5.1 番外 |
配套资源
本专栏所有内容均为原创实践记录，如有疑问欢迎在知乎对应文章下留言讨论。