Hugo 专案更新与部署流程

步骤提要

#

1. 复制原专案资料夹、更名
2. 移除新专案 旧Git远端连结
3. 上传新专案到 GitHub，建立新 repository
4. 忽略 /hugo.exe、/public/、/resources
5. 连结到新的 GitHub repository
   →若忘记忽略→ 4.5. 补忽略+删除
6. 验证
7. 部属新专案
   

1. 复制专案资料夹

#

# 在专案的上层目录执行
robocopy [原资料夹名] [新资料夹名]  /MIR

完成后会得到：

专案上层目录
├── [原资料夹] 
└── [新资料夹]

或 git clone

2. 移除新专案 旧Git远端连结

#

进入新专案：

cd [新资料夹]

删掉旧 repo 的 .git：

rmdir /S /Q .git

这样就不会带到：

• 旧 commit
• 旧 remote
• 旧 branch
• 旧 GitHub repo 连结

初始化新的 Git 专案：

git init

建立主分支：

git branch -M main

3. 在 GitHub 上建立新的 repository

#

• 前往 GitHub 网站
• 点击右上角的 “+” → “New repository”
• Repository name 填入：[新资料夹名]
• 选择 Public 或 Private
• 不要勾选 “Initialize this repository with a README”
• 点击 “Create repository”

4. .gitignore 设定忽略

#

从 GitHub Desktop 设定
GitHub Desktop → Repository → Repository settings...

在 Ignored files 中，输入/hugo.exe、/public/、/resources

或 对档案点选右键 → 选单 → Ignored file 在 Ignored files 中，输入/hugo.exe、/public/、/resources

5. 连结到新的 GitHub repository

#

# 添加新的远端连结
git remote add origin https://github.com/[帐号]/[新资料夹名].git

# 推送到新的 repository
git push -u origin main

注意：如果预设分支是 master 而非 main，请将上面的 main 改成 master。可以用 git branch 查看目前的分支名称。

4.5. 补忽略+删除

#

若发现上传到/hugo.exe、/public/、/resources/ 则需 先停止 git追踪，再删除云端档案

停止追踪 hugo.exe 和 public/

#

# 1. 从 Git 追踪中移除（但保留本地档案）
git rm --cached hugo.exe
git rm -r --cached public/
git rm -r --cached resources/

# 2. 确认 .gitignore 内容正确
# 应该包含：
# hugo.exe
# /public/
# /resources/
# 若不正确 → 执行步骤4. 从GitHub Desktop中设定忽略

# 3. 提交这个「停止追踪」的变更
git add .gitignore
git commit -m "Stop tracking hugo.exe, public and resource folder"

# 4. 推送到 GitHub
git push

从 GitHub 删除这些档案

#

上面的 git push 就已经完成删除了！因为：

• git rm --cached = 告诉 Git「不要再追踪这些档案」
• git commit + git push = 把这个「删除追踪」的动作同步到 GitHub
• GitHub 上的 hugo.exe 和 public/ 会被移除

验证是否成功

#

# 检查本地状态
git status
# 应该显示：working tree clean
# hugo.exe 和 public/ 以及 resources/ 不应该出现在列表中

# 检查 GitHub
# 去 GitHub repo 页面看，hugo.exe 和 public/ 以及 resources/ 应该消失了

预期结果

#

• 本地：hugo.exe 和 public/ 以及 resources/ 资料夹还在，可以正常使用
• Git：不再追踪这些档案
• GitHub：这些档案会被删除
• 之后：无论怎么修改这些档案，都不会被 Git 侦测到

6. 验证

#

# 确认远端连结
git remote -v

应该会看到：

origin  https://github.com/[帐号]/[新资料夹名].git (fetch)
origin  https://github.com/[帐号]/[新资料夹名]5.git (push)

完成后，就有两个独立的专案了：

• [原资料夹名] → 连结到旧的 GitHub repo
• [新资料夹名] → 连结到新的 GitHub repo

7. 部属新专案

#

到： Cloudflare Dashboard

Workers 和 Pages [+] 建立应用程式

选 Pages

连接 GitHub repo
若无显示 repo 则需依指示设定 GitHub 应用程式的存取权限

组件设定

#

Framework 预设
无
组件命令
hugo
组件输出目录
/public
环境变数
变数名称HUGO_VERSION = 0.1420

可于 cmd 中输入

hugo version

确认使用的 Hugo 版本