vscode 中 ansible 支持需同时满足语言模式设为 ansible、ansible.path 指向本地 ansible 可执行文件、启用 ansible-lint 并配置正确路径、项目根目录设为工作区、手动配置 yaml schema 支持 collection 补全。
copy: 按 Ctrl+Space 没反应？when: 写错缩进不报错？保存后 ansible-playbook 直接失败却找不到哪行语法错？——这些不是 VSCode “不支持 Ansible”，而是语言模式、路径、校验工具三者没对齐，缺一不可。
怎么让 .yml 文件真正变成 Ansible 模式
VSCode 默认把site.yml 当纯 YAML 处理，template: 不高亮、{{ item }} 不着色、loop: 参数不提示，全是“哑状态”。必须手动切到精确的 Ansible 语言模式：
打开任意一个 .yml 文件
点击右下角语言标识（比如显示 “YAML”）
选 Configure File Association for '.yml'
输入 ansible 并回车
务必勾选 “将‘.yml’ 文件与此语言关联”
确认顶部状态栏文字是 Ansible，不是 YAML (Ansible) 或 Plain Text
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 窗口（不是重载），否则配置不加载
为什么 ansible-lint 不报错？检查这三项硬性配置
ansible-lint 是唯一能在保存时发现 apt_key: 已弃用、become: 忘加、变量未定义等风险的工具。但它完全不内嵌，纯靠外部命令驱动：
终端执行 pip3 install ansible-lint（确保版本兼容：Ansible 8.x 推荐 ansible-lint>=6.18）
VSCode 设置中搜索 ansible.lint.enabled，确保已启用
搜索 ansible.lint.path，填入 which ansible-lint 的完整路径（例如 /opt/homebrew/bin/ansible-lint）
项目含 requirements.yml 或 collections/ 目录时，必须把项目根目录设为 VSCode 工作区（不能只打开单个文件），否则 community.general 等第三方模块元数据读不到
补全还是不全？Schema 支持必须手动开
默认情况下，redhat.vscode-ansible 只加载核心模块，community.docker.docker_container: 这类 collection 模块不会出现在补全列表里。必须显式启用 JSON Schema 校验：
在项目根目录创建 .vscode/settings.json
加入配置：
"yaml.schemas": {
"https://raw.githubusercontent.com/ansible-community/schemas/main/focus/ansible-stable-8.json": ["/*.yml", "/*.yaml"]
}
URL 中的
ansible-stable-8.json 要按你本地 ansible --version 输出的主版本号调整（如 7.x 改为 ansible-stable-7.json）这个 URL 必须能被 VSCode 访问（离线环境需提前下载并用本地路径替换） 所有配置都依赖当前 VSCode 窗口打开的是**项目根目录**——不是某个子文件夹，也不是单个 playbook。路径、lint、schema、collection 解析，全靠这个上下文。漏掉这一步，前面配得再细也白搭。
