需安装 Zola 扩展、配置文件关联、启用 TOML 支持并设置代码片段：1. 安装 zola-vscode 扩展；2. 在 settings.json 中添加 ”.html”: “zola-html” 和 ”.md”: “zola-markdown”；3. 安装 TOML 扩展并启用格式化；4. 创建 zola-snippets.code-snippets 文件定义常用模板片段。
如果您在使用 VSCode 编辑 Zola 项目时发现 .html、.md 或 .toml 文件缺乏语法高亮、代码补全或模板变量提示，则可能是由于 VSCode 默认未启用对 Zola 模板语法（如 {{}}、{% %}）的识别支持。以下是为 VSCode 添加 Zola 语言支持的具体操作步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装 Zola 官方推荐扩展
Zola 官方维护并推荐一个专用于 VSCode 的语言支持扩展，它提供 .md 文件的 front-matter 解析、TOML 配置高亮、Zola 模板语法着色及常用短代码（shortcodes）提示功能。
1、打开 VSCode，点击左侧活动栏中的扩展图标（或按快捷键 Cmd+Shift+X）。
2、在扩展搜索框中输入 zola-vscode。
3、在搜索结果中找到作者为 Keats 的扩展，名称为 Zola，点击“安装”按钮。
4、安装完成后，重启 VSCode 或重新打开一个 Zola 项目文件夹。
二、手动 配置文件 关联
当 Zola 扩展未自动识别自定义模板文件（如 _index.md、macros.html）时，需通过用户设置强制将特定后缀与 Zola 语言模式绑定，确保语法高亮和片段触发正常生效。
1、按下 Cmd+, 打开设置界面，点击右上角的“打开设置（JSON）”图标。
2、在 settings.json 文件中添加如下配置项：
3、在 "files.associations" 对象内插入键值对：“*.html”: “zola-html” 和 “*.md”: “zola-markdown“。
4、保存文件，关闭并重新打开任意 .html 或 .md 文件以应用新关联。
三、启用 TOML 配置增强支持
Zola 项目的 config.toml 是核心配置文件，启用高级 TOML 支持可获得字段校验、默认键提示及错误定位能力，避免因拼写错误导致构建失败。
1、在扩展市场中搜索并安装 TOML Language Support（作者：telesoho）。
2、安装后，在 VSCode 设置 JSON 中添加：“toml.format.enable”: true。
3、打开 config.toml 文件，右下角状态栏应显示语言模式为 TOML；若未显示，点击该区域手动选择 TOML。
4、输入 base_url 后按 Ctrl+Space，验证是否出现带文档说明的自动补全建议。
四、配置自定义代码片段
VSCode 允许为 Zola 模板语法创建可复用的代码片段，例如快速插入分页导航、分类列表或文章元数据引用，减少重复手工输入。
1、按下 Cmd+Shift+P，输入 Configure User Snippets 并回车。
2、在弹出菜单中选择 New Global Snippets file…，命名为 zola-snippets.code-snippets。
3、在新建文件中粘贴以下 JSON 片段定义：
4、保存文件，新建一个 .html 文件，输入 zpage 后按 Tab 键，验证是否展开为完整的分页结构代码块。
