vscode 默认不识别 .sls 文件，需手动关联为 yaml 语言以启用基础语法支持；red hat yaml 插件无法校验 saltstack 语义，须结合 salt-call --local state.show_sls 等命令行工具进行实际解析验证。
VSCode 默认不识别 .sls 文件，也不会对 SaltStack State 的语法、函数参数或模块调用做任何校验——哪怕你把 file.managed 拼成 file.mangaged，编辑器也完全沉默。
怎么让 VSCode 识别 .sls 文件为 YAML
SaltStack 的 SLS 文件本质是 YAML（支持 Jinja），但 VSCode 不会自动把 top.sls 或 nginx/init.sls 当作 YAML 处理，导致缩进提示、折叠、括号匹配全失效。
- 点击右下角状态栏的「Plain Text」或当前语言标识（如「SLS」），选择「Configure File Association for '.sls'…」
- 在弹出的 JSON 片段中填入：
"*.sls": "yaml" - 保存后，所有
.sls文件会立刻获得 YAML 基础能力：缩进高亮、YAML 折叠、---分隔符识别 - ⚠️ 注意：如果项目里混用
.sls.j2或.sls.template，需额外加映射，例如："*.sls.j2": "yaml"
为什么装了 Red Hat YAML 插件还不校验 SaltStack
Red Hat YAML 插件只提供通用 YAML 解析和 Kubernetes 等内置 Schema 支持，它**没有 SaltStack 官方 Schema**，所以 pkg.installed 字段是否必填、sources 是否接受列表、user 能否用于 cmd.run —— 这些全不会报错或提示。
- 目前 SaltStack 社区未发布权威 JSON Schema，官方文档也未托管结构化定义
-
yaml.schemas配置里填"kubernetes"或 URL 对 SLS 无效；填"*/*.sls"绑定任意 Schema 也不会触发校验 - 别尝试用
salt --output=json state.show_sls xxx导出结构当 Schema——输出是执行结果，不是声明式结构定义 - 真实有效的做法只有两个：靠插件 + 手动 lint，或用
salt-ssh本地 dry-run
实际可用的校验手段：插件 + 命令行组合
放弃“全自动语义校验”幻想，转而建立轻量但可靠的反馈闭环：
- 安装
redhat.vscode-yaml并完成上一步语言关联，确保基础 YAML 语法错误（冒号缺失、缩进错乱、重复 key）能被标红 - 安装
ms-python.python（即使不用 Python 开发）——它附带的pylint可通过自定义插件支持 SaltStack，但门槛高；更简单的是用命令行 - 在终端运行：
salt-call --local state.show_sls nginx -l warning，它会解析 SLS 并报告 Jinja 错误、YAML 解析失败、模块名不存在（如pkg.instaalled）等 - 加
--retcode-passthrough让命令退出码反映错误，方便集成到 pre-commit 或保存时脚本 - VSCode 中可配置任务：
tasks.json添加一个state.show_sls任务，绑定快捷键 Ctrl+Alt+S 快速验证当前文件
容易被忽略的细节：Jinja 和 YAML 的交互陷阱
SLS 文件里 Jinja 表达式和 YAML 结构紧耦合，VSCode 的 YAML 解析器无法理解 {{ grains['os'] }} 是变量还是字面量，这直接导致两类高频误报：
- 注释后紧跟 Jinja 会破坏缩进感知，例如：
user: root # default user\n{% if grains['os'] == 'CentOS' %}→ 下一行可能被当成顶层 key - 多行 Jinja（
{% set x = [1,2,3] %}）若换行位置不当，YAML 解析器会提前截断，补全和悬停失效 - 解决方案：所有 Jinja 块前后空一行；避免在 YAML value 内联复杂 Jinja；用
{% raw %}...{% endraw %}包裹易混淆的字符串 - VSCode 设置里关掉
yaml.format.enable，否则自动格式化会把 Jinja 格式搞崩
真正卡住人的从来不是语法高亮，而是 file.managed 的 source_hash 参数该不该加、watch_in 和 require_in 的依赖方向是否反了——这些只能靠文档查 + salt-call --local state.show_lowstate 看最终渲染结构来确认。
