composer.lock不存在时composer install直接报错，必须用composer update生成；新版v2.5+报“command install is not defined”，旧版静默失败致vendor不一致，因install语义是“按lock精确还原”，无lock即无依据。
composer.lock 不存在时 install 直接报错，必须用 update 生成
新版 Composer（v2.5+）遇到缺失 composer.lock 会直接拒绝执行 composer install，报 Command "install" is not defined；旧版可能静默失败，但 vendor/ 内容必然不一致。这不是环境问题，是设计逻辑：install 的语义就是“按 lock 精确还原”，没 lock 就没依据。
常见触发场景：
- 新项目初始化后直接跑
composer install -
composer.lock被误删且未重新生成 - Git 克隆项目时该文件被
.gitignore拦截或上游未提交
正确做法只有一条：composer update。它会读取 composer.json，解析依赖约束，下载元数据，计算兼容版本，并写入合法的 composer.lock 文件。
update --lock 和 update 的区别很关键，别混用
composer update --lock（Composer v2.2+ 支持）只重写 composer.lock 文件，不修改已安装的 vendor/ 内容；而 composer update 会重新下载、解压、安装所有包，可能引入 BC break。
适用场景：
- 你确认
vendor/是最新且正确的，只是composer.lock被手动改坏或丢失 → 用composer update --lock - 你刚拉取代码，
composer.lock缺失，且想确保依赖树完全匹配当前composer.json→ 用composer update - CI 流水线中需验证 lock 是否与 vendor 一致 → 先
composer update --lock --no-install，再比对 git diff
注意：--lock 不校验 PHP 版本或扩展要求，它只是“同步快照”，不会跳过平台不兼容错误。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
flock 失败导致 lock 写不进去，本质是文件系统或权限问题
报 Could not lock file ./composer.lock 或卡在 Writing lock file，不是 Composer 坏了，而是底层 flock() 调用失败。根本原因只有三类：
-
composer.lock所在目录不可写，或文件属主为root（常见于曾用sudo composer install）→ 运行ls -l composer.lock，若显示-r--r--r--或属主为root，执行chmod u+w composer.lock或sudo chown $USER:$USER composer.lock - 路径挂载在不支持 POSIX 锁的文件系统上，如
ntfs（Windows / WSL2/mnt/c/）、nfs、9p→ 运行df -T .查看类型，确认后把项目移到 Linux 原生路径（如~/project） -
.git目录存在且可访问时，可用临时替代方案：flock .git -c 'composer update'
禁用插件和脚本（--no-plugins --no-scripts）能绕过部分锁依赖，但不能解决并发写冲突本身。
镜像源不同步引发的“生成失败”其实是校验失败
运行 composer update 后报 hash verification failed 或卡在 Downloading...，大概率不是网络问题，而是国内镜像（阿里云、腾讯云等）元数据未及时同步：比如 dist.sha256 没更新、autoload 字段被精简、CDN 中间层篡改响应体。
处理步骤必须闭环：
- 先禁用镜像：
composer config -g --unset repos.packagist，再设回官方源：composer config -g repo.packagist https://packagist.org - 彻底清理：
rm -rf vendor composer.lock - 强制重装：
composer update --no-cache --force-checksums
离线环境也需额外加 COMPOSER_DISABLE_NETWORK=1，否则即使有 composer.lock，也会因远程校验失败而中断。
最易被忽略的是：重建 composer.lock 后，vendor/autoload.php 可能仍未生效——务必补一记 composer dump-autoload -o，否则运行时仍报 Class not found。
