Sublime Text 配置 Puppet 仅需语法高亮与文件识别：先装 Package Control（控制台执行脚本，失败则手动放 .sublime-package），再装 Puppet 插件，右下角设 .pp 默认语法；文件须 UTF-8 无 BOM，注释仅用 #，变量插值禁空格；Build System 不适用，验证须终端执行 puppet parser validate。
Sublime Text 本身不解释 Puppet 代码，也不执行编译或验证，它只负责语法高亮、基础补全和文件管理——所以配置目标很明确：让 .pp 文件正确着色、自动识别、支持常用编辑操作，不报红、不乱码、不误判语法结构。
安装 Puppet 语法插件前必须装好 Package Control
没装 Package Control，就无法安装任何插件，包括 Puppet 支持。控制台命令运行后必须重启 Sublime 才生效，否则“Install Package”选项不会出现在命令面板里。
- 按
Ctrl+`调出控制台，粘贴官方推荐的 Python 安装脚本（注意 Sublime Text 3/4 对应不同哈希值） - 脚本执行后若输出
Error validating download，说明网络下载失败或校验不匹配，需手动下载Package Control.sublime-package文件，放到Packages/Installed Packages/目录下 - 重启后在
Preferences → Package Control菜单出现，才算真正就位
安装 Puppet 插件后要手动设置 .pp 文件默认语法
插件装完不会自动接管所有 .pp 文件——尤其你之前打开过这类文件，Sublime 可能已缓存为 Plain Text 或 XML 语法。
- 打开任意一个
.pp文件，右下角点击当前语法名（如Plain Text） - 选
Puppet → Set as Default for .pp files，这步会写入Preferences → Settings – Syntax Specific的局部配置 - 如果仍不生效，检查是否误改了全局
Settings – User；语法关联必须走Syntax Specific配置页
常见高亮失效或报错原因：文件编码与注释格式
Puppet DSL 对 UTF-8 BOM 敏感，且注释风格不兼容 Shell 或 Ruby 混用写法。高亮崩了往往不是插件问题，而是内容本身越界。
-
.pp文件必须保存为UTF-8编码（无 BOM），BOM 会导致class、define等关键字无法识别 - 注释只能用
#，不能用//或/* */，后者会被当作文本块处理，破坏节点结构解析 - 变量插值
"hello ${name}"中的${}必须紧邻双引号，中间有空格（如"hello ${ name }"）会断开语法树，导致后续高亮偏移
Build System 不适合 Puppet，别强行配“一键编译”
Puppet 代码不能像 PHP 或 Python 那样直接用 Ctrl+B 运行——它需要 puppet parser validate 或 puppet apply 环境，而这些依赖系统级 Puppet Agent 安装、证书、模块路径等完整栈。Sublime 的 Build System 无法模拟该上下文。
- 试图配
"cmd": ["puppet", "parser", "validate", "$file"]会失败，除非你已在终端确认puppet --version可用，且当前用户有权限读取模块路径 - 更现实的做法是：写完保存后，在终端手动执行
puppet parser validate site.pp，或用shellcheck类思路配合 Terminus 插件内嵌终端验证 - 如果非要集成，建议用 Sublime 的
exec插件封装成命令，但必须显式捕获stderr并解析错误行号，否则报错信息无法跳转定位
真正容易被忽略的是：Puppet 插件不提供语义校验，只做词法着色。哪怕 class 拼错成 clss，高亮照样正常——得靠外部工具验证逻辑正确性。别把颜色对了当成代码对了。
