结论是安装新库时报锁文件错误，90%因flock无法锁定composer.lock——文件不存在、不可写或文件系统（如NFS/WSL2/mnt/c/）不支持POSIX锁；需先确认文件存在可写，或改用.git目录加锁，新增依赖必须用composer update而非install。
直接说结论：安装新库时报锁文件错误，90% 不是 Composer 本身坏了，而是 flock 没法对 composer.lock 加锁——它要么不存在、要么不可写、要么所在文件系统根本不支持 POSIX 锁。
composer.lock 不存在或只读时，flock 直接失败
常见于 CI 首次构建、Git 分支 checkout 后没提交 lock 文件、或 .gitignore 误加了 composer.lock。运行 flock ./composer.lock -c 'composer install' 报 No such file or directory 或 Permission denied，就是这个原因。
- 先确认文件存在且可写：
ls -l composer.lock；若输出含-r--r--r--，说明只读，执行chmod u+w composer.lock - 若文件根本不存在，别硬跑
composer install，先从main或稳定分支复制一份干净的composer.lock过来 - Docker 场景下检查挂载卷是否为
:ro，以及容器内 UID/GID 是否与宿主机一致
在 NFS / WSL2 / Windows 路径下 flock 失效
报 Could not lock file，但 ls -l 显示权限正常？大概率是底层不支持 POSIX flock()。比如 WSL2 的 /mnt/c/、NFS 挂载点、Git for Windows 的 MSYS2 环境。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 验证方式：
df -T .，若输出含nfs、ntfs或9p，就坐实了 - WSL2 用户请把项目移到
~/project（Linux 原生路径），避开/mnt/c/ - 临时替代方案：
flock .git -c 'composer install'（前提是.git目录存在且可访问）
想装新库却死在“Writing lock file”？你可能用错了命令
composer install 从不更新 composer.lock，它只按锁还原。你改了 composer.json 里的 require，再跑 install 会直接报错：Your lock file does not contain a compatible set of packages。
- 新增/删包、改版本约束、调整
config.platform，必须用composer update生成新 lock - 只想重写 lock 文件（如只改了 PHP 平台版本），用
composer update --lock（Composer 2.2+ 支持） - CI 中避免并发冲突，不能靠
--no-interaction，得用平台级锁（如 GitHub Actions 的concurrency）或 shell 层flock
“Could not delete” 文件时，本质是进程占用或权限错位
尤其在 Windows 上，编辑器、杀毒软件、PHP 开发服务器常锁定 vendor/ 下的文件，导致 Composer 无法清理旧包。
- 先停掉本地服务（
php -S、Laravel Sail、Vite）、关掉 VS Code/PhpStorm 中打开的相关文件 - 手动删提示路径下的目录：
rm -rf vendor/some-package（Linux/macOS）或del /F /Q vendor\some-package（Windows） - 如果反复出问题，检查
vendor/所有者是否为root（ls -ld vendor/），若是，删掉重来比修权限更稳妥
真正棘手的是混合场景：比如 WSL2 + NFS 挂载 + CI 并发 + composer.lock 被 Git 忽略——这种组合会让所有单点修复都失效。优先挪路径、保 lock、禁插件、用平台原生锁，比在 shell 里套七八层 flock 更可靠。
