如何使VS Code Ansible扩展识别自定义目录结构下的roles？

问题背景 #

项目固定目录结构如下：

my_project/
  roles/
  scenarios/
    <playbook yml's>

macOS系统下，VS Code的Ansible扩展对scenarios目录中的playbook可正常提供语法着色、悬停帮助，但roles目录下的文件无此支持。已在my_project的父目录添加ansible.cfg：

[defaults]
roles_path    = $HOME/path_to_project/my_project/roles

该配置已生效（ansible-lint可检查roles），但扩展的语法相关功能仍失效，且无法修改目录结构。

解决方案 #

• 将VS Code工作区根目录设为my_project
  打开VS Code时直接选择my_project文件夹作为工作区，而非其父目录。扩展的语言服务依赖工作区根路径解析资源，工作区根不正确会导致无法关联roles目录的文件。

• 手动指定Ansible配置文件路径
  打开VS Code设置（快捷键Cmd+,），搜索Ansible: Config File，设置为父目录下ansible.cfg的绝对路径（例如/Users/xxx/path_to_parent/ansible.cfg）。手动指定可确保扩展语言服务准确读取配置。

• 配置扩展的Roles Path
  在VS Code设置中搜索Ansible: Roles Path，添加${workspaceFolder}/roles路径。此配置让扩展直接从工作区的roles目录读取文件，与ansible.cfg的配置形成双重保障。

• 重启VS Code并重新加载工作区
  修改配置后重启VS Code，重新打开my_project工作区，验证roles目录下文件的语法着色、悬停帮助是否恢复正常。

• 检查版本兼容性
  确保使用最新版的Ansible扩展，同时本地Ansible版本与扩展兼容（可通过ansible --version查看本地版本，对比扩展的兼容说明）。旧版本可能存在功能适配问题。

内容的提问来源于stack exchange，提问作者Paul Bennett