搭建博客网站的心路历程

个人博客搭建全记录：从工具到踩坑一、核心工具总结1. 本地开发工具

Git用于版本控制和代码提交，主要功能是将本地博客代码同步到 GitHub 等代码托管平台，实现代码备份与远程协作。

Node.js & HexoHexo 是基于 Node.js 的静态博客生成器，通过简单的命令即可将 Markdown 文章转换为可直接部署的静态 HTML 网页，极大简化了博客搭建流程。

2. 网站部署与优化工具

域名从阿里云等平台购买，需完成实名认证。通过 DNS 解析与 Netlify 提供的免费域名关联，实现自定义域名访问。

Netlify提供免费的静态网站托管服务，自动关联 GitHub 仓库，当仓库有新提交时会自动构建并部署网站，还会生成一个免费的临时域名（如 xxx.netlify.app）。

Cloudflare提供免费 CDN 加速服务，通过绑定域名的 DNS 服务器，优化全球访问速度，尤其对国内访问 Netlify 部署的网站有明显加速效果。

二、整体工作架构

本地通过 Hexo 编写 Markdown 文章，执行命令生成静态 HTML 网页；

用 Git 将源代码（包括文章、配置、主题等）提交到 GitHub 仓库托管；

Netlify 监听 GitHub 仓库变化，自动拉取代码并部署为可访问的网站；

Cloudflare 为域名提供 CDN 加速，提升全球用户的访问速度。

三、博客主题与文章书写（待补充：后续可记录主题选择、个性化配置、Markdown 写作技巧等内容）

四、搭建过程中的踩坑记录1. Git 与 GitHub 关联问题

关键误区：本地 Git 配置的 username 和 email 与 GitHub 账号的用户名/密码无直接关联，提交代码时的身份验证需单独配置。

推荐方案：使用 SSH 密钥绑定（而非 token），一劳永逸。token 可能有有效期限制，而 SSH 密钥配置后可长期使用，具体步骤可参考 AI 指引操作。

2. GitHub 提交命令提交代码的完整流程：

1git add . && git commit -m "更新说明" && git push origin main

其中 main 是提交的目标分支，可用 git branch 命令查看当前所在分支。

3. Hexo 命令与自动化配置

基础命令：hexo clean && hexo generate（清除旧文件并生成新的静态网页）。

效率技巧：在 package.json 的 scripts 中配置一键命令：123"scripts": { "syn": "hexo clean && hexo g && git add . && git commit -m '更新提交' && git push origin main"}

之后只需执行 npm run syn 即可完成「清理 → 生成 → 提交 → 推送」全流程。

4. 域名配置的坑

域名解析后需等待全球 DNS 服务器同步，新注册域名可能需要几小时到 1 天才能生效。

必须完成域名实名认证后，才能修改 DNS 服务器（如切换到 Cloudflare 的 DNS）。

无服务器时，可将自定义域名（如 lidarou.com.cn）通过解析指向 Netlify 提供的免费域名，实现自定义域名访问。

5. Netlify 的优势

免费托管静态网站，自动与 GitHub 同步，提交代码后无需手动操作即可更新网站。

自定义域名配置虽然耗时，但操作流程清晰，完成后稳定性良好。

6. Cloudflare 的配置注意

理论上能有效加速国内访问速度（解决 Netlify 部分地区访问慢的问题）。

需完成域名所有权验证才能正常启用 CDN 服务，目前仍在配置中，后续补充细节。