vendor目录不能直接复用，因其是Composer在特定PHP版本、扩展、OS架构下生成的产物，含平台相关二进制、软链接及动态autoload映射；跨节点共享易致Class not found或undefined symbol错误。
为什么分布式编译中 vendor 目录不能直接复用
因为 vendor 是 Composer 在特定环境（PHP 版本、扩展、OS 架构）下生成的产物，不是纯代码快照。不同构建节点若共享同一份 vendor/，极易出现 Class not found 或 undefined symbol 错误——尤其是含 ext-redis、ext-gmp 等编译扩展的包。
常见错误包括：在 Jenkins agent A 上生成的 vendor/ 被 copy 到 agent B 运行，但 B 缺少 pdo_pgsql；或 Docker 构建时用 COPY . . 覆盖了前一步 composer install 生成的 vendor/，导致 autoload 映射与实际文件不一致。
- vendor/ 包含平台相关二进制、软链接、动态生成的
autoload_classmap.php - 不同节点的
COMPOSER_HOME、PHP_INI_SCAN_DIR可能不同，影响扩展加载顺序 - 即使 PHP 版本相同，
opcache.enable_cli=1等配置差异也会让dump-autoload --optimize输出不一致
如何安全复用 Composer 全局缓存（~/.composer/cache）
全局缓存是唯一可跨节点安全共享的部分，它只存下载下来的 dist 包和 Git 克隆副本，不依赖运行时环境。关键是要确保所有节点读写的是同一物理路径，且权限一致。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 用
COMPOSER_CACHE_DIR环境变量强制指定路径，优先级高于config --global cache-dir - 必须手动创建该目录并赋予构建用户
rwx权限（NFS 挂载需额外确认no_root_squash） - 单独配置
cache-vcs-dir：Git 仓库克隆副本体积大、重复成本高，不配会反复 clone 同一私有库 - 验证是否生效：执行一次
composer install后检查cache-dir下是否新增repo/github.com-xxx/和archived/子目录
vendor 目录必须按 lock 文件哈希隔离存储
每个 composer.lock 对应唯一依赖树，它的 SHA256 哈希值就是 vendor 的天然标识符。混用不同哈希的 vendor 会导致类加载错乱，哪怕只差一个补丁版本。
- Jenkins Pipeline 中避免
stash 'vendor'，改用sh 'cp -r vendor vendor-${sha256sum composer.lock | cut -c1-8}'隔离存放 - Docker 构建中坚持分层 COPY：
COPY composer.json composer.lock ./→RUN composer install --no-dev --prefer-dist→COPY . . - CI 脚本里加入校验：部署前运行
composer check-platform-reqs，失败则中断，不靠 vendor 缓存“蒙混过关” - 禁止在项目根目录提交 vendor/，也不要在
.dockerignore或.gitignore里漏掉它
边缘节点执行 composer install --optimize-autoloader 失效的真正原因
不是命令写错了，而是默认启用 --classmap-authoritative 时，Composer 只信任 classmap，完全忽略 PSR-4 自动映射。一旦你用了动态 require（如 Laravel service provider 中 require_once）、或某些包没预生成 classmap，就会漏类。
- 确认是否启用了该模式：检查
composer.json中是否有"classmap-authoritative": true，或是否传了--classmap-authoritative - 若必须用该模式，所有 PSR-4 类必须被
composer dump-autoload --optimize扫描到——检查autoload.psr-4是否包含子目录、是否被exclude-from-classmap排除 - 边缘节点若用 symlink 安装（
"preferred-install": "source"），需确保容器内开启follow_symlinks，否则 classmap 里路径对不上
composer install --ignore-platform-reqs 带来的隐患——它让安装看似成功，却把版本不兼容问题压到运行时爆发。 
