PHP CLI及openssl、curl、zip、mbstring、json扩展必须就绪，PATH需正确配置，国内用户须设阿里云镜像源，Windows安装后须重启终端验证。
确认PHP CLI和必要扩展是否就绪
Composer不是独立运行的工具，它依赖PHP命令行环境。如果php -v报错或版本低于7.2，后续所有操作都会失败。Windows用户常忽略PATH配置，Linux/macOS用户容易漏掉zip或openssl扩展。
- 运行
php -v，确保输出≥7.2（推荐8.0+） - 执行
php -m | grep -E "^(openssl|curl|zip|mbstring|json)$"（Linux/macOS），缺哪个就启用哪个；Windows需检查php.ini中对应extension=行是否取消注释 - 特别注意：
php -r "echo extension_loaded('openssl') ? 'ok' : 'fail';"比php -m更可靠，某些扩展可能加载失败但仍列在模块列表里
Windows下用Composer-Setup.exe安装但没生效
安装程序成功运行后，composer --version仍提示“不是内部或外部命令”，大概率是环境变量没刷新或PHP路径未被识别。这不是Composer问题，而是Windows PATH机制的典型表现。
- 安装时务必勾选“Add to PATH”——但该选项只修改当前用户的PATH，且**不会自动更新已打开的终端**
- 安装完成后，必须关闭所有CMD/PowerShell窗口，**新开一个窗口再测试**
- 如果仍失败，手动检查：右键“此电脑”→属性→高级系统设置→环境变量→查看“系统变量”里的Path是否包含PHP目录（如
C:\php）和Composer安装目录（如C:\Program Files\Composer） - 极少数情况是PHP本身没加到PATH，先确保
php -v能运行，再装Composer
Linux/macOS用curl安装后composer命令找不到
脚本执行成功、composer.phar文件存在，但输入composer提示command not found，说明文件没放对位置，或权限/PATH没配好。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 不要直接运行
php composer.phar --version就认为完事——这是本地调用，不是全局安装 - 推荐命令：
sudo mv composer.phar /usr/local/bin/composer && sudo chmod +x /usr/local/bin/composer - 验证
/usr/local/bin是否在PATH中：echo $PATH | grep "/usr/local/bin"，没有就加到~/.bashrc或~/.zshrc里：export PATH="/usr/local/bin:$PATH" - 别用
~/bin或./路径——它们通常不在默认PATH里，除非你显式配置过
国内用户首次运行composer init卡住或超时
不是网络不稳定，而是Packagist官方源（https://packagist.org）在国内访问极慢，甚至DNS污染导致连接失败。此时Composer会卡在元数据获取阶段，等几十秒后才报错。
立即学习“PHP免费学习笔记（深入）”；
- 必须在首次使用前配置镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 验证是否生效：
composer config -g repo.packagist应输出https://mirrors.aliyun.com/composer/ - 如果已卡住，Ctrl+C中断后配置镜像，再重试；不要试图用
composer init --no-interaction跳过——它仍会尝试连远程源 - 注意：镜像仅加速包下载，不影响
composer.json语法校验或本地依赖解析
