必须安装Composer插件（by Tobias Hopp）并配置Intelephense的includePaths为./vendor，执行composer dump-autoload -o生成类映射，且以含composer.json的目录为工作区根启动VS Code。

VS Code 装什么插件才能识别 composer.json 和依赖类？

只装 PHP Intelephense 或 PHP Tools 不够——它们默认不解析 composer.json 的自动加载规则，导致 new SomePackageClass() 依然标红。必须搭配能读取 Composer 配置的插件，或者手动补全索引路径。

• 推荐装 Composer（by Tobias Hopp）：轻量，专注解析 composer.json、生成 autoload_classmap.php 并通知语言服务器
• 如果已用 PHP Intelephense，必须开启 "intelephense.environment.includePaths"，把 vendor/autoload.php 所在目录加进去（不是文件本身）
• 别装“PHP IntelliSense”（deprecated），它不支持 Composer 2+ 的 PSR-4 动态映射

vendor/autoload.php 被提示“找不到”，但文件明明存在

常见于项目根目录没被 VS Code 当作工作区根，或 PHP 解释器路径没设对。Intelephense 不会主动扫描子目录找 vendor，它只认你明确告诉它的路径。

• 确保 VS Code 是以项目根目录（含 composer.json）打开的，不是上层文件夹
• 检查设置里 "intelephense.environment.phpVersion" 是否匹配你本地 PHP 版本（比如 "8.2"），版本不一致会导致 autoload.php 解析失败
• 运行过 composer install 吗？vendor/ 目录为空时，任何插件都无从索引

为什么 use 语句能提示，但 new 实例化没补全？

这是 PSR-4 映射未被正确加载的典型表现。Intelephense 默认只解析当前文件和 includePaths 下的代码，不会递归扫描 vendor/ 全量类（太慢），它依赖 composer dump-autoload -o 生成的优化类映射。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

• 执行 composer dump-autoload -o，生成 vendor/composer/autoload_classmap.php
• 在 VS Code 设置中添加："intelephense.environment.includePaths": ["./vendor"]（注意是 vendor 目录，不是 vendor/autoload.php）
• 重启 VS Code 窗口（不是重载窗口），否则 Intelephense 不会重新扫描 includePaths

PHP Intelephense 提示“Class not found”但运行正常

说明静态分析和运行时环境脱节。最常发生在使用了动态类名（class_exists($name)）、条件加载（if (extension_loaded())），或 Composer 的 files 自动加载项未被插件识别。

• 检查 composer.json 的 "autoload": {"files": [...]}，这些函数文件不会生成类映射，需手动加到 intelephense.stubs 或用 @var 注解临时绕过
• 确认没有在 vendor/ 外另建了同名命名空间——Intelephense 可能优先索引了错误路径
• 禁用其他 PHP 插件（如 PHP CS Fixer、PHP Debug），它们可能干扰语言服务器启动顺序

真正卡住的地方往往不是插件没装，而是 composer dump-autoload -o 没跑、工作区根选错、或者 includePaths 指向了文件而非目录——这三个点漏一个，智能提示就断在半路。