composer require 是唯一推荐的命令行方式，直接写入 composer.json 并安装依赖；执行前须确认存在有效 composer.json、php 和 composer 环境就绪、网络可访问 packagist 或已配镜像。
composer require 是唯一推荐的命令行方式，直接写入 composer.json 并安装依赖，不是“先改配置再装”，而是“一步到位”。
执行 composer require 前必须确认的三件事
当前目录下存在有效的 composer.json，否则会触发交互式 composer init，容易误建新项目；
PHP 环境已就绪（php -v 可查），且 Composer 已全局可用（composer --version 有输出）；
网络能访问 Packagist（或已配置国内镜像，如 https://packagist.phpcomposer.com 或 https://mirrors.aliyun.com/composer/），否则会卡在 “Resolving dependencies” 或报 Connection refused 错误。
composer require 的版本约束写法直接影响后续维护成本
不带版本号（如 composer require monolog/monolog）会默认安装最新稳定版，并写入 "monolog/monolog": "^3.0" 这类宽松约束——看似省事，但下次 composer update 可能升级到不兼容的大版本；
显式指定版本（如 composer require monolog/monolog:^2.9）更可控，尤其适合生产环境；
开发专用包必须加 --dev（如 composer require --dev phpunit/phpunit:^10），否则它会混进 require 字段，导致部署时被意外安装；
若要跳过自动执行 composer dump-autoload（比如你正在批量添加、稍后统一处理），可加 --no-autoloader 参数。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
常见失败现象和对应解法
Could not find a version of package xxx matching your minimum-stability：说明该包只有 dev 或 alpha 版本，而你的 composer.json 中 "minimum-stability" 是 stable，临时解决可加 --stability=dev，但更稳妥的是显式指定开发版（如 composer require vendor/package:dev-main）；Root composer.json requires vendor/package ^1.0, found vendor/package[v2.0.0] but v2.0.0 does not match the constraint：冲突来自已有依赖间接要求了旧版，此时不要硬加，先运行 composer prohibits vendor/package 查清谁在拦路；
执行后 vendor/ 里没看到包，但 composer.json 已更新：说明安装中途失败，检查 composer install --dry-run 输出，或删掉 composer.lock 后重试（仅限开发环境）。
composer require 看似简单，真正难的是理解它背后触发的依赖求解过程——每次执行都会重算整个依赖图，所以包越多、约束越复杂，失败概率越高。与其反复试错，不如先用 composer show vendor/package 看清可用版本，再决定约束写法。
