先确认是否在含composer.json的项目根目录执行；再检查版本约束写法是否正确（如^2.9）；最后排查lock文件冲突、网络代理或php版本兼容问题。
composer require 装不上包？先看是不是没在项目根目录
执行 composer require 前，终端当前路径必须是含 composer.json 的项目根目录。很多人在子目录（比如 src/ 或 tests/）里运行，报错 Could not find a composer.json file 或静默失败——它其实创建了新 composer.json 在当前目录，但不是你想要的。
- 用
pwd（macOS/Linux）或cd（Windows）确认位置，确保能看到composer.json - 如果项目还没初始化，先跑
composer init或composer create-project生成基础结构 - CI/CD 脚本里容易忽略这点，建议加一行
ls -l composer.json或test -f composer.json || exit 1做检查
dev-main、v2.3.0、^1.5 这些版本写法到底怎么选
版本约束直接影响依赖能否装上、会不会锁死、升级时是否自动更新。写错一个符号，可能装到意外的大版本，或根本找不到包。
-
composer require monolog/monolog:^2.9：推荐写法，允许安装 2.9.x 及以上、但低于 3.0 的版本 -
composer require monolog/monolog:dev-main：拉取主分支最新代码，不稳定，仅开发调试用；上线前务必换成稳定版 -
composer require monolog/monolog:v2.3.0：精确锁定，composer update不会动它，适合压测或复现 bug - 别写
2.9.*—— Composer 已弃用通配符语法，会被当成字符串字面量处理，大概率报错Could not parse version constraint
require 后 vendor 没更新？可能是 lock 文件冲突
运行 composer require 后，vendor/ 目录没变化、composer.json 写入了但 composer.lock 没同步更新，常见于多人协作中 lock 文件被手动修改或 git merge 出错。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先执行
composer install看是否报错，错误信息常提示 lock 文件与 json 不一致 - 确认无误后，加
--no-update参数跳过安装（只改 json）：composer require foo/bar --no-update，再手动composer update foo/bar - CI 环境建议统一用
composer install --no-interaction --prefer-dist，避免 require 命令触发交互式提示
require 安装失败还卡住？关掉 --no-progress 和代理试试
某些网络环境（如国内、企业内网）下，composer require 会卡在 “Loading from cache” 或 “Downloading…” 且无报错，实际是源响应超时或证书验证失败。
- 临时禁用进度条和缓存加速：
composer require foo/bar --no-cache --no-progress，更容易暴露真实错误 - 换镜像源：
composer config repo.packagist composer https://packagist.phpcomposer.com（注意：该源已停用，推荐用https://mirrors.aliyun.com/composer/） - 若用 HTTPS 代理，确保
HTTPS_PROXY环境变量已设，且 Composer 版本 ≥ 2.2（旧版不支持 proxy 验证）
最麻烦的情况是包本身有 platform-config 限制（比如要求 PHP 8.1+），而你的环境是 7.4 —— 错误信息藏在 verbose 日志里，加 -vvv 才能看到具体哪行不兼容。
