备份好的Hexo整个文件夹复制到新电脑需要删除部分文件夹避免依赖冲突、hexo g 报错、部署推错分支把备份的hexo.rar文件解压到桌面打开文件夹目录是这样的 C:\Users\Administrator\Desktop\Hexo然后删除这些文件夹node_modulespublicdb.json.deploy_git.git/根目录及 themes/*/ 下package-lock.json可选锁依赖子树跨大版本 Node 时可能报错①安装node.js访问 Node.js 官网 下载电脑版安装②安装Git记得勾选Add to PATH访问 Git 官网 下载电脑版安装③查看下Node.js、Git版本确保安装无误显示版本号说明安装成功④安装好 git 后续都是打开 Git Bash 运行命令1新机先装环境Node.js版本尽量和旧机一致 Git建议跟旧电脑同版本避免渲染差异node-vnpm-vGit-v2安装hexonpminstall-ghexo-cli安装完提示 warn allow-scripts 这些都是提示/警告不是错误不影响你的 Hexo 项目正常使用忽略即可可执行下面命令不再拦截批准 hexo-util 的安装脚本以后不再拦截①查看待审批列表npmapprove-scripts --allow-scripts-pending②批准所有含 hexo-utilnpmapprove-scripts--all3千万别执行 hexo init会覆盖 _config.yml 覆盖成默认直接 安装依赖npminstall4安装butterfly主题插件npminstallhexo-renderer-pug hexo-renderer-stylus--save5安装部署到 github 插件npminstallhexo-deployer-git--save6运行本地预览hexo cleanhexo ghexo s7部署到 github 仓库hexo cleanhexo ghexo d或者双击 deploy.bat 一键部署到 github 仓库访问 http://localhost:4000/ 就可以查看博客了本机IP:40008创建一键部署脚本桌面新建 deploy.txt 文本重命名为 deploy.bat记事本打开复制下面内容进去echo off chcp65001nulcd/d%~dp0echo正在清理缓存... call npx hexo cleanecho正在生成静态文件... call npx hexo generateecho正在部署到 GitHub... call npx hexo deployecho部署完成echo按任意键退出...pausenul保存退出放在hexo根目录双击运行即可换电脑部署到 github 问题1执行以下命令查看当前配置的远程地址gitremote-v如果提示 fatal: not a git repository (or any of the parent directories): .git初始化 Git 仓库gitinit2配置 Git 用户名和邮箱关键Git 全局身份没设因为 deploy.bat 会执行 git push而 Git 提交需要关联用户身份需要先在自己的电脑上设置自己的 Git 用户名和邮箱gitconfig--globaluser.name你的GitHub用户名gitconfig--globaluser.emailgithub绑定的邮箱example.com检查一下是否成功gitconfig--globaluser.namegitconfig--globaluser.email3配置 SSH 密钥关键SSH Key 没在新电脑生成 没加到 GitHubSSH 方式要用自己的 GitHub 账号生成 SSH 密钥并添加到 GitHub否则推送会失败报错Permission denied (publickey).fatal: Could not read from remote repository.输入自己的邮箱地址创建一对密钥一路回车ssh-keygen-ted25519-C你的邮箱example.com查看公钥cat~/.ssh/id_ed25519.pub然后把生成的公钥~/.ssh/id_rsa.pub添加到 GitHub → Settings → SSH and GPG keys 中查看是否成功输入 yesssh-Tgitgithub.com提示 Hi finicb! You’ve successfully 才算成功4修改 _config.yml 中的部署信息需要把 Hexo 根目录下 _config.yml 文件中的 deploy 配置改成自己的仓库地址新版 GitHub 默认分支是 maindeploy: type:gitrepo: gitgithub.com:你的用户名/你的仓库名.github.io.git branch: main5GitHub Pages 的 Source 分支设错代码推成功了但页面 404去仓库 Settings → Pages → Branch 确认选的是你 deploy.branch 对应的分支main / gh-pages目录选 /root。6.deploy_git 残留导致 git 状态冲突旧电脑留下的 .deploy_git/ 里记录着旧机 git 身份/分支新电脑直接 hexo d 会报 fatal: branch already exists 或推送空仓rm-rf.deploy_git hexo d7依赖没装全 Node 版本跨度太大hexo g 阶段就崩间接导致 hexo d 没东西可推。确认npminstall# 按 package.json 重装全部依赖node-v# 尽量和旧机同版本8一键部署脚本本身不需要改deploy.bat 脚本里用的是 npx hexo 和 %~dp0 定位项目目录没有写死用户名信息所以脚本本身是通用的直接复制整个 Hexo 文件夹就能用总结 脚本通用但需要配置自己的 Git 用户信息、SSH 密钥以及修改 _config.yml 里的仓库地址才能成功部署到自己的 GitHub Pages