VS Code Remote-SSH终端中composer命令找不到，因非登录shell未加载~/.zshrc，需将Composer路径（如~/.local/bin）加入PATH并source配置；若composer install卡在仓库加载，则需安装ca-certificates并配置cafile路径。
远程服务器上找不到 composer 命令
VS Code Remote-SSH 终端默认不加载 ~/.bashrc 或 ~/.zshrc，所以即使你在 SSH 里能敲出 composer，在 VS Code 里大概率报 command not found。
先运行 which composer 确认是否真没装——返回空就说明 PATH 没包含 Composer 路径。常见情况有两种：
- 用
curl -sS https://getcomposer.org/installer | php装的，生成的是composer.phar，得手动加软链或 alias - 用
sudo apt install composer装的，二进制在/usr/bin/composer，但 shell 没读到这个路径
临时解决：运行 export PATH="$HOME/.local/bin:$PATH"（如果 Composer 放在 ~/.local/bin/composer）；永久解决：在 ~/.zshrc 末尾加这行，然后重连 Remote-SSH 或执行 source ~/.zshrc。
composer install 卡在 “Loading composer repositories…”
这不是网络慢，是 PHP 的 OpenSSL 扩展压根没读对系统 CA 证书路径，尤其在最小化安装的服务器上很常见。
先确认 CA 包是否装全：sudo apt update && sudo apt install -y ca-certificates；如果还卡，别硬等，分两步排查：
- 运行
php -m | grep openssl看扩展是否启用 - 检查证书路径是否被识别：
php -r "print_r(openssl_get_cert_locations());"，看default_cert_file是否指向/etc/ssl/certs/ca-certificates.crt
稳妥做法是强制指定：composer config -g cafile /etc/ssl/certs/ca-certificates.crt。临时绕过（仅调试）：composer config -g secure-http false，但千万别提交进团队配置。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
本地改了 composer.json，远程怎么确保 vendor/ 一致
VS Code Remote-SSH 会自动同步文件，但同步完直接 composer install 很可能失败——因为远程已有 vendor/ 和旧的 composer.lock，版本约束冲突时 Composer 会拒绝覆盖。
正确顺序是：
- 保存本地
composer.json后，等 VS Code 右下角提示“同步完成” - 登录远程终端，先跑
composer update --lock更新锁文件（只改composer.lock，不动vendor/） - 再跑
composer install，这时它才按新锁文件重建依赖
如果项目已上线、不允许 update --lock，那就删掉远程 composer.lock，再 composer install —— 但必须确保本地 composer.lock 已 commit 并推送到 Git，否则下次部署又不一致。
多台服务器 PHP 版本不一致，composer install 报平台需求错误
比如开发机是 PHP 8.2，而某台测试服务器还是 8.1，composer install 会直接中断并报 Your requirements could not be resolved...，这不是依赖冲突，是 Composer 在预检阶段就卡住了。
关键不是升级 PHP，而是让 Composer 跳过这次检查：
- 加
--ignore-platform-reqs：适合离线或版本差异明确的环境，但要自己确保扩展（如ext-pdo）确实存在 - 更安全的做法是用指定 PHP 版本运行：
/usr/bin/php8.1 /usr/local/bin/composer install，前提是目标服务器装了对应版本且路径正确 - 查路径别靠猜：
find /usr -name 'php8.1' 2>/dev/null或ls -la /usr/bin/php*
别用 php -v 查完就以为万事大吉——那个输出只是默认软链指向的版本，composer 实际调用的可能是另一个。
