Hexo Stellar 是一款极其灵活的主题，由于其功能模块化程度高，开发者更新非常频繁。为了获取最新的 Wiki 功能、渲染优化以及 Bug 修复，定期更新主题是很有必要的。
本文将介绍如何通过 Git 安全地同步 Stellar 主题，并解决更新过程中可能遇到的常见问题。
🛠️ 更新前的核心逻辑
在 Hexo 中，主题通常作为 Git 的一个子模块或独立仓库存在。更新的核心分为三步：拉取代码 -> 同步依赖 -> 重构缓存。
1️⃣ 进入主题核心目录
首先，你需要定位到 Stellar 主题的根目录。
- Windows:
1
cd F:\Hexo-Blog\blog-demo\themes\stellar
- Linux/macOS:
1
cd ~/Hexo-Blog/blog-demo/themes/stellar
2️⃣ 同步远程仓库代码
执行 Git 拉取命令。如果你的主题是通过 git clone 下载的，直接运行：
1 | git pull origin main |
💡 进阶：如果报错提示“Local changes”？
如果你修改了主题内部的代码（如 layout 或 scripts），更新会报错。建议使用 Stash（暂存） 机制：
git stash(暂存本地修改)git pull(拉取更新)git stash pop(合并回修改)
3️⃣ 重新维护环境依赖
Stellar 主题的许多高级渲染功能（如流程图、渲染插件）依赖于特定的 npm 包。更新代码后，务必同步主题目录下的依赖：
1 | # 在 themes/stellar 目录下执行 |
4️⃣ 全局清理与预览
回到博客根目录，进行“大扫除”并重新构建。
1 | cd ../../ |
- hexo clean: 必须执行，否则旧主题的缓存会导致页面排版错乱。
- hexo g: 重新生成静态文件。
- hexo s: 本地预览，重点检查新功能是否生效，以及控制台是否有报错。
⚠️ 避坑指南：给 Stellar 用户的 3 个建议
1. 优先使用 _config.stellar.yml
强烈建议：不要直接修改主题目录下的 _config.yml。
在博客根目录下创建一个 _config.stellar.yml 文件。Hexo 会自动合并配置。这样你在更新主题时，你的个性化配置永远不会被覆盖。
2. 检查插件版本
Stellar 有时会要求配合特定版本的 hexo-renderer-styled 或其他插件。更新后如果渲染异常，请查看主题 GitHub 仓库的 package.json 确认版本要求。
3. 备份是第一生产力
在执行 git pull 前，习惯性地将 themes/stellar 整个目录压缩备份一份，哪怕操作失误也能秒回滚。
🎉 总结
更新 Stellar 主题并不复杂，关键在于依赖同步和缓存清理。建议每个月检查一次更新，让你的博客始终保持最佳性能和最新的交互体验。
