VS Code需手动安装扩展支持PHP：Intelephense提供核心智能提示与诊断，PHP Debug扩展需配合Xdebug/Opentelemetry调试器，格式化依赖php-cs-fixer等外部工具，并须正确配置php.validate.executablePath以确保语法校验生效。
VS Code 本身不内置 PHP 支持，必须手动安装扩展才能获得语法高亮、智能提示、调试、格式化等核心功能。装错或漏装关键扩展，会导致 Ctrl+Space 没提示、F5 无法调试、php -l 报错不显示等问题。
装对扩展：PHP Intelephense 是当前最实用的补全与诊断工具
官方 PHP 扩展（PHP Language Features）仅提供基础语法支持，实际开发中几乎没人单独用它。真正扛大梁的是 Intelephense —— 它基于本地索引，响应快、跳转准、支持 Laravel/WordPress 等框架的魔术方法识别。
安装步骤很简单：
- 打开 VS Code，点击左侧扩展图标（或按
Ctrl+Shift+X） - 搜索
Intelephense，认准作者是Ben Mewburn - 点击安装，重启窗口（
Cmd/Ctrl+Shift+P→ 输入Developer: Reload Window） - 首次打开
.php文件时，它会自动扫描项目并建立索引；若没反应，可手动触发Intelephense: Index workspace
注意：不要同时启用 PHP Intellisense（已停更）和 Intelephense，二者冲突会导致提示重复或失效。
立即学习“PHP免费学习笔记（深入）”；
调试必须配 Xdebug 或 OpenTelemetry，光装扩展没用
装了 PHP Debug 扩展（作者 Felix Becker）只是第一步，它只是 VS Code 和调试器之间的“翻译官”。真正执行断点、变量查看的是你本地安装的 xdebug 或 open-telemetry 扩展。
常见卡点：
-
phpinfo()页面里看不到xdebug模块 → 检查php.ini是否加载了正确的zend_extension路径（Windows 是php_xdebug.dll，macOS/Linux 是xdebug.so） - VS Code 显示 “Waiting for Xdebug” 却不中断 → 确保
xdebug.mode=debug且xdebug.start_with_request=yes（PHP 8.0+） - 断点灰色不可用 → 检查
.vscode/launch.json中的pathMappings是否把服务器路径映射到本地路径，例如"${workspaceFolder}": "/var/www/html"
格式化要靠 php-cs-fixer 或 phpcbf，不是靠扩展自带功能
Intelephense 和 PHP Debug 都不带格式化能力。想保存时自动修正缩进、空格、use 语句顺序，得额外配置命令行工具：
- 全局安装
php-cs-fixer：composer global require friendsofphp/php-cs-fixer
- 在 VS Code 设置中搜
php.suggest.basic，把它设为false（避免和 Intelephense 冲突） - 设置默认格式化工具：
"editor.defaultFormatter": "bmewburn.vscode-intelephense-client", "php.format.enable": false, "[php]": { "editor.formatOnSave": true, "editor.defaultFormatter": "junstyle.php-cs-fixer" } - 确保
php-cs-fixer可执行路径已加入系统PATH，或在设置里显式指定php-cs-fixer.executablePath
别忽略 php.validate.executablePath，否则报错不提示
VS Code 默认用 php 命令做语法校验（php -l），但如果你用的是 Homebrew 安装的 PHP、Docker、或多个 PHP 版本共存，VS Code 很可能调用错版本，导致“明明有语法错误却不标红”。
必须手动指定：
- 打开设置（
Cmd/Ctrl+,），搜php.validate.executablePath - 填入你实际使用的 PHP 可执行文件路径，例如：
/opt/homebrew/bin/php（macOS Homebrew）C:\php\php.exe（Windows 手动解压版）/usr/bin/php8.2（Ubuntu 多版本） - 改完后随便改一行 PHP 代码再保存，看右下角是否立刻弹出
Parse error提示
这个路径一旦填错，所有语法级报错都会静默丢失，而且没有任何提示告诉你哪里出了问题。
