彩蛋:GitHub Pages 的隐藏陷阱

在使用 GitHub Pages 部署静态博客或网站时,我顺手在 GitHub 网页端改了一行文案,结果弹出一个红色提示:

There was an error committing your changes: File could not be edited

当时一脸懵:

  • 仓库权限没问题
  • 文件也不是超大文件
  • 网络也正常

原来罪魁祸首是 GitHub Pages 正在“热发布”
只要站点处于 Active 状态,GitHub 会对部分产物文件加锁,导致网页端无法直接编辑。

最快的解决办法
  1. 进入仓库 → Settings → Pages
  2. Source 临时改为 Deploy from a branch → None
  3. Save(等于暂停 Pages 的实时发布)
  4. 回到 Code 界面,随意修改保存
  5. 改完再把 Pages 的 Source 切回原来的分支,站点秒级恢复

整个过程 30 秒,比 git rebase 还快,专治“网页端改一行字就报错”的尴尬。


小结

  • 开发阶段:本地 vite dev + 浏览器模拟 UA,实时调试。
  • 发布阶段:推送到 gh-pages 分支,一键上线。
  • 热修文案:先停 Pages → 网页端改 → 再启 Pages,避开文件锁。

把这三个小技巧串起来,你就拥有了一个 高可用、零成本、随时热更新 的跨平台 App 分发页。Happy shipping!

Logo

腾讯云面向开发者汇聚海量精品云计算使用和开发经验,营造开放的云计算技术生态圈。

更多推荐