Hexo升级手册

version 0.1

1. SSH 配置

为了区分不同的 Git 服务，需要配置 SSH 连接。

1. 修改 SSH 配置文件 ~/.ssh/config，添加如下内容：

   1 2 3 4 5 6 7

   # GitHub SSH配置 Host github HostName github.com User git Port 22 IdentityFile ~/.ssh/github_id_rsa IdentitiesOnly yes

2. 通过以下命令验证 SSH 连接：

   1	ssh -vT git@github.com

2. 环境配置

macOS 下 NVM 安装

1. 安装 NVM（Node Version Manager）：

   1	brew install nvm

2. 列出可用的 Node.js 版本：

   1	nvm ls-remote

3. 安装指定版本的 Node.js：

   1	nvm install xxx

   其中 xxx 选择的 Node.js 版本。

3. Hexo 升级

1. 进入 Hexo 项目目录。

2. 查看当前 Hexo 版本：

   1	hexo version

3. 全局升级 hexo-cli：

   1	npm i hexo-cli -g

4. 再次查看版本以确认升级成功：

   1	hexo version

5. 安装 npm-check（如果尚未安装）：

   1	npm install -g npm-check

6. 检查项目依赖是否需要升级：

   1

   npm-check

7. 安装 npm-upgrade（如果尚未安装）：

   1	npm install -g npm-upgrade

8. 更新 package.json：

   1	npm-upgrade

9. 更新全局插件：

   1	npm update -g

10. 更新项目依赖：

    1	npm update --save

11. 最后，再次查看 Hexo 版本以确认升级成功：

    1	hexo version

4. 备份当前配置

1. 备份 Hexo 目录：

   1	tar -czf hexo_backup_$(date +%Y%m%d).tar.gz /path/to/hexo

   替换 /path/to/hexo 为你的 Hexo 项目路径。

5. Troubleshooting

如果在升级过程中遇到问题，这里提供一些常见问题及其解决方案：

问题 1: 升级后网站样式丢失

• 可能原因：主题配置文件未更新或被覆盖。
• 解决方案：恢复主题配置文件的备份，或从主题的源仓库中获取最新的配置文件样本。

问题 2: 插件不兼容

• 可能原因：插件不支持新版的 Hexo 或 Node.js。
• 解决方案：
  • 检查插件的 GitHub 仓库，看是否有相关的兼容性更新。
  • 降级不兼容的插件或替换为其他相似功能的插件。

6. 版本回退

1. 使用 NVM 管理 Node.js 版本：

   1	nvm use xxx

   其中 xxx 是要回退到的 Node.js 版本号。

2. 回退 Hexo 版本：

   1 2	npm uninstall hexo-cli -g npm install hexo-cli@x.x.x -g

   其中 x.x.x 是要回退到的 Hexo 版本号。

3. 恢复 Hexo 项目文件：

   使用之前备份的 tar.gz 文件恢复项目。

   1	tar -xzf hexo_backup_date.tar.gz -C /path/to/hexo

   替换 hexo_backup_date.tar.gz 为备份文件名。

更新日志：