PHP开发者用VSCode高效开发的关键是装对5个必备插件（Intelephense、PHP Debug、DocBlocker、CS Fixer、Composer Extension）并正确配置Xdebug 3（启用xdebug.mode=debug、设client_host/port、start_with_request=trigger）及launch.json路径映射。
PHP开发者用VSCode高效开发，关键在两件事：装对插件、配好Xdebug。不折腾环境，调试才不卡壳。
必装的5个PHP相关插件
这些插件不是“可选”，而是日常
编码
绕不开的基础支持：
PHP Intelephense
：智能补全、跳转、错误提示最稳的PHP语言服务器，替代已停更的PHP Tools
PHP Debug
（by Felix Becker）：Xdebug官方推荐的调试器
前端
，没它VSCode就无法和Xdebug通信
PHP DocBlocker
：敲
回车自动生成规范注释，省去手写@param/@return的时间
PHP CS Fixer
：对接本地
php
-cs-fixer，保存时自动格式化代码，团队风格统一不靠嘴说
Composer Extension
：快速执行
、更新依赖、打开包源码，不用切终端
Xdebug 3 配置要点（以本地Laravel项目为例）
Xdebug 3 和旧版差别大，端口、触发方式、配置项都变了，配错就“断点不命中断不下来”：
确认php.ini中启用
（不是
）
设
（Docker环境需填宿主机IP，如
）
用
（Xdebug 3默认端口，不是9000；VSCode的
里也要同步改）
加
，避免全站开启拖慢响应；调试时在URL加
或用
浏览器
插件（如Xdebug Helper）一键开启
VSCode调试启动配置（launch.
js
on）
项目根目录下
贴这个基础配置，改完记得重启VSCode：
立即学习
“
PHP免费学习笔记（深入）
”；
Docker Sandbox
创建并管理 Docker 沙箱虚拟机环境以安全执行代理。适用于运行不受信任代码、探索包或隔离代理工作负载。支持 Claude、Codex、Copilot、Gemini 和 Kiro 代理，并提供网络代理控制。
下载
说明：
是关键——左边是容器或远程服务器上的绝对路径，右边是本地项目路径，映射错就找不到文件，断点变空心圆。
调试时容易忽略的3个细节
断点不生效？先看这几个地方：
浏览器是否已开启Xdebug会话（地址栏有
参数，或Xdebug Helper图标亮起）
终端运行
确认输出含
，且
显示加载的是你修改的php.ini
VSCode右下角状态栏检查PHP Debug扩展是否激活，小虫子图标是否显示“listening on port 9003”
基本上就这些。环境配一次，后面写代码、查逻辑、修Bug都顺手得多。
/**composer requirexdebug.mode = debugxdebug.remote_enable=1xdebug.client_host = localhost172.17.0.1xdebug.client_port = 9003launch.jsonxdebug.start_with_request = trigger?XDEBUG_SESSION_START=1.vscode/launch.json{
"version": "0.2.0",
"configurations": [
{
"name": "Listen for Xdebug",
"type": "php",
"request": "launch",
"port": 9003,
"pathMappings": {
"/var/www/html": "${workspaceFolder}"
},
"log": true
}
]
}pathMappingsXDEBUG_SESSION_STARTphp -vwith Xdebug v3.x.xphp --ini