必须用 composer install 而不是 composer update，因为项目已有 composer.lock 文件，install 严格按其中记录的版本和哈希值安装，确保环境一致；update 则忽略 lock 文件，可能引入不兼容版本。

Vendor目录缺失时，直接运行 composer install 是最安全、最符合项目预期的做法，而不是 composer update。

为什么必须用 composer install 而不是 composer update

项目已有 composer.lock 文件（正常协作项目必然存在），说明依赖版本已被锁定。此时运行 composer update 会忽略 lock 文件，重新解析所有依赖并可能升级到不兼容的新版本，导致行为不一致甚至报错。

• composer install 严格按 composer.lock 中记录的版本和哈希值安装，确保与他人环境完全一致
• 若无 composer.lock，install 会报错，这是设计上的保护机制，提醒你确认来源是否可信
• CI/CD 流程、生产部署脚本普遍依赖 install，换用 update 可能绕过版本管控

composer install 执行前要检查的三件事

命令看似简单，但失败常源于前置条件未满足。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• 确认当前目录下存在 composer.json —— 缺失则报错 Could not find a composer.json file
• 确认 composer.lock 存在且未被篡改 —— 若 hash 不匹配，会提示 The lock file does not contain require-dev information 或类似校验失败
• 检查 PHP 版本是否满足 composer.json 中 "config": {"platform": {"php": "..."}} 或各包的 require.php 声明，否则会跳过部分包或报 Your requirements could not be resolved

常见报错及对应操作

遇到错误别急着重试，先看提示关键词：

• Failed to download vendor/package: Could not fetch...：网络问题，可临时加 -vvv 看具体域名，或配置国内镜像：composer config -g repo.packagist composer https://packagist.phpcomposer.com（注意该镜像已停用，推荐用 https://mirrors.aliyun.com/composer/）
• Class XXX not found 即使 vendor 生成成功：检查 autoload 配置是否正确，运行 composer dump-autoload 强制重建自动加载映射
• Permission denied: vendor/bin/xxx：Linux/macOS 下某些 bin 脚本缺少执行权限，可手动 chmod +x vendor/bin/*，但更可能是 umask 或挂载卷权限问题

真正麻烦的不是命令本身，而是 lock 文件和本地 PHP 环境之间的隐式契约——它不报错，但一跑就崩；它不提醒，但差一个点号就装错版本。