VSCode 不内置 Jekyll 支持，需手动运行 jekyll serve --livereload 保持后台服务，配合浏览器访问 localhost:4000 实现保存即预览；插件仅限语法高亮，无法替代 Jekyll 进程。
VSCode 本身不内置 Jekyll 支持，也**不会自动监听文件变化并触发 jekyll serve** —— 这是 Ruby 工具链的行为，不是编辑器职责。要实现“保存即预览”，关键在于把 VSCode 变成一个轻量级的、可控的终端调度中心，而不是指望插件“全自动搞定”。
为什么直接装插件没用？
搜索 “Jekyll” 或 “Liquid” 插件，大多只提供语法高亮、片段补全或静态校验，**没有一个能替代 jekyll serve 进程本身**。Jekyll 的实时编译依赖于：
- Ruby 环境（含
jekyllgem）已正确安装并可执行 -
jekyll serve在后台持续运行，并监听_posts/、_layouts/等目录 - VSCode 的文件保存操作能被该进程感知（默认即可，无需额外配置）
换句话说：VSCode 只负责“写”，Jekyll 负责“编译+服务”，两者之间不需要深度集成，只需要不干扰对方就行。
必须手动启动 jekyll serve 并保持后台运行
这是最稳定、最可控的方式。别试图用 Code Runner 一键跑完就退出 —— 那样页面立刻 404。正确做法是：
- 在 VSCode 内置终端（
Ctrl+`）中，cd 到你的 Jekyll 项目根目录（含_config.yml） - 运行
jekyll serve --livereload（加--livereload可让浏览器自动刷新，需额外装gem install jekyll-livereload） - 保持该终端窗口打开；关闭 = 服务停止 = 本地预览失效
- 浏览器访问
http://localhost:4000即可实时看到修改效果
注意：jekyll serve 默认只监听 .md、.html、.yml 等变更，对 _sass/ 或 assets/js/ 文件可能不敏感，这类文件需手动刷新浏览器。
VSCode 里怎么避免终端被意外关掉？
很多人写两行就切走，一不小心关了终端，还以为“预览坏了”。几个实用习惯：
- 给终端起个名字：右键终端标签 →
Rename Terminal→ 输入jekyll-server，一眼识别 - 启用终端复用：在
settings.json中加"terminal.integrated.enablePersistentSessions": true，重启 VSCode 后终端状态可恢复 - 用任务（Task）固化命令：创建
.vscode/tasks.json，内容如下：
{
"version": "2.0.0",
"tasks": [
{
"label": "jekyll serve",
"type": "shell",
"command": "jekyll serve --livereload",
"isBackground": true,
"problemMatcher": [],
"group": "build"
}
]
}之后按 Ctrl+Shift+P → 输入 Tasks: Run Task → 选 jekyll serve，就能一键拉起且标记为“后台任务”，更不容易误关。
别碰“自动保存+自动编译”类插件
像 Run on Save 这类插件，对 Jekyll 是负优化：它每次保存都尝试执行新 jekyll build，但 Jekyll 不是单文件编译器，它需要完整上下文重建整个站点。频繁触发会导致：
- CPU 占用飙升（尤其含大量文章时）
- 输出目录（
_site）被反复擦写，可能中断正在运行的jekyll serve - LiveReload WebSocket 连接断开重连，反而更卡
真正需要“即时反馈”的，是 Sass 编译或 JS 打包环节 —— 那些才适合用 Run on Save 或 watch 模式。Jekyll 核心流程，交给一个稳住的 jekyll serve 就够了。
最易被忽略的一点：确保你用的是系统级 Ruby（如 rbenv 或 asdf 管理的），而不是通过某些 IDE 插件临时注入的 PATH。VSCode 终端有时会读取错误的 shell 初始化文件，导致 jekyll 命令找不到 —— 此时先在系统终端验证 jekyll -v 和 jekyll serve 是否正常，再排查 VSCode 终端环境。
