必须先让php和composer都能全局调用，否则composer install会直接报错退出；需验证php -v有输出、必要扩展已启用、composer --version正常且路径正确，并配置国内镜像源（如阿里云）、清缓存、确保项目含composer.json与composer.lock文件。
必须先让 php 和 composer 都能全局调用，否则 composer install 会直接报错退出，连依赖下载环节都进不去。
确认 php 已就位且扩展启用
这不是可选项——composer install 本质是 PHP 脚本，它启动前就得先找到 php.exe 并加载必要扩展。
- 在 CMD 或 PowerShell 中运行
php -v：无输出或提示“不是内部或外部命令”，说明php.exe所在目录（如C:\xampp\php）没加进系统 PATH；需手动添加并重启终端 - 运行
php -m | findstr openssl（Windows）或php -m | grep openssl（macOS/Linux）：若无输出，打开php.ini，确认这三行已取消注释：extension=php_openssl.dll、extension=php_curl.dll、extension=php_zlib.dll - 用 XAMPP/WAMP 的用户，别只靠控制面板里的 Shell 窗口临时验证——
composer install是独立进程，必须走系统 PATH
验证 composer 命令可用且指向正确版本
很多人装完 Composer 就以为万事大吉，但 composer --version 成功不代表 composer install 能跑通——它可能调用了旧版或损坏的安装包。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 执行
composer --version：应输出类似Composer version 2.7.6；若报错或版本低于 2.5，建议运行composer self-update升级 - 检查实际路径：
where composer（Windows）或which composer（macOS/Linux）：确保返回的是C:\ProgramData\ComposerSetup\bin\composer.bat或你手动配置的路径，而非某个项目目录下的残留文件 - 如果曾手动下载过
composer.phar，务必确认没有同名composer文件干扰 PATH 查找顺序
换国内镜像源，避免卡死在 “Loading composer repositories”
新电脑首次执行 composer install，默认会尝试从境外 packagist.org 拉取元数据。DNS 解析 + TLS 握手 + 大量包索引下载，在国内几乎必超时，错误常表现为长时间静默或最终报 cURL error 60。
- 立即执行全局换源：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 别信“等第一次失败再配”，因为失败后本地会缓存无效元数据，后续即使换源也要先清缓存：
composer clear-cache - 如果项目根目录已有
composer.json且含"repositories"字段，该配置优先级高于全局设置，得手动删掉或改成阿里云地址
检查当前目录是否含有效 composer.json 和 composer.lock
composer install 不是万能安装器——它只做一件事：按 composer.lock 精确还原依赖。没有 lock 文件，它会退化成 composer update 行为，这在新环境里极危险。
- 进入项目目录后，先运行
dir composer.*（Windows）或ls composer.*（macOS/Linux）：必须同时存在composer.json和composer.lock；若只有json，应改用composer install --no-dev或联系项目维护者获取正确 lock 文件 - 注意隐藏文件：某些 Git 仓库可能忽略
composer.lock，导致拉下来就是空的；别自己生成，lock 文件必须由原作者提交 - 如果
composer.lock里声明的 PHP 版本高于当前php -v输出，install会直接中止，报错类似Your requirements could not be resolved to an installable set of packages.
最容易被忽略的是：换源后第一次 composer install 仍可能慢（要下载完整元数据快照），但只要不卡在 “Loading…” 超过 2 分钟，就说明配置生效了。真正的坑不在命令本身，而在它启动前那几秒——php 是否真就位、composer 是否真干净、镜像是否真生效，三者缺一不可。
