vendor目录非空但composer.lock缺失或不匹配时，composer install会报错退出而非覆盖；必须确保composer.json、composer.lock和vendor三者同时存在且内容一致，否则需先rm -rf vendor composer.lock再执行composer install。
vendor 目录非空但 composer.lock 缺失或不匹配
Composer 不会主动覆盖已有 vendor 目录，除非它能确认当前 lock 文件与已安装内容一致。如果 composer.lock 丢失、为空，或版本与 vendor 中实际包不匹配，composer install 会直接报错退出（如 “Your requirements could not be resolved” 或静默跳过），而非覆盖。
- 先验证三者是否对齐：
ls -l composer.json composer.lock vendor/—— 三者必须同时存在且vendor/非空时，composer.lock必须能描述其中所有包 - 若
composer.lock缺失，不要直接运行composer install；应先composer update生成新 lock，或从 Git 拉取正确版本 - 若
vendor/是旧项目残留，而你手头只有新composer.json，最稳做法是：rm -rf vendor composer.lock && composer install
执行 install 时提示 “Directory is not empty” 且指向非 vendor 路径
这个错误通常不是来自 vendor/，而是 Composer 尝试写入的其他目录被占位，比如 COMPOSER_VENDOR_DIR 自定义路径、cache-dir 或全局 bin 目录（如 /usr/local/bin）。错误信息里带的路径才是真实目标。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 检查报错行中出现的路径，例如：
file_put_contents(/usr/local/bin/laravel): Permission denied→ 问题在全局 bin 目录 - 用
composer config --global bin-dir查当前全局 bin 路径；若不可写，改用用户级：composer config --global bin-dir ~/.local/bin，并确保~/.local/bin已加入$PATH - 若自定义了
COMPOSER_VENDOR_DIR，确认该路径存在且当前用户有写权限：mkdir -p $COMPOSER_VENDOR_DIR && chown $USER:$USER $COMPOSER_VENDOR_DIR
CI/CD 或 Docker 中 vendor 非空引发冲突
流水线里反复复用同一工作目录，容易导致上一次失败留下的半截 vendor/ 与本次 composer.lock 不兼容。Composer 默认不清理，只校验一致性，结果就是卡住或报错。
- 在 CI 脚本开头强制清理：
rm -rf vendor composer.lock，再跑composer install - 避免挂载宿主机
vendor/进容器——Docker volume 绑定会导致权限错乱和状态残留，应在Dockerfile内执行RUN composer install - 加
--no-scripts --no-plugins可绕过部分因 vendor 不完整触发的脚本失败，但不能解决 autoload 错误
“Directory is not empty” 实际是缓存或临时目录写入失败
Composer 在下载、解压、生成 autoload 时会频繁读写临时路径（如 ~/.composer/cache/、/tmp），这些目录若被 root 占用、inode 耗尽或只读挂载，也会抛出类似提示，但错误路径未必显眼。
- 运行
df -i $(composer config --global cache-dir)看 inode 是否 100%；若满，先composer clear-cache - 检查缓存目录归属：
ls -ld $(composer config --global cache-dir)；若属主是 root，执行sudo chown -R $USER:$(id -gn) ~/.composer/cache - 某些 Alpine 容器中
/tmp权限异常，可临时指定缓存路径：COMPOSER_CACHE_DIR="$PWD/.composer-cache" composer install
