sublime text 需安装 puppet 插件、正确配置 file_extensions 为 pp、并映射 scope 到主题颜色才能实现 .pp 文件语法高亮与关键字着色；折叠需额外配置或插件支持。
Sublime Text 默认不识别 .pp 文件，也不会高亮 Puppet 语法——装完插件、设对 scope、绑定扩展名，三步缺一不可，否则你看到的还是“Plain Text”。
安装 Puppet 插件后仍不生效？检查是否用了错误的包名
Package Control 中搜 “Puppet” 会出现多个结果，常见混淆项包括：Puppet（由 jfryman 维护，推荐）、puppet-syntax（已归档）、PuppetLabs（非官方，维护停滞）。实际生效且持续更新的是 Puppet 插件。安装后，它会在 Packages/Puppet/ 下生成 Puppet.sublime-syntax 文件；若目录为空或只有 .tmLanguage，说明安装失败或被其他同名插件覆盖。
- 安装前先清空
Packages/User/下可能存在的旧 Puppet 相关文件夹 - 安装后在 Sublime 控制台执行
sublime.installed_packages_path()，确认Puppet.sublime-package确实存在于返回路径中 - 如果插件列表里显示已安装但右下角语言菜单无 Puppet 选项，重启 Sublime 并检查控制台有无
error loading syntax报错
为什么 .pp 文件点开还是 Plain Text？file_extensions 没对上
Puppet.sublime-syntax 文件里定义的 file_extensions 必须显式包含 pp，否则 Sublime 不会自动关联。打开该文件（路径通常为 Packages/Puppet/Puppet.sublime-syntax），确认 YAML 内容含：
file_extensions: - pp
注意：不是 .pp，也不是 ["pp"] 的其他写法；YAML 对缩进和符号敏感，多一个点或少一个短横都会导致解析失败。
- 若你用的是较老版本插件（如基于
.tmLanguage的），需手动创建Packages/User/Puppet.sublime-syntax覆盖默认行为 - 修改后无需重启，但需关闭再重开
.pp文件才能触发重新识别 - 临时验证方法：打开任意
.pp文件 →View → Syntax → Open all with current extension as… → Puppet，成功即说明语法文件可用
高亮有了，但 if/define/class 关键字颜色太淡？scope 颜色未映射到主题
插件只提供语法 scope（如 keyword.control.puppet、entity.name.type.class.puppet），真正决定颜色的是当前 color scheme。多数主流主题（如 Monokai、Material Theme）并未预置 Puppet scope 的配色规则，结果就是关键字显示为默认前景色（常是浅灰），几乎不可见。
- 快捷查看当前光标处 scope：Windows/Linux 按
Ctrl+Alt+Shift+P，Mac 按Cmd+Alt+Shift+P，左下角会显示类似source.puppet keyword.control.puppet - 在主题文件（如
Packages/Material Theme/Themes/Material-Theme-Darker.sublime-color-scheme）的rules数组中添加：
[
{ "scope": "keyword.control.puppet", "foreground": "#FF6B6B" },
{ "scope": "entity.name.type.class.puppet", "foreground": "#4ECDC4" }
]
- 加完保存，Sublime 会自动重载；若无效，检查 JSON 格式是否合法（末尾逗号、引号闭合）
- 不建议直接改原主题文件，可复制一份到
Packages/User/下并重命名，再在Preferences → Settings中通过"color_scheme"指向它
想让 class 定义自动折叠？需要额外启用 folding
Sublime 默认只对 {} 和 if/else 块做折叠，Puppet 的 class { ... } 或 define 块不会自动收起。这不是插件缺陷，而是折叠逻辑依赖 folding_start_marker 和 folding_stop_marker 设置，而 Puppet 插件默认没配。
- 在
Packages/Puppet/Puppet.sublime-syntax的contexts下追加一个foldingcontext，并在main中引用它 - 更简单的方法：安装
BracketHighlighter后，在其用户设置中加入bracket_styles规则，匹配class\s+\w+到}\s*$范围 - 注意：折叠功能对大文件性能影响明显，
.pp超过 2000 行时建议关闭自动折叠或仅对关键 block 启用
最易忽略的一点：Puppet 语法高亮依赖正确的 scope 层级嵌套，比如 template("foo.erb") 中的 ERB 片段，若插件未声明 embed 规则，内部的 就不会按 Ruby 高亮——这种嵌套支持目前仍是手工补全的冷门需求，别指望开箱即用。
