部署在GitHub上的Hexo个人博客无法更新求助
解决Hexo博客部署到GitHub Pages后未同步更新的问题
先确认部署流程是否正确:Hexo并非直接推送本地源码(如
_posts、配置文件等)到GitHub仓库即可生效,GitHub Pages仅解析静态HTML文件,你需要通过Hexo专属部署命令将生成的静态文件推送到指定分支:- 清理本地旧生成文件:
hexo clean - 生成最新静态文件:
hexo generate(简写hexo g) - 部署至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
相关产品推荐
相关产品推荐

