Composer自定义vendor目录需在composer.json中配置"config":{"vendor-dir":"path"}，安装前须手动创建目标目录并确保读写权限，改后需删除旧vendor和composer.lock再执行composer install，并同步更新所有require语句及部署脚本中的autoload路径。
composer.json 里 config 的 vendor-dir 路径写错导致安装失败
Composer 不会自动创建自定义 vendor-dir 目录，如果路径不存在或权限不足，composer install 或 composer update 会直接报错，典型错误是：Could not create directory "/path/to/vendor" 或 Permission denied。
解决方法很简单但容易被忽略：
- 先手动创建目标目录：
mkdir -p /your/custom/vendor（Linux/macOS）或mkdir /your/custom/vendor（Windows） - 确保当前用户对该路径有读写权限（尤其在 Docker 或 CI 环境中，宿主机与容器 UID 不一致时常见）
- 路径必须是相对项目根目录的相对路径，或绝对路径；但不建议用
../跨出项目根目录，否则某些插件（如composer-plugin-api）可能拒绝加载 - 改完
composer.json后，不要直接运行composer update—— 先删掉现有vendor和composer.lock，再执行composer install，避免残留缓存干扰
使用 COMPOSER_VENDOR_DIR 环境变量覆盖配置时没生效
环境变量优先级高于 composer.json 中的 config.vendor-dir，但只对当前命令生效，且不能带引号、不能含空格、不能用波浪线 ~ 表示家目录。
常见失效场景：
-
export COMPOSER_VENDOR_DIR="/home/user/my-vendor"→ 正确 -
export COMPOSER_VENDOR_DIR="/home/user/my vendor"→ 错误，空格会导致解析中断 -
export COMPOSER_VENDOR_DIR="~/my-vendor"→ 错误，~不会被展开，得写成完整路径 - 在
docker run中漏传：要用-e COMPOSER_VENDOR_DIR=...显式传递，否则容器内看不到该变量
全局配置 composer config --global 和项目配置冲突
全局设置（如 composer config --global vendor-dir /usr/local/composer/vendor）会影响所有项目，但项目级 composer.json 中的 config.vendor-dir 会覆盖它。问题常出在「以为改了全局就一劳永逸」，结果某个项目自己写了 vendor-dir，却忘了删或注释掉。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
排查步骤：
- 运行
composer config vendor-dir（不加--global），看输出是否符合预期 - 运行
composer config --list --global | grep vendor-dir查全局值 - 检查项目根目录下是否存在
composer.json中的config段，确认没有意外覆盖 - 注意：某些 IDE（如 PHPStorm）会缓存 Composer 配置，改完后需重启或刷新 Composer 面板
自定义路径后 autoload 失效或类找不到
Composer 自动加载器（vendor/autoload.php）的路径是硬编码生成的，一旦 vendor-dir 改变，必须重新生成 autoloader，否则 require 'vendor/autoload.php' 会失败或加载旧映射。
关键动作只有一步：
- 执行
composer dump-autoload（或composer install，它会自动触发） - 检查生成的
vendor/autoload.php文件顶部，确认$vendorDir变量指向的是你设定的新路径 - 如果用了
classmap或psr-4映射，还要确认composer.json中的autoload配置未依赖默认vendor/结构（例如写死"vendor/mylib/src"这种路径是危险的）
最易被忽略的是：改路径后没清空旧 vendor 目录，导致部分文件残留、autoloader 混合新旧逻辑；或者在多环境部署时，只改了开发机配置，CI 流水线仍用默认路径跑 install，结果线上运行时报 Class not found。
