必须将.yml文件语言模式设为精确的“Ansible”，配置ansible.path为本地ansible绝对路径，启用ansible-lint并绑定匹配Python解释器，再配置对应Ansible版本的JSON Schema，否则模块补全、参数提示、Jinja2高亮均失效。
VSCode 默认不识别 Ansible 语法，copy:、template: 这些模块名不会出现在补全列表里，{{ item }} 不高亮，loop: 写成 loops: 也毫无提示——这不是插件没装好，而是关键配置漏了或配错了。
怎么让 copy: 按 Ctrl+Space 有参数提示
根本原因是 VSCode 把 .yml 当纯 YAML 处理，不是 Ansible。即使 redhat.vscode-ansible 插件已安装，语言模式没切对，所有智能功能都静默失效。
- 打开任意一个 playbook（如
site.yml） - 点击右下角语言标识（常见显示为 “YAML” 或 “Plain Text”）
- 选 Configure File Association for '.yml' → 输入
ansible回车 - 务必勾选 “将‘.yml’文件与此语言关联”（不要选 “YAML (Ansible)” 或其他变体）
- 确认顶部状态栏显示为
Ansible，不是别的文字
做完这一步，输入 copy: 后按 Ctrl+Space，src、dest、backup 等参数就会出来。
ansible.path 配错等于整个插件瘫痪
redhat.vscode-ansible 插件靠调用本地 ansible 命令来加载模块列表、校验参数、跳转文档。路径为空、填错、或指向错误 Python 环境，debug:、lineinfile: 就直接从补全里消失。
- 终端执行
which ansible，复制完整输出（例如/opt/homebrew/bin/ansible或/Users/xxx/.local/bin/ansible） - VSCode 设置中搜索
ansible.path，粘贴该路径（不能只写ansible） - 如果用
pipx、pyenv或虚拟环境装的 Ansible，必须指定该环境下的可执行文件，不能混用全局 Python - 项目含
collections/目录时，必须把项目根目录设为 VSCode 工作区，否则第三方 collection（如community.general）元数据读不到
为什么 community.general 模块不提示
VSCode 的 Ansible 插件默认不预加载非核心 collection，必须显式启用 JSON Schema 校验才能触发完整补全。光靠插件本身，community.general 的 mysql_query: 或 proxmox_kvm: 根本不会出现。
- 在项目根目录创建
.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 版本严格匹配（如用 7.x，就改用ansible-stable-7.json） - 确保 Red Hat YAML 插件已安装并启用（它负责解析这个 Schema）
Schema 文件必须能被网络访问；若内网环境，需提前下载到本地并用 file:/// 路径引用。
参数提示不出来？检查 ansible-lint 和 Python 解释器绑定
参数补全不仅靠语言服务，还依赖 ansible-lint 对 playbook 结构的静态分析，而这个过程由 VSCode 绑定的 Python 解释器执行。
- 终端运行
which ansible-lint，确认命令存在且可执行 - VSCode 设置中搜索
ansible.lint.path，填入上面的完整路径（不能只写ansible-lint） - 按
Cmd+Shift+P→Python: Select Interpreter，选和ansible、ansible-lint同一 Python 环境（比如都用python3.11） -
ansible.lint.enabled必须开启，保存后错误才出现在 Problems 面板
最容易忽略的是：所有路径配置（ansible.path、ansible.lint.path）都依赖当前 VSCode 窗口打开的是项目根目录——开错文件夹，配置就白设。
