在VSCode中需切换终端为Git Bash，cd至Hexo根目录后执行hexo clean && hexo s；改主题或配置后须hexo clean并Ctrl+Shift+R强制刷新，YAML缩进与路径名须严格正确。
如何在VSCode里正确启动Hexo本地服务
直接运行 hexo s 很可能报错或页面空白，核心原因是 VSCode 终端默认用的是 Windows PowerShell 或 CMD，而 Hexo 依赖 Git 的 Unix 工具链（比如 sh、git 命令），PowerShell 不兼容。
必须切换到 Git Bash 才能稳定运行：
- 打开 VSCode → 终端 → 新建终端 → 点击右下角 Shell 类型下拉框 → 选择
Git Bash - 首次使用需确认路径：在设置中搜索
terminal.integrated.defaultProfile.windows，设为Git Bash；或手动添加配置项"terminal.integrated.shell.windows": "C:\Program Files\Git\bin\bash.exe"（路径按你实际 Git 安装位置调整） - 确保当前终端工作目录是 Hexo 项目根目录（含
_config.yml和source/），再执行hexo clean && hexo s - 如果提示
Cannot find module 'hexo-cli'，说明全局命令没被识别，改用npx hexo s（前提是项目已安装hexo-cli作为 devDependency）
修改主题时怎样避免缓存导致样式不更新
VSCode 编辑完主题文件（如 themes/hexo-theme-matery/layout/_partial/head.ejs）后，刷新浏览器却没变化，大概率是 Hexo 的静态资源缓存或浏览器强缓存在作祟。
两个关键动作缺一不可：
- 每次保存主题文件后，在 Git Bash 终端中手动执行
hexo clean—— 这会清空public/目录和内存缓存，否则hexo s会复用旧的渲染结果 - 浏览器访问
http://localhost:4000时，按Ctrl + Shift + R强制重载，绕过所有缓存（不要只点刷新按钮） - 若用的是 NexT、Butterfly 等支持开发模式的主题，可检查其文档是否提供
hexo server --debug或热重载插件（如hexo-browsersync），但多数主题并不原生支持，别盲目装插件增加构建失败风险
VSCode 中高效编辑 Markdown 博客文章的实操配置
写文章时边写边看效果，比反复切窗口预览高效得多，但默认 VSCode 不带实时渲染。
最轻量可靠的方案是启用内置预览：
- 用 VSCode 打开任意
.md文件（如source/_posts/hello-world.md） - 按
Ctrl + K松开，再按V，右侧立刻弹出同步滚动的渲染视图 - 配合插件
markdownlint可实时标出语法错误（比如忘记空格、链接格式错），安装后无需额外配置 - 注意：该预览仅解析标准 Markdown，不执行 Hexo 的 Front-matter、模板变量（如
{{ post.title }}）或主题自定义标签，真实渲染仍以hexo s为准
主题开发阶段如何快速验证 _config.yml 配置是否生效
改了 _config.yml 或主题子配置（如 themes/xxx/_config.yml）后，经常发现设置没起作用，不是语法错就是加载顺序问题。
排查要点很具体：
- 确认缩进：YAML 对空格敏感，
theme:必须顶格，其子项（如menu:）必须严格用 2 个空格缩进，不能用 Tab - 确认层级：主题配置文件名必须是
_config.yml（不是config.yml或_config.yaml），且必须放在themes/your-theme-name/目录下 - 确认主题名拼写：主配置中
theme: matery的值，必须和themes/下文件夹名完全一致（区分大小写），Windows 用户容易忽略这点 - 最直接验证法：在终端运行
hexo generate --debug，观察日志中是否出现INFO Theme config loaded from themes/matery/_config.yml，没这行就说明主题配置根本没被读取
主题开发没有“一键生效”机制，每个改动都要经过 clean → generate → serve 闭环，跳过任一环都可能看到过期结果。尤其注意 hexo s 默认不会监听主题目录变更，改了 .ejs 或 .styl 文件必须手动重启服务。
