You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

部署在GitHub上的Hexo个人博客无法更新求助

解决Hexo博客部署到GitHub Pages后未同步更新的问题
  • 先确认部署流程是否正确:Hexo并非直接推送本地源码(如_posts、配置文件等)到GitHub仓库即可生效,GitHub Pages仅解析静态HTML文件,你需要通过Hexo专属部署命令将生成的静态文件推送到指定分支:

    1. 清理本地旧生成文件:hexo clean
    2. 生成最新静态文件:hexo generate(简写hexo g)
    3. 部署至GitHub:hexo deploy(简写hexo d)
      可合并为单条命令:hexo clean && hexo d -g
  • 检查_config.yml中的部署配置是否正确,重点核对deploy区块:

    deploy:
      type: git
      repo: git@github.com:username/username.github.io.git  # 替换为你的仓库地址,HTTPS/SSH格式均可
      branch: main  # 若为username.github.io仓库,默认部署分支是main;普通仓库一般用gh-pages
    

    配置错误会导致部署失败,静态文件无法推送到GitHub。

  • 查看GitHub仓库目标分支的内容:比如你配置的是main分支,就去仓库内确认该分支下是否有index.html、css、js这类静态文件,而非Hexo源码文件(_posts、_config.yml等)。如果分支内仍是源码,说明你之前仅推送了本地源码仓库,未执行Hexo部署命令。

  • 检查GitHub Pages部署状态:进入仓库的「Settings」→「Pages」页面,查看最新部署记录是否有失败提示。若部署失败,根据提示修复问题(如权限不足、分支配置错误等)。

  • 强制刷新浏览器:部分情况下浏览器会缓存旧页面,按下Ctrl+F5(Windows/Linux)或Cmd+Shift+R(Mac)强制刷新后再查看博客页面。

内容的提问来源于stack exchange,提问作者Sieoer Li

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.16 13:55:17