puppet插件不识别.pp文件是因为sublime text默认未将.pp扩展名绑定到puppet语法，必须手动点击右下角“plain text”→选择puppet→“set as default for .pp files”才能启用高亮与功能。
为什么 Puppet 插件在 Sublime Text 里经常不识别 .pp 文件？
默认安装的 Puppet 插件（如 SublimeText-Puppet）不会自动将 .pp 文件关联为 Puppet 语法，导致高亮失效、代码补全缺失、puppet parser validate 无法触发。这不是插件坏了，而是 Sublime 没告诉它“这个后缀归你管”。
- 打开任意
.pp文件 → 点击右下角当前语法名（比如显示 “Plain Text”）→ 选择Open all with current extension as… → Puppet - 更彻底的做法：菜单
Preferences → Settings – Syntax Specific，添加："syntax": "Packages/Puppet/Puppet.tmLanguage"
- 如果没看到
Puppet.tmLanguage，说明插件没装对——优先用 Package Control 安装Puppet（作者是zamsi），别选名字相近但已弃用的sublime-puppet
如何让 Ctrl+Shift+P 快速调用 puppet parser validate？
插件自带的验证命令常卡住或静默失败，根本原因是它调用的是系统 PATH 里的 puppet，而大规模节点开发往往用 r10k + bundle exec 环境，PATH 里压根没有全局 puppet。
- 手动配置 Build System：菜单
Tools → Build System → New Build System，填入：{ "shell_cmd": "cd ${project_path} && bundle exec puppet parser validate ${file}", "file_regex": "^Error: (.+) on line (\d+)", "selector": "source.puppet" } - 保存为
Puppet Bundle Validate.sublime-build，再在右下角 Build System 中选它 - 关键点：
${project_path}必须指向包含Gemfile的环境目录；否则bundle exec会找不到puppet或模块依赖
include 和 require 在大型清单里为何总报 “Could not find class”？
不是语法错，是 Sublime 不知道模块路径在哪，插件的语法检查器（如 linter-puppet-lint）默认只扫 ./modules，而真实环境常用 /etc/puppetlabs/code/modules 或 r10k 部署到 ./site。
- 在项目根目录建
.puppet-lintrc，写入：--- module-path: ./site:/opt/puppetlabs/puppet/modules
- 确保 Sublime 当前打开的是整个代码仓库根目录（而非单个
.pp文件），否则./site路径解析失败 - 插件若仍报错，关掉
linter-puppet-lint的实时检查（设置里设"lint_mode": "save"），避免它在未完成r10k deploy前就扫描空目录
批量修改几十个节点类参数时，怎么避免手抖写错 hiera.yaml 键路径？
Sublime 本身不校验 Hiera 数据结构，但插件可配合 snippet + 自动补全减少出错。真正容易翻车的是键名层级拼写（比如把 profile::apache::port 写成 profile::apach::port），而这类错误直到 puppet agent -t 才暴露。
- 用
Ctrl+Shift+P输入Snippet: Hiera Key（需提前定义 snippet），自动插入形如profile::nginx::server_name:的带冒号模板 - 在
Preferences → Package Settings → Puppet → Settings中加："puppet_module_paths": [ "./site", "./modules" ]
，让插件能跳转到对应类定义，按F12验证键是否存在 - 别依赖插件“猜” Hiera 查找顺序——
hiera.yaml里的:datadir和:hierarchy必须和实际 Puppet Server 配置完全一致，Sublime 不读取服务器端配置
模块路径、Hiera 层级、bundle 环境这三处一旦不匹配，Sublime 里看着绿勾，跑起来照样报错。盯住 puppet config print modulepath 和 puppet config print hiera_config 输出，比插件提示更可靠。
