VSCode中PHP功能失效主因是php.executablePath未正确配置或指向无Xdebug/错误php.ini的CLI实例；终端能运行php但VSCode报错因GUI未继承shell PATH；需按系统分别配置PATH与php.executablePath，并确保Intelephense路径包含vendor等目录、Xdebug配置匹配CLI实际加载的php.ini。
VSCode 里 PHP 功能全失效，90% 是因为 php.executablePath 没配对，或者配了但路径指向的是一个“不带 Xdebug、不读正确 php.ini”的 CLI 实例。
为什么终端能跑 php -v，VSCode 却报 “Command 'php' not found”
VSCode 图形界面启动时，根本没继承你 shell 的 PATH——尤其是 macOS（zsh）、Linux（systemd user session）和 Windows（非管理员启动）下极常见。它不会自动去 ~/.zshrc 或注册表里捞 PATH。
- Windows：检查是否把
C: mppphp或C:php加进了「系统变量」里的PATH，不是「用户变量」；改完必须彻底关闭 VSCode 进程（任务管理器里杀掉所有Code.exe）再重开 - macOS：Homebrew 安装的
php@8.2默认不软链到/usr/local/bin/php，运行brew link php@8.2后用which php确认输出，再填进设置 - Linux：源码编译的 PHP 往往只在当前用户的
$PATH，GUI 启动的 VSCode 看不见；直接填绝对路径更稳，比如/opt/php-8.2.12/bin/php - 路径含空格或中文？别加引号硬扛——重装到
C:php或/usr/local/php，否则intelephense启动直接失败
php.executablePath 配好了，但 Intelephense 仍标红 $this->xxx()
Intelephense 不是靠“运行时”理解代码，它只静态扫描你明确告诉它要看的路径。vendor、app、modules 这些目录漏一个，$this 就等于没类型信息。
PigX Server 后端开发
下载
PigX 企业级微服务平台后端开发指南 - Spring Cloud Alibaba + Java 17。当用户提到 PigX Server、PigX 后端、lhb-server 项目、Spring Cloud 微服务开发、PigX 微服务架构时使用此技能。
- 打开 VSCode 设置，搜
intelephense.environment.includePaths，填入项目中实际存放类/接口/traits 的路径，例如：["./app", "./vendor", "./modules"] - 如果用了 Composer autoload，确认
composer.json中"autoload"配置有效（比如"psr-4": {"App\": "app/"}），然后右键命令面板运行Intelephense: Index workspace - 别依赖
./自动推导——Intelephense 默认只扫根目录，子目录必须显式列出来
调试断点灰色、xdebug.mode=debug 写了也不生效
VSCode 调试器（php-debug）只是个中转，真正干活的是 CLI 模式下加载的 Xdebug。你改的 php.ini 可能压根没被 CLI 加载，或者版本参数写错。
立即学习“PHP免费学习笔记（深入）”；
- 在终端执行
php --ini，看Loaded Configuration File输出的路径——这就是 CLI 实际读的配置，不是 Apache 那份 - 执行
php -v，确认输出里有with Xdebug；没有就说明zend_extension路径错了，或扩展文件名不匹配（Windows 是php_xdebug.dll，Linux/macOS 是xdebug.so） - Xdebug 3+ 必须用
xdebug.mode=debug（不是on或1），且xdebug.client_port=9003；Xdebug 2 用xdebug.remote_enable=1和xdebug.remote_port=9000，混用会静默失败 -
launch.json里pathMappings必须存在，哪怕本地开发也要写，例如："${workspaceFolder}": "/var/www/html"——Xdebug 发送的是服务器路径，VSCode 必须能映射回来
最常被跳过的动作：改完 php.ini 或 settings.json 后，没关掉所有 .php 文件再重开，导致 Intelephense 缓存旧状态；或者没在集成终端里手动执行 php --ini 验证 CLI 实际加载路径，光信自己“肯定改对了”。
