必须手动将 .pp 文件扩展名绑定到 Puppet 语法：打开 .pp 文件 → 点击右下角语言名 → 选择 Puppet → Set as Default for .pp files，否则即使安装了官方 Puppet 插件也不会高亮。
Sublime Text 默认不识别 .pp 文件，装完 Puppet 插件也不高亮，不是插件没装对，而是语法绑定和默认设置没到位——必须手动把 .pp 和 Puppet 语法关联起来，否则它永远当纯文本处理。
怎么让 .pp 文件自动用 Puppet 语法高亮
Sublime 不会根据文件内容（比如 class、define 关键字）自动切换语法，只认扩展名。即使装了 Puppet 插件，.pp 文件仍可能显示为 “Plain Text”，右下角语言标识不会变。
- 打开任意一个
.pp文件，点击右下角当前语言名（如 “Plain Text”） - 选择 Puppet → Set as Default for .pp files
- 这步会写入用户语法映射，之后所有新打开的
.pp文件都会自动启用 Puppet 高亮 - 如果点开后菜单里没有 “Puppet”，说明插件没装成功或没生效，先检查
Preferences → Package Settings下有无Puppet条目
安装 Puppet 插件时容易卡在哪几个地方
常见错误是装了插件但高亮仍不出现，问题往往出在插件来源或版本兼容性上。
- 别搜 “Puppet Syntax” 或 “Puppet Language”——这些大多已停更或不维护；应搜索并安装由
puppetlabs官方维护的Puppet插件（作者名通常显示为 puppetlabs） - Sublime Text 4 用户注意：部分老插件依赖 Python 2.7，而 ST4 默认用 Python 3.8+，会导致插件加载失败；确认插件仓库描述页是否标明 “ST4 compatible”
- 装完插件后不重启 Sublime，
.pp文件可能仍沿用旧缓存；建议关闭再重开编辑器，或用Ctrl+Shift+P输入Reload Syntax强制刷新 - 如果插件安装后
Preferences → Package Settings里没出现Puppet选项，大概率是下载中断或权限问题，可手动清空Packages/User/下残留的Puppet.sublime-settings再重装
为什么 .pp 文件里关键字不着色，但缩进和括号匹配正常
这是典型的语法定义未加载完整的表现：Puppet 插件提供了基础结构识别（如 class 块、大括号配对），但 keyword、resource type、attribute 等 scope 没被当前 color scheme 覆盖。
- 按
Ctrl+Shift+P输入Show Scope Name，把光标放在file或package这类关键字上，看状态栏是否显示类似source.puppet meta.class.puppet support.type.puppet的 scope 链 - 如果只显示
source.puppet，说明插件语法解析没深入到 keyword 层级，需更新插件或换用Puppet Syntax（非官方但 scope 更细） - 如果 scope 正常但颜色仍是灰色，说明当前
color_scheme没定义对应 scope 的foreground；得进Packages/User/xxx.sublime-color-scheme的rules里加一条：{"scope": "support.type.puppet", "foreground": "#56B6C2"}
要不要配构建系统跑 puppet parser validate
可以配，但不推荐直接集成进 Sublime——Puppet 解析依赖本地环境（puppet 命令、模块路径、environment.conf），编辑器里跑容易路径错乱或权限失败。
- 真要验证，用终端执行
puppet parser validate /path/to/file.pp更可靠；Sublime 只负责高亮和基础语法提示 - 如果坚持配构建系统，不要硬编码
/opt/puppetlabs/bin/puppet，改用$PATH查找；且务必在env字段中显式传入PUPPET_ENV和MODULEPATH - 构建输出中文乱码？在构建系统 JSON 里加
"encoding": "utf-8"，并确保系统 locale 是en_US.UTF-8或zh_CN.UTF-8
最易被忽略的一点：Puppet 插件不提供代码补全或 lint，它只做语法高亮和基础折叠。想获得 class 参数提示或 if 语法校验，得额外装 SublimeLinter-puppet-lint 并配置好 puppet-lint 二进制路径——而这一步，90% 的运维人员在配完高亮后就停下了。
