VS Code 不提示类名或方法是因为未正确配置 PHP Intelephense 的 vendor 索引和 PHP 版本：需安装扩展、执行 composer install、设置 "intelephense.environment.includePaths": ["./vendor"] 和匹配的 "intelephense.environment.phpVersion"，并排除无关目录以加速索引。
为什么 composer.json 里写完依赖，VS Code 不提示类名或方法？
因为 VS Code 默认不解析 composer.json 的依赖关系，也不会自动加载 vendor 中的类定义。它需要明确知道哪些 PHP 文件参与类型推导——而 Composer 安装的包默认不在工作区索引范围内，尤其当项目没启用 PHP Intelephense 或 PHPStan 类型支持时，use 语句补全、跳转定义、参数提示都会失效。
实操建议：
- 确认已安装并启用
PHP Intelephense扩展（官方推荐，非 PHP Tools） - 确保项目根目录下存在
composer.json且已执行过composer install（生成vendor/autoload.php） - 关闭 VS Code，删除项目下的
.vscode/目录（避免旧缓存干扰），再重新打开工作区 - 在设置中搜索
intelephense.environment.includePaths，添加./vendor（注意是相对路径，且必须带./）
intelephense.environment.includePaths 配置写错会怎样？
写成 vendor（缺 ./）、./vendor/（末尾斜杠）、或绝对路径，都可能导致 Intelephense 忽略该路径——表现为：类名补全有，但跳转失败；new SomeClass() 提示“未定义类”；vendor/bin/ 下命令无法被识别为可执行入口。
正确做法：
- 在工作区设置（
.vscode/settings.json）中配置："intelephense.environment.includePaths": ["./vendor"]
- 不要加通配符，如
./vendor/**—— Intelephense 不支持 glob 匹配 includePaths - 如果项目用 symlink 连接 vendor（如 Docker 场景），需确保 VS Code 启动时能访问到真实路径，否则索引会跳过
PHP 版本不匹配导致提示中断怎么办？
Intelephense 会根据 intelephense.environment.phpVersion 解析语法和内置函数。若设为 "8.1"，但项目实际运行在 8.2，某些新特性（如 random_bytes 返回类型变化）可能被误标为错误；反之，设太高则老项目里 mysql_connect 等弃用函数不报错，掩盖兼容性风险。
建议：
- 查看
composer.json的config.platform.php或require.php，取最小支持版本作为配置值 - 在
.vscode/settings.json中显式声明："intelephense.environment.phpVersion": "8.1"
- 避免全局设置 PHP 版本，不同项目应使用工作区级配置，防止跨项目污染
vendor 里大量包导致索引慢甚至卡死？
Intelephense 默认索引 vendor/ 全量内容，但像 symfony/symfony 或 laravel/framework 这类大包含数千个文件，首次扫描可能耗时 2–5 分钟，期间 CPU 占用高、编辑卡顿，甚至触发 VS Code 的“Extension host terminated”警告。
缓解方式：
- 用
intelephense.files.exclude排除文档和测试目录："intelephense.files.exclude": ["**/Tests/**", "**/docs/**", "**/examples/**"]
- 不推荐完全禁用 vendor 索引（那样就失去第三方类提示），而是聚焦于你真正在用的包，比如只 include
./vendor/myorg/和./vendor/laravel/framework - 如果项目用 Monorepo 结构（多个 composer.json），确保每个子目录都单独配置
intelephense.environment.includePaths，别指望根目录设置自动继承
最常被忽略的是：Intelephense 的索引状态不会在 UI 显式显示进度，你以为它“没反应”，其实可能还在后台扫 vendor/phpunit/phpunit/src/。等它完成一次完整索引后，后续编辑体验才会稳定下来。
