composer require 是声明依赖、锁定版本、下载代码、注册自动加载四步合一的原子操作；跳过它直接改 composer.json 易致线上 Class not found，常见原因包括：不在项目根目录执行、加了 --no-install、包被误写入 require-dev 后又用 --no-dev 安装、或 composer.lock 已存在兼容版本而复用。
composer require 不是“装个包”的快捷方式，它是声明依赖、锁定版本、下载代码、注册自动加载四步合一的原子操作。跳过它直接改 composer.json，90% 的线上 Class not found 都这么来的。
为什么 composer require 后 vendor 里没文件？
根本原因不是网络或权限问题，而是命令压根没真正执行安装 —— 常见于以下几种情况：
- 当前目录下没有
composer.json，composer require会静默失败或创建新项目（比如误在public/或vendor/下运行） - 项目已有
composer.lock，且其中已存在兼容版本，Composer 直接复用，不拉新代码（此时vendor/里可能早就有该包） - 加了
--no-install参数（极少用），只改composer.json，不触发安装 - 包被写进了
require-dev，但你运行的是composer install --no-dev（CI 环境最常见）
验证方法：先 cat composer.json | grep -A 2 "require" 确认是否真写入；再 ls -d vendor/vendor-name/package-name 看目录是否存在。
composer require 版本号写错的典型表现
写法不对不会报错，但会在后续 composer update 时突然崩掉。关键差异在于语义：
-
monolog/monolog:2.13.4→ 等价于^2.13.4，下次update可能升到2.99.9 -
monolog/monolog:v2.13.4→ 精确锁定，update完全不动它 -
monolog/monolog:~2.13.0→ 允许2.13.x，但不进2.14.0 -
monolog/monolog:^2.13→ 允许2.13.0到2.999.999，不跨3.0 - 不写版本（
composer require monolog/monolog）→ Composer 自己选最新稳定版，PHP 8.0 项目可能被塞进要求 8.1+ 的3.0.0
查真实可用版本：运行 composer show monolog/monolog --all，别信 Packagist 页面上写的 “Latest”。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
交互式选版本（-i）为什么经常没反应？
composer require monolog/monolog -i 不是万能开关，它只在「发现多个兼容稳定版本」时才弹出列表。失效场景很具体：
- 项目已装
monolog/monolog，且现有约束（如"^2.10"）仍匹配新请求 → 直接复用，不问 - 当前 PHP 版本或扩展缺失，只剩一个可安装版本（比如只有
2.13.4满足php: ^7.4）→ 自动选，不问 - 环境变量
COMPOSER_NO_INTERACTION=1或命令带--no-interaction→ 强制关闭 - 用了
@dev或dev-main→ Composer 当作分支拉取，不走版本候选逻辑（除非额外加--stability=dev）
输入数字选中后，Composer 会立刻写入 composer.json 并执行 install，不是只改 JSON。
装完包却 new SomeClass() 报错？autoload 没刷新
Composer 不会在 require 后自动重跑 dump-autoload，哪怕新包自带 autoload 配置。常见假象是 “vendor 里有文件，但类就是找不到”：
- 先确认该包的
composer.json是否含autoload字段（比如"psr-4": {"Monolog\": "src/"}） - 检查你项目入口是否真
require 'vendor/autoload.php'（漏写或路径错） - 运行
composer dump-autoload --optimize强制重建映射 - 如果包用的是自定义路径（如
"files": ["src/helpers.php"]），还要确认该文件没被opcache缓存住
最隐蔽的坑：你自己项目也定义了 psr-4 映射，且命名空间和新包冲突（比如都用了 "App\"），Composer 会按 composer.json 里出现顺序加载，后写的覆盖前写的。
