Sublime Text 不能直接运行 Jekyll 服务，它只是编辑器，不带 Ruby 运行时，也不内置 jekyll serve 或 bundle exec 能力；真正启动本地预览或构建静态文件必须依赖终端执行命令。
Sublime Text 能不能直接运行 Jekyll 服务
不能。Sublime Text 是纯文本编辑器，不带 Ruby 运行时、不内置 jekyll serve 或 bundle exec 执行能力，它只负责写文件——_config.yml、_posts/ 下的 Markdown、_layouts/default.html 等。真正启动本地预览、构建静态文件，必须依赖终端（Terminal / Git Bash / PowerShell）执行命令。
怎么让 Sublime Text 支持 Jekyll 文件高亮和快捷操作
靠插件补足基础开发体验，不是装完就“自动支持”，得手动配：
- 安装
Package Control：按Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Install Package Control回车；等几秒后重启 Sublime Text - 装
Jekyll插件：再次Ctrl+Shift+P→ 输入Package Control: Install Package→ 搜索并安装Jekyll（作者：attilabuti）；它会自动识别.md、_config.yml、front matter并启用对应语法高亮 - 可选加
Markdown Preview：同样通过 Package Control 安装，支持Ctrl+Alt+M快速预览当前 Markdown 渲染效果（注意：这只是 HTML 预览，不是 Jekyll 构建后的实际页面，不含 layout、include、Liquid 变量） - 别信“一键编译 Jekyll”类插件：它们大多调用外部 shell，但路径、Ruby 版本、bundle context 极易错，反而增加调试负担；老老实实用终端跑
bundle exec jekyll serve更稳
为什么改了 _config.yml 或 _posts/ 下文件，Sublime Text 里看不到实时刷新
因为 Jekyll 的热重载（live reload）依赖的是 jekyll serve 进程监听文件系统事件，不是编辑器自身功能。Sublime Text 即使开启了 autosave，也只是把文件写入磁盘，不会触发 Jekyll 重建逻辑。
常见误判场景：
- 你改了
_config.yml，但浏览器没刷新 → 实际是 Jekyll 默认不监听配置变更，需手动重启服务（Ctrl+C停掉再bundle exec jekyll serve） - 你改了
_layouts/default.html，页面局部没变 → 确认该 layout 是否被当前页面实际引用（检查 front matter 中的layout:字段）；Jekyll 不会自动清缓存，有时要加--incremental或干脆jekyll clean - 你在 Sublime Text 里保存了
_posts/2026-07-23-test.md，但/blog/test/路径 404 → 检查文件名是否符合YYYY-MM-DD-title.md格式，且 front matter 中published: true（默认为true，但若设为false就不会生成）
Windows 上 Sublime Text 调用 jekyll 命令失败的典型原因
错误信息常是 'jekyll' is not recognized as an internal or external command，本质是 PATH 没导进 Sublime Text 进程环境，跟终端能跑不冲突：
- 确认 Ruby + Devkit 已正确安装，并在 CMD 中能运行
jekyll -v；如果 CMD 也不行，先修 Ruby 环境 - Sublime Text 启动方式影响环境变量：直接双击图标启动时，它继承的是 Windows 图形会话的 PATH，可能不含 Ruby bin 目录；推荐用 Git Bash 启动：
subl .（前提是已配置好subl命令） - 若坚持用图形启动，可在 Sublime Text 的
Preferences → Settings里手动补 PATH（不推荐）："env": { "PATH": "C:\Ruby31-x64\bin;C:\Users\xxx\AppData\Local\Programs\Git\usr\bin;${env:PATH}" }但每次 Ruby 升级都要手动改，容易漏 - 更稳妥的做法：所有 Jekyll 操作（build、serve、clean）只在终端完成；Sublime Text 专注编辑、保存、Git 提交 —— 分工明确，故障面最小
真正卡住人的地方从来不是插件装不装得上，而是 Ruby 环境、Gemset 隔离、bundle exec 作用域这三层嵌套关系没理清。Sublime Text 再顺手，也救不了 Gem::LoadError: Could not find 'jekyll' (>= 0) among 12 gems loaded 这类报错——那得去查 Gemfile 和 bundle install 是否真成功了。
