VSCode集成终端报“command not found”主因是未继承系统PATH，需验证$PATH是否含composer路径、切换稳定终端（如Command Prompt/Git Bash）或在shell配置中添加export PATH="$HOME/.composer/vendor/bin:$PATH"并重载。
VSCode 本身不运行 Composer，它只是调用你系统里装好的 composer —— 所以配置失败，90% 是路径没通，不是插件没装对。
终端里 composer 能用，但 VSCode 集成终端报 command not found
这是最常见卡点。VSCode 的集成终端（Ctrl+`）默认可能不继承你 shell 的 $PATH，尤其 Windows 上 PowerShell 经常找不到 composer。
- Windows 用户：在 VSCode 终端右下角点击当前 shell 名（比如
PowerShell），切换成Command Prompt或Git Bash；别信“自动选最佳”，手动切最稳 - macOS/Linux 用户：运行
echo $PATH确认~/.composer/vendor/bin或/usr/local/bin在其中；如果不在，把export PATH="$HOME/.composer/vendor/bin:$PATH"加进你的~/.zshrc或~/.bash_profile，然后source一下 - 别碰
terminal.integrated.shell.*这类旧配置项 —— VSCode 已弃用，新版只认terminal.integrated.defaultProfile.*
composer.json 写错导致 composer install 直接报语法错误
不是所有 JSON 错误都会提示“JSON 格式不对”，有些会崩在解析阶段，比如：
-
"require"必须是对象（{}），不能是数组（[]）或空值 - PSR-4 自动加载的路径必须真实存在，且用正斜杠
/，不能用反斜杠\（Windows 下也一样） - PHP 版本约束写法要规范：
"php": "^8.1"可以，"php": ">=8.1"也可以，但"php": "8.1"（没符号）会被当成精确版本，容易匹配失败 - 镜像源配错会触发奇怪报错，比如
Expected one of: 'STRING', 'NUMBER', 'NULL', 'TRUE', 'FALSE', '{', '['—— 先执行composer config -g repo.packagist https://mirrors.aliyun.com/composer/换阿里云镜像
Intelephense 提示类找不到，但 vendor/autoload.php 明明已生成
Intelephense 不读 composer.json 的 autoload 配置，它靠自己索引。即使 composer dump-autoload 成功了，Intelephense 也可能没刷新缓存。
立即学习“PHP免费学习笔记（深入）”；
- 右键命令面板（Ctrl+Shift+P），搜
Intelephense: Index workspace，强制重索引 - 检查项目根目录是否有
.intelephense.json，里面"includePaths"应包含"vendor/autoload.php"或"vendor/**" - 如果用了
autoload-dev里的测试类，Intelephense 默认不加载 dev 区域 —— 在设置里打开intelephense.environment.includePaths并加进去
Dev Container 里 composer 命令不存在
不是所有 PHP 官方镜像都预装 Composer。Dockerfile 里得显式安装，且注意路径。
- 推荐安装方式：
RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer - 别用
php composer.phar install这种写法 ——postCreateCommand里直接写composer install就行，前提是上面那步装到了/usr/local/bin -
devcontainer.json中的postCreateCommand是容器启动后执行，适合初始化依赖；但它不会监听composer.json变更，改了还得手动composer update
真正容易被忽略的是：VSCode 的终端和外部终端，PATH 可能是两套环境。哪怕你在 iTerm2 里 composer -V 正常，VSCode 里仍可能失效 —— 别跳过验证这一步。
