VSCode中Ansible脚本无报错、无补全、Jinja2不高亮，根本原因是语言模式未设为精确“Ansible”、ansible.path和ansible.lint.path未配置为本地绝对路径；必须手动将.yml文件关联为Ansible模式，填入which ansible和which ansible-lint输出的完整路径，并重启VSCode窗口。
VSCode 里写 Ansible 脚本不报错、没补全、{{ item }} 不高亮，不是插件不行，是三个硬性配置没对齐：语言模式必须是精确的 Ansible，ansible.path 必须填完整路径，ansible.lint.path 同样不能只写命令名。
怎么让 .yml 文件真正被识别为 Ansible 模式
VSCode 默认把 site.yml 当纯 YAML 处理，copy: 不提示参数、loop: 写成 loops: 也毫无反应——这不是 bug，是语言服务根本没启动。
- 打开任意一个
.yml文件，点击右下角当前语言标识（比如显示 “YAML”） - 选 Configure File Association for '.yml'，输入
ansible并回车 - 务必勾选 “将“.yml”文件与此语言关联” —— 别选
YAML (Ansible)或其他变体 - 确认顶部状态栏显示的是
Ansible，不是YAML、Plain Text或任何带括号的名称
漏掉这一步，后续所有 lint、补全、Jinja2 高亮全部静默失效。
ansible.path 配错等于整个插件瘫痪
redhat.vscode-ansible 插件本身不解析模块，它靠调用你本地的 ansible 可执行文件来加载模块列表、校验参数、跳转文档。路径错或留空，debug:、lineinfile: 就直接从补全里消失。
- 终端执行
which ansible，复制完整输出（例如/opt/homebrew/bin/ansible或/Users/xxx/.local/bin/ansible） - VSCode 设置中搜索
ansible.path，粘贴该绝对路径（不能只写ansible） - 如果用
pipx、pyenv或虚拟环境装的 Ansible，路径必须指向那个环境下的ansible，比如~/.local/pipx/venvs/ansible/bin/ansible - 改完后必须重启 VSCode 窗口（不是重载），否则配置不加载
这个路径还必须和 VSCode 绑定的 Python 解释器一致：按 Cmd+Shift+P → Python: Select Interpreter，选同一个环境。
为什么 ansible-lint 完全不报错
ansible-lint 是唯一能在保存时发现 apt_key: 已弃用、become: 忘加、变量未定义等风险的工具，但它完全不内嵌，纯靠外部命令驱动。静默失效比报错更危险——Problems 面板空空如也，连误报都不会有。
- 终端执行
pip3 install ansible-lint（Ansible 8.x 推荐ansible-lint>=6.18） - 终端执行
which ansible-lint，复制完整路径（常见位置：/opt/homebrew/bin/ansible-lint或~/.local/bin/ansible-lint） - VSCode 设置中搜索
ansible.lint.path，粘贴该路径；同时确认ansible.lint.enabled已开启 - 若项目含
requirements.yml或collections/目录，必须把项目根目录设为 VSCode 工作区，否则ansible-lint读不到第三方 collection 元数据
最常被忽略的一点：所有路径配置（ansible.path、ansible.lint.path）都依赖当前 VSCode 窗口打开的是项目根目录，而不是单个文件。
第三方 collection 补全不全？得配 Schema
默认情况下，插件只加载核心模块。community.general 或 ansible.posix 里的模块名和参数不会出现在补全里，ansible-lint 也识别不了它们的参数结构。
- 在项目根目录创建
.vscode/settings.json - 加入配置：
"yaml.schemas": {"https://raw.githubusercontent.com/ansible-community/schemas/main/fo": ["*.yml", "*.yaml"]}（注意补全 URL，实际使用时需查最新 schema 地址） - 确保已安装
redhat.vscode-yaml扩展，否则 Schema 不生效
Schema 支持不是可选项——用了 community.docker 却没配，docker_container: 的参数提示就永远只有前两三个。
