需安装 redhat.vscode-ansible 扩展、关联 .yml 文件为 Ansible 模式、配置 ansible-lint 路径、设置 ansible.path、创建 tasks.json 任务，方可解决 VSCode 中 Ansible 语法高亮失效、YAML 校验异常及执行无响应问题。
如果您在使用 VSCode 编辑 Ansible 项目时遇到语法高亮失效、YAML 校验异常或任务执行无响应等问题，则可能是由于扩展配置缺失或语言模式未正确识别。以下是解决此问题的步骤：
本文运行环境：MacBook Pro，macOS Sequoia。
一、安装核心扩展
VSCode 本身不原生支持 Ansible 语法和运行逻辑，需通过扩展补全语言服务、智能提示与调试能力。
1、打开 VSCode，点击左侧活动栏的扩展图标（或按 Cmd+Shift+X）。
2、在搜索框中输入 Ansible，找到由 redhat.vscode-ansible 发布的官方扩展。
3、点击“安装”，安装完成后重启 VSCode。
二、配置 YAML 语言关联
Ansible 的 playbooks 和变量文件均为 YAML 格式，但 VSCode 默认不将 .yml 或 .yaml 文件自动关联为 Ansible 模式，需手动指定语言模式以启用 Ansible 特定功能。
1、打开任意一个 playbook 文件（如 site.yml）。
2、点击右下角当前语言标识（例如 “YAML”），弹出语言选择菜单。
3、选择 Configure File Association for '.yml'。
4、在输入框中键入 ansible 并回车确认。
三、启用 Ansible 语法检查
通过集成外部 ansible-lint 工具，可在编辑时实时检测语法错误、安全风险及最佳实践偏离。
1、在终端中执行 pip3 install ansible-lint 安装校验工具。
2、进入 VSCode 设置（Cmd+,），搜索 ansible.linting.enabled，勾选启用。
3、搜索 ansible.linting.executablePath，将其值设为 ansible-lint（确保已加入系统 PATH）。
四、配置本地 Ansible 可执行路径
VSCode 需明确知道 ansible 命令所在位置，才能触发 playbook 运行、语法解析与模块索引。
1、终端中执行 which ansible 获取完整路径（如 /opt/homebrew/bin/ansible）。
2、VSCode 设置中搜索 ansible.path，将该路径粘贴至输入框。
3、重启 VSCode 窗口使配置生效。
五、启用任务运行器集成
无需离开编辑器即可直接运行 playbook，依赖 VSCode 内置任务系统与 Ansible 命令绑定。
1、在项目根目录创建 .vscode/tasks.json 文件。
2、填入以下内容：
{
"version": "2.0.0",
"tasks": [
{
"label": "Run Playbook",
"type": "shell",
"command": "${config:ansible.path} -i ./inventory ./site.yml",
"group": "build",
"presentation": {
"echo": true,
"reveal": "always",
"focus": false
}
}
]
}
3、保存后按 Cmd+Shift+P，输入 Tasks: Run Task，选择 Run Playbook 即可执行。
