应直接使用系统级PHP 8.2而非XAMPP，macOS用brew安装、Windows从官网下载ZIP、Linux用apt安装CLI及mbstring/xml/zip扩展；Intelephense需手动配置phpVersion为"8.2"、指定executable.path和includePaths，并索引工作区或清缓存以支持PHP 8新语法。
PHP 8 运行环境：别装 XAMPP，直接用系统级 PHP
VSCode 本身不运行 PHP，它只调用你本地的 php 可执行文件。Intelephense 的语法分析也依赖你实际使用的 PHP 版本（尤其是 PHP 8 的联合类型、属性、构造器属性提升等特性）。装 XAMPP 或 WAMP 容易导致 VSCode 找不到或误用旧版 php。
- macOS：用
brew install php@8.2（推荐），然后确保which php输出的是/opt/homebrew/bin/php这类路径，不是/usr/bin/php - Windows：从 windows.php.net 下载线程安全（TS）、VC17 编译的 ZIP 包，解压后把
php.exe所在目录加进系统PATH；验证命令行输入php -v显示PHP 8.2.x - Linux（Ubuntu/Debian）：用
sudo apt install php8.2-cli php8.2-mbstring php8.2-xml php8.2-zip，别只装php-cli，Intelephense 需要mbstring和xml扩展解析代码
Intelephense 配置：关掉“自动索引”，手动指定 PHP 路径
默认开启 intelephense.environment.includePaths 自动扫描会卡死大项目，且容易误读 vendor 中的旧代码；更关键的是，如果 VSCode 没识别到你的 PHP 8，它会降级用 PHP 7 规则校验语法，导致 string|int 被标红、#[Attribute] 报错。
- 打开 VSCode 设置（
Cmd+,或Ctrl+,），搜intelephense.environment.phpVersion，设为"8.2"（必须是字符串，不是数字） - 搜
intelephense.environment.includePaths，清空默认值，改为显式列出你的项目依赖路径，例如：["./vendor/composer", "./vendor/myorg"] - 搜
intelephense.executable.path，填你系统中真实的php路径，比如/opt/homebrew/bin/php或C:\php\php.exe—— 这步决定它用哪个 PHP 解析器做语义分析
常见红标陷阱：PHP 8 新语法被标错，其实是 Intelephense 缓存没刷新
改了 phpVersion 或 executable.path 后，Intelephense 不会自动重载配置，老缓存还在报 PHP 7 的错。典型现象：明明写了 function foo(): string|null，却提示 “Expected type ‘string’, got ‘null’”。
- 按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Win/Linux），输入并执行Intelephense: Index workspace - 如果仍不生效，先执行
Intelephense: Clear cache and restart，再重新索引 - 检查状态栏右下角是否显示
PHP 8.2—— 如果显示PHP 7.4或空白，说明intelephense.environment.phpVersion没生效或被工作区设置覆盖
vscode-php-debug 调试：PHP 8 的 var_dump 改变了，默认不输出类型
PHP 8 默认 var_dump 加了类型前缀（如 string(5) "hello"），但旧版 Xdebug 配置可能强制关闭了这个行为，导致调试时变量结构看不清。这不是 Intelephense 的问题，但和开发体验强相关。
立即学习“PHP免费学习笔记（深入）”；
- 确认
php.ini中有xdebug.mode=debug（PHP 8.1+ 推荐写法），而不是过时的xdebug.remote_enable=1 - 在
launch.json的configurations里加："xdebugSettings": { "max_children": 100, "show_hidden": 1, "max_depth": 5, "max_data": 1024 } - 如果
var_dump输出还是没类型，检查php -i | grep "xdebug.mode"是否真生效；Xdebug 3.1+ 才完整支持 PHP 8.1+ 的类型推导
PHP 8 的类型系统越用越深，Intelephense 的准确度高度依赖你给它的 PHP 版本和扩展信息是否真实。配错一个路径、漏装一个扩展、缓存没清干净，都可能让 #[Override] 或 new class(...) 这类语法持续报错——不是插件不行，是你没把它喂对。
