0005 - 本地修改同步到网站指南

本文详细介绍如何修改本地 MD 文档并将变更同步到您的 Hugo 博客网站。

工作原理

当您修改本地的 MD 文档时，GitHub 上的内容不会自动发生改变。这是因为：

1. 本地 MD 文件是源文件
2. Hugo 需要将这些源文件构建成静态网站
3. 构建后的静态文件需要推送到 GitHub Pages 仓库

完整操作流程

1. 修改本地 MD 文档

• 定位文件：找到您要修改的 MD 文件，位于 content/posts/ 目录下
• 编辑内容：使用任何文本编辑器打开文件，进行添加、修改或删除操作
• 保存文件：确保修改后的内容已保存

2. 构建网站

在博客根目录执行构建命令：

# 进入博客目录
cd /Users/wsq/Documents/blog_wqq/my-tech-blog

# 构建网站
hugo

执行后，Hugo 会重新生成 public/ 目录下的静态网站文件。

3. 部署到 GitHub

进入 public/ 目录并执行部署命令：

# 进入构建目录
cd public

# 暂存更改
git add .

# 提交更改（使用有意义的 commit 信息）
git commit -m "更新笔记内容"

# 推送到 GitHub
git push origin main

4. 验证变更

• 等待时间：部署后需要等待 1-2 分钟，让 GitHub Pages 完成处理
• 访问网站：打开您的博客网站，确认修改已生效
• 刷新页面：如果没有看到变更，尝试刷新浏览器缓存

简化操作命令

您可以将构建和部署步骤合并为一个命令，提高效率：

cd /Users/wsq/Documents/blog_wqq/my-tech-blog && hugo && cd public && git add . && git commit -m "更新笔记内容" && git push origin main

常见问题与解决方案

最佳实践

1. 定期备份：修改前建议备份原始文件
2. commit 信息：使用清晰、有描述性的 commit 信息
3. 本地预览：修改后可使用 hugo server -D 本地预览效果
4. 版本控制：利用 Git 历史记录追踪变更
5. 批量修改：如果有多个文件需要修改，一次性提交所有更改

示例操作

假设您要修改 0001 号笔记的内容：

1. 修改文件：编辑 content/posts/矩阵方程与向量化最小二乘.md
2. 构建：执行 hugo 命令
3. 部署：执行 cd public && git add . && git commit -m "更新0001号笔记内容" && git push origin main
4. 验证：访问 https://wubajie.github.io/posts/矩阵方程与向量化最小二乘/ 查看更新

完成时间：2026-03-07