ansible lint 不报错是因为 vscode 未正确配置：必须将 .yml 文件语言模式设为“ansible”（非 yaml），ansible.lint.path 和 ansible.path 均需填入绝对路径且与当前 python 环境一致，并配置 yaml.schemas 支持第三方 collection。
Ansible Lint 不报错，不是它坏了，而是 VSCode 根本没调用它——ansible-lint 从不内嵌，只靠你本地装的命令行工具 + 正确路径 + 正确语言模式三者同时满足才触发。
为什么保存后 ansible-lint 完全静默？
这不是插件 bug，是配置断链导致的“零响应”：不报错、不提示、Problems 面板空着，连语法错误都漏过。
-
redhat.vscode-ansible插件默认不监听.yml文件，除非你手动把文件语言模式设为 Ansible（不是 YAML，不是 YAML (Ansible)，就只是Ansible） - 右下角状态栏显示
YAML或Plain Text→ lint 永远不会启动 - 点右下角语言标识 →
Configure File Association for '.yml'→ 输入ansible回车 → 勾选“将“.yml”文件与此语言关联” → 重启编辑器窗口（不是重载） - 完成后顶部状态栏必须显示
Ansible，否则后续所有 lint、补全、Jinja2 高亮全部失效
ansible.lint.path 必须填完整路径，不能只写 ansible-lint
VSCode 不走系统 PATH 查找，只认绝对路径。填错或留空，后果就是 lint 彻底失能。
- 终端执行
which ansible-lint，复制输出（例如/Users/xxx/.local/bin/ansible-lint或/opt/homebrew/bin/ansible-lint） - VSCode 设置中搜索
ansible.lint.path，粘贴该完整路径 - 确认
ansible.lint.enabled已开启（不是ansible.linting.enabled，旧版设置项已废弃） - 如果用
pipx或虚拟环境安装，which ansible-lint的路径必须和 VSCode 当前 Python 解释器环境一致
ansible.path 错误会导致 lint 和右键运行双失败
插件依赖真实 ansible 命令做模块索引和参数校验。路径不对，copy:、debug: 这些模块名会直接从补全列表消失，lint 也拿不到模块定义。
- 终端执行
which ansible，复制完整路径（例如/Users/xxx/.pyenv/shims/ansible） - VSCode 设置中搜索
ansible.path，填入该路径（不要留空，不要填ansible） - 按
Cmd+Shift+P→Python: Select Interpreter，选和which ansible所在环境一致的 Python（比如都是 pyenv 的 3.11.9） - 若项目含
collections/或requirements.yml，必须把项目根目录设为 VSCode 工作区，否则ansible-lint读不到第三方 collection 元数据
第三方 collection（如 community.general）不提示？配 Schema 是硬需求
默认情况下，插件只加载 Ansible 核心模块。对 community.general、ansible.posix 等 collection，不配 Schema 就等于“看不见”。
- 在项目根目录创建
.vscode/settings.json - 加入：
"yaml.schemas": { "https://raw.githubusercontent.com/ansible-community/schemas/main/focus/ansible-stable-8.json": ["/*.yml", "/*.yaml"] } -
ansible-stable-8.json中的版本号需与你本地 Ansible 版本匹配（如用 Ansible 7.x，改用ansible-stable-7.json） - Schema URL 必须可访问（国内网络建议提前测试或换为本地缓存路径）
最容易被忽略的是语言模式切换和 ansible.path / ansible.lint.path 的路径一致性——它们不是可选项，是 lint 能否工作的开关。少一个，ansible-lint 就只是你电脑里一个安静的二进制文件。
