必须安装 redhat.vscode-ansible 扩展并重启 VSCode，手动将 .yml 文件关联为 Ansible 模式，且正确配置 ansible.path 和 ansible.lint.path 为本地实际路径，否则语法高亮、补全、lint 和运行均失效。
安装 redhat.vscode-ansible 扩展是前提
没装这个扩展，VSCode 根本不认 copy、template 这些模块名，也不会高亮 loop 或 when 这类关键字。它不是“锦上添花”，而是让 Ansible 语法在编辑器里“活过来”的基础。官方插件由 Red Hat 维护，ID 是 vscoss.vscode-ansible（注意不是其他同名但发布者不同的版本）。装完必须重启 VSCode，否则语言服务不会启动。
手动绑定 .yml 文件到 Ansible 语言模式
VSCode 默认把 playbook.yml 当作纯 YAML 处理，结果就是：Jinja2 变量 {{ item }} 不高亮、模块参数无提示、缩进规则错乱。必须手动干预：
- 打开任意一个
.yml文件 - 点击右下角当前语言标识（比如显示 “YAML”）
- 选 Configure File Association for '.yml'
- 输入
ansible并回车确认 - 勾选“将“.yml”文件与此语言关联”
这一步漏掉，后续所有 lint 和补全都形同虚设。
ansible-lint 必须独立安装并显式配置路径
VSCode 插件本身不带 ansible-lint，它只是个“指挥官”，真正干活的是你本地装的命令行工具。常见错误包括：
-
pip3 install ansible-lint装在虚拟环境里，但 VSCode 没走那个环境 → 报错Command "ansible-lint" not found - 设置里只填了
ansible-lint，但没加进系统 PATH → lint 功能静默失效 - 用
pipx安装的，路径是/Users/xxx/.local/bin/ansible-lint，却没在 VSCode 设置中指定ansible.lint.path
正确做法：终端执行 which ansible-lint，把输出路径完整粘贴到设置项 ansible.lint.path 中，并确保 ansible.lint.enabled 已开启。
ansible.path 配置错误会导致 lint 和运行双失败
插件依赖 ansible 命令本身做语法解析和模块索引。如果你用 pyenv 管 Python 版本，或用 pipx 装 Ansible，which ansible 返回的路径大概率不是 /usr/bin/ansible。VSCode 设置里若还留着默认值，就会出现：
- 保存时 lint 不触发
- 右键 Run Playbook 报错
command not found - 模块参数补全列表为空
务必在设置中搜索 ansible.path，填入真实路径；如果不确定，就在终端跑一遍 which ansible 再复制。
最常被忽略的一点：所有路径配置（ansible.path、ansible.lint.path）都依赖当前 VSCode 窗口打开的是项目根目录。如果只是打开单个 playbook.yml 文件而非整个文件夹，这些设置可能压根不生效。
