VS Code仅识别本地PHP版本无法识别Docker内版本该如何修复？

前提：确保已安装VS Code常用PHP开发扩展PHP Intelephense或PHP IntelliSense

方法1：配置工作区PHP可执行路径（轻量方案） #

• 在Symfony项目根目录新建.vscode文件夹，内部创建settings.json文件
• 写入以下配置，将占位内容替换为你项目的实际Docker配置：

{
    // 使用docker命令调用容器内的PHP，二选一即可
    "php.executablePath": "docker exec -i 你的PHP容器名 php",
    // docker-compose部署的项目可使用该配置
    "php.executablePath": "docker-compose exec -T php服务名 php",
    // 匹配容器内的PHP版本号
    "intelephense.environment.phpVersion": "8.1.0",
    // 适配Symfony项目的目录结构
    "intelephense.environment.documentRoot": "${workspaceFolder}/public",
    "intelephense.environment.includePaths": [
        "${workspaceFolder}/vendor"
    ]
}

• 配置完成后重启VS Code重载扩展即可生效

方法2：使用Dev Containers扩展（稳定方案） #

• 安装VS Code官方Dev Containers扩展
• 打开项目后按下F1，选择Dev Containers: Add Dev Container Configuration Files
• 选择From 'docker-compose.yml'，选中项目对应的PHP服务作为开发容器
• 按照提示重新在容器中打开项目，VS Code会直接运行在Docker容器内部，自动识别容器内的PHP版本、扩展、项目依赖，完全和本地环境隔离

常见问题排查 #

• 配置php.executablePath后报错的话，先在本地终端手动执行你写的docker exec命令，确认可以正常返回PHP版本信息
• 需要调试PHP代码的话，同步在.vscode/launch.json中添加Xdebug路径映射：

{
    "name": "Listen for Xdebug",
    "type": "php",
    "request": "launch",
    "port": 9003,
    "pathMappings": {
        "容器内项目根目录绝对路径": "${workspaceFolder}"
    }
}

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