必须将.yml文件语言模式精确设为ansible、配置ansible.path和ansible.lint.path完整路径、绑定匹配的python解释器、启用schema支持，否则lint静默失效、模块无补全、jinja2不高亮。
不装 redhat.vscode-ansible 扩展，或没把 .yml 文件语言模式切到精确的 Ansible，ansible-lint 就根本不会触发——不是报错，是彻底静默。
必须手动把 .yml 文件绑定为 Ansible 语言模式
VSCode 默认把 playbook.yml 当纯 YAML 处理，{{ item }} 不高亮、copy: 不提示参数、loop: 写成 loops: 也毫无反应。插件只响应严格匹配的 Ansible 模式，不是 YAML，也不是 YAML (Ansible)。
- 打开任意一个
.yml文件 - 点击右下角语言标识（比如显示 “YAML”）
- 选
Configure File Association for '.yml' - 输入
ansible并回车 - 务必勾选 “将“.yml”文件与此语言关联”
完成后顶部状态栏必须显示 Ansible。否则后续所有 lint、补全、Jinja2 支持全部失效。
ansible.lint.path 必须填完整路径，不能只写 ansible-lint
redhat.vscode-ansible 插件本身不带 ansible-lint，它只是调用你本地命令行工具。常见失效场景：用 pipx 安装的，路径是 /Users/xxx/.local/bin/ansible-lint，但设置里只填了 ansible-lint；或者 pip3 install ansible-lint 装在虚拟环境里，VSCode 没走那个环境。
- 终端执行
which ansible-lint，复制完整输出路径 - VSCode 设置中搜索
ansible.lint.path，粘贴该路径 - 同时确认
ansible.lint.enabled已开启 - 如果仍无提示，重启 VSCode 窗口（不是重载）
只填 ansible-lint 且未加入系统 PATH，lint 功能会静默失效——Problems 面板空空如也，连误报都不会有。
ansible.path 错误会导致 lint 和右键运行双失败
插件依赖真实 ansible 命令做模块索引和语法解析。如果你用 pyenv 或 pipx 安装 Ansible，which ansible 返回的路径大概率不是 /usr/bin/ansible。设错或留空，后果包括：
- 保存时 lint 不触发
- 右键
Run Playbook报command not found -
debug:、lineinfile:等模块名直接从补全列表消失
必须在设置中搜索 ansible.path，填入 which ansible 的完整输出。这个路径还必须和 VSCode 绑定的 Python 解释器一致——按 Cmd+Shift+P → Python: Select Interpreter，选同一个环境。
第三方 collection（如 community.general）提示不全？要配 Schema
默认情况下，插件只加载核心模块，community.general 或 ansible.posix 里的模块名和参数不会出现在补全里，ansible-lint 也识别不了它们的参数结构。
- 在项目根目录创建
.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 版本对应的 schema（如 7.x 就用ansible-stable-7.json）
这一步漏掉，community.general 的 mysql_user: 或 ansible.posix 的 mount: 就始终是“未知模块”，补全、校验、跳转文档全不可用。
