vscode装了puppet扩展却无波浪线，因扩展仅提供高亮与补全，语法检查需手动配置puppet-lint路径、启用puppet.lint.enabled开关，并确保vscode能继承shell环境正确执行该命令。
装了 Puppet 扩展但写错 file { 还没波浪线？说明语法检查根本没跑起来——VSCode 默认不带 lint，必须手动接 puppet-lint，路径、开关、执行上下文三者缺一不可。
为什么 Puppet 扩展装了却没报错
Puppet 扩展（比如 Puppet by jfryman）只负责语法高亮、折叠和基础补全，它不内置任何检查逻辑。所谓“报错”实际是调用系统里安装的 puppet-lint 命令完成的，而 VSCode 不会自动发现或安装它。
- 常见现象：
.pp文件里写成files {（多一个s），VSCode 完全没提示 - 根本原因：
puppet.lint.puppetLintPath没配，或配了但puppet.lint.enabled是false - 验证方式：终端运行
puppet-lint --version，如果报command not found，说明 Ruby 或 gem 没装好
如何让 puppet-lint 被 VSCode 正确调用
关键不是“有没有装”，而是“VSCode 在当前工作区能不能准确执行它”。路径错一个字符、开关没开、Ruby 环境没继承，都会导致静默失效。
- 先确保系统级可用：
gem install puppet-lint（macOS/Linux）或choco install puppet-lint（Windows + Chocolatey） - 若项目用 Bundler，
Gemfile里加gem "puppet-lint"，再运行bundle install - VSCode 设置中搜
puppet.lint.puppetLintPath，填绝对路径：
– macOS/Linux：/usr/local/bin/puppet-lint或~/.gem/ruby/*/bin/puppet-lint
– Windows：C:\Ruby31-x64\bin\puppet-lint.bat（按你实际 Ruby 路径调整） - 必须启用开关：
"puppet.lint.enabled": true，否则路径对了也白搭
puppet-lint 格式化和检查行为不一致
puppet-lint 默认只检查，不改代码；而 VSCode 的 “格式化”（editor.formatOnSave）是另一条链路，二者逻辑分离，容易误以为开了格式化就等于开了检查。
- 检查触发条件：
puppet.lint.enabled+puppet.lint.onSave（默认为true） - 格式化触发条件：
editor.formatOnSave+puppet.format.enable（部分扩展支持，非所有版本都含） - 若想保存即修复（如补空格、换行），需确认扩展支持
--fix参数，并在puppet.lint.puppetLintArgs中加入["--fix"] - 注意冲突：
puppet-lint --fix不处理所有风格问题（例如缩进宽度需靠--indent-size=2单独控制）
最容易被忽略的是环境变量继承问题：如果你在终端能跑 puppet-lint，但在 VSCode 里始终找不到，大概率是它没加载你的 shell 配置（比如 ~/.zshrc）。这时候别只改路径，得去 VSCode 设置里打开 terminal.integrated.inheritEnv，或者在 tasks.json 里显式指定 shell 可执行路径。
