必须同步更新所有入口文件中require的路径、composer.json的bin-dir配置，并彻底删除旧vendor和composer.lock后执行composer install，三者缺一不可。
部署脚本里硬编码的 vendor/autoload.php 必须同步替换
本地改完 config.vendor-dir 后，所有 PHP 入口文件（如 index.php、bin/console、public/index.php）里的 require 'vendor/autoload.php' 都会失效。部署时最常漏掉的就是这一步。
- 错误示例：
require 'vendor/autoload.php';—— 即使composer.json已设"vendor-dir": "lib/vendor"，这条仍会报Fatal error: require(): Failed opening required 'vendor/autoload.php' - 正确写法：
require 'lib/vendor/autoload.php';，路径必须与config.vendor-dir值完全一致 - CI/CD 脚本中同理：检查
php -f bin/console或phpunit命令前是否设置了COMPOSER_HOME或加载了错误路径
bin-dir 和 bin-compat 不配齐，命令行工具就调不动
第三方包（如 phpunit、php-cs-fixer）声明的 bin 字段，依赖 Composer 在 bin-dir 下生成符号链接或可执行副本。只改 vendor-dir 不动 bin-dir，会导致 vendor/bin/phpunit 找不到，而新目录下又没生成对应文件。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 必须在
composer.json的config中同时配置："bin-dir": "lib/vendor/bin"（值要与vendor-dir逻辑匹配）"bin-compat": "full"（尤其在中文路径或 Windows 下，避免软链失败后静默跳过） - 改完后必须删掉旧
vendor/和composer.lock，再跑composer install——update不会重建bin-dir内容 - 部署脚本中所有硬编码的
vendor/bin/xxx都得替换成lib/vendor/bin/xxx
composer install 前不清理旧 vendor 目录，新路径不会生效
Composer 不会迁移已有依赖。即使你已在 composer.json 中正确配置 "vendor-dir": "third-party"，只要旧 vendor/ 目录还存在，composer install 就会跳过重写入口文件、autoload 映射和 bin 链接，直接复用旧结构。
- 部署流程中必须包含：
rm -rf vendor && rm composer.lock（或等价操作），再执行composer install --no-dev --optimize-autoloader -
composer dump-autoload -o不能替代install：它只刷新类映射，不重建autoload.php主入口、不生成bin文件、不更新ClassLoader的根路径 - 如果使用 Docker，确保
vendor/不在.dockerignore中被意外排除，否则构建时可能残留空目录
IDE 和运行时环境索引不同步，调试时类能加载但 IDE 报错
PHPStorm、VS Code + Intelephense 等工具默认只扫描项目根下的 vendor/ 目录。改了 vendor-dir 后，它们无法自动识别新路径下的类定义，导致代码补全失效、跳转失败、未使用警告误报。
- PHPStorm：进入 Settings → PHP → Include Paths，手动添加新路径（如
lib/vendor） - VS Code：在工作区设置中补充
"intelephense.environment.includePaths": ["lib/vendor"] - 运行时没问题 ≠ 开发体验没问题：类加载由 Composer 自动完成，但静态分析工具不读
composer.json，只认显式声明的路径
autoload.php 引用路径、bin-dir 配置、旧 vendor 清理三者必须同时到位；少一个，上线后不是报错就是功能缺失，且错误信息往往不指向真正原因。
