remote-ssh下composer命令不生效是因非登录shell未加载~/.bashrc等配置导致path缺失，需手动export path或永久配置；ssl卡住需检查openssl证书路径并安装ca-certificates；同步composer.json后应先update --lock再install；dump-autoload后需确认autoload.php更新并重启php-fpm。
Remote-SSH 下 composer 命令不生效？先确认执行环境
VS Code Remote-SSH 默认不会自动加载你的 shell 配置（比如 ~/.bashrc 或 ~/.zshrc），所以即使你在远程服务器上能正常运行 composer，在 VS Code 终端里可能提示 command not found。
原因很简单：VS Code 的 Remote-SSH 终端启动的是非登录、非交互式 shell，跳过了大部分初始化逻辑。
- 检查
which composer—— 如果返回空，说明 PATH 没包含 Composer 安装路径（常见于用curl -sS https://getcomposer.org/installer | php装在~/composer.phar但没加 alias 或软链） - 临时修复：运行
export PATH="$HOME/.local/bin:$PATH"（如果 Composer 是用sudo apt install composer装的，它通常在/usr/bin/composer；如果是本地安装，建议用mv composer.phar ~/.local/bin/composer && chmod +x ~/.local/bin/composer） - 永久解决：在
~/.bashrc或~/.zshrc末尾加一行export PATH="$HOME/.local/bin:$PATH"，然后重启 Remote-SSH 连接（或重开终端并执行source ~/.zshrc）
VS Code 集成终端里 composer install 卡住或报错 SSL？别硬等
远程执行 composer install 时卡在 “Loading composer repositories with package information…” 是高频问题，本质是 PHP 的 OpenSSL 扩展没正确读取系统 CA 证书，或远程机器压根没装 CA 包。
- 先验证：运行
php -r "print_r(openssl_get_cert_locations());"，看default_cert_file是否指向一个真实存在的 PEM 文件（如/etc/ssl/certs/ca-certificates.crt） - 常见缺失：Ubuntu/Debian 系统需确保装了
ca-certificates包（sudo apt update && sudo apt install -y ca-certificates） - 若仍失败，可临时绕过（仅调试用）：
composer config -g secure-http false，但别提交到团队配置中 - 更稳妥的做法：在远程机器上运行
composer config -g cafile /etc/ssl/certs/ca-certificates.crt，强制指定证书路径
composer.json 本地改了，远程怎么同步再 install？别手动 scp
你改完本地 composer.json，想让远程立刻生效，最直接的方式不是上传文件再敲命令，而是利用 VS Code 的文件同步机制和终端联动。
- 保存本地
composer.json后，VS Code Remote-SSH 会自动同步到远程对应路径（前提是没关掉文件监视） - 但注意：如果远程已有
vendor/，直接composer install可能因锁版本不一致失败 —— 此时应优先跑composer update --lock更新composer.lock，再composer install - 避免冲突：团队协作中，
composer.lock必须提交 Git，且所有成员（包括 CI 和远程部署机）都应使用composer install而非composer update - 小技巧：在 VS Code 设置里开启
"remote.autoForwardPorts": true，方便后续调试依赖服务（比如本地访问远程 Laravel 的 Telescope）
远程 composer dump-autoload 不生效？检查 autoloader 生成位置
你在远程执行了 composer dump-autoload，但新写的类还是报 Class not found，大概率是 autoloader 没生成到 PHP 实际加载的位置，或者 Web 服务器（如 Nginx + PHP-FPM）没重启。
- 确认生成路径：默认会在项目根目录下生成
vendor/autoload.php，检查该文件修改时间是否更新（ls -l vendor/autoload.php） - 检查 PHP 加载的是否是这个文件：在远程 PHP 脚本里加
echo require_once 'vendor/autoload.php';并访问，看是否报错路径不存在 - Web 场景特别注意：PHP-FPM 进程可能缓存了旧的 autoloader，尤其是 opcache 开启时 —— 执行
sudo systemctl reload php*-fpm（版本号替换成实际值，如php8.1-fpm） - 开发中可加
--optimize参数提速：composer dump-autoload --optimize，但上线前务必测试兼容性（某些动态类名逻辑会出问题）
远程管理 Composer 最容易被忽略的一点：你认为“执行成功”了，其实只是终端回显 OK，而 PHP 进程、opcache、甚至 IDE 的符号索引都还卡在旧状态。每次改完依赖，多看一眼 vendor/autoload.php 时间戳，比反复清缓存更省时间。
