Composer在Windows 11上必须配置国内镜像源，否则因Packagist官方CDN对国内带宽限制而卡死；推荐阿里云镜像https://mirrors.aliyun.com/composer/，执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/全局生效，换源后需删除vendor和composer.lock并清缓存。
Composer在Windows 11上能装好，但默认走国外源基本卡死——不是网络问题，是Packagist官方CDN对国内出口带宽限制太狠。换源不是可选项，是必做步骤。
php -v 检查失败：PATH没配对或PHP本身缺关键扩展
运行 php -v 报错“不是内部命令”，说明系统根本找不到php.exe。这和Composer无关，是PHP环境没搭稳。
- 确认PHP安装路径（如
C:\php8.2或C:\xampp\php）已加进系统环境变量Path，不是用户变量 - 重启终端（CMD/PowerShell/Windows Terminal），旧窗口不生效
- 打开
php.ini（用php --ini查位置），确保以下三行前面的分号已去掉：extension=openssl、extension=curl、extension=mbstring - 如果仍报错，检查是否漏装VC++2019运行库（x64版），官网下载安装即可
composer --version 命令无效：安装方式选错或bat脚本写崩了
用 Composer-Setup.exe 安装后输 composer --version 提示“找不到命令”，大概率是安装时没勾选“Add to PATH”，或者安装程序误判PHP路径。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 手动验证PHP路径是否被识别：运行
where php，应返回完整路径；若无输出，PATH配置失败 - 不推荐重装安装包，直接用phar方式补救：下载最新
composer.phar放到C:\php8.2目录下，在同目录新建composer.bat，内容为：@ECHO OFF<br>php "%~dp0composer.phar" %*
- 把
C:\php8.2加进PATH后，新终端里就能直接用composer命令
composer install 卡在 “Loading composer repositories”：必须换源，且不能用过期镜像
当前（2026年7月）可用的国内镜像只剩两个稳定节点：https://packagist.org 官方源在国内基本不可用，老教程里写的 https://packagist.phpcomposer.com 已于2025年底停服。
- 全局换源（推荐）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 项目级换源（更安全）：进项目目录后运行
composer config repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/ - 换源后务必删掉
vendor和composer.lock，再跑composer install，否则缓存会干扰新源 - 阿里云镜像响应快但偶尔同步延迟；清华镜像同步准但偶尔有短时503，建议先试阿里云
内存不足报错 “Allowed memory size exhausted”：不是PHP内存不够，是Composer进程自身吃太多
Windows下Composer默认用3G内存上限，但某些依赖树深的项目（比如Laravel + Vue + 多个SDK）会直接爆掉，报错信息里带 memory_limit 很容易误导你去改 php.ini。
- 正确做法是加内存参数启动：
php -d memory_limit=-1 C:\php8.2\composer.phar install - 或临时提高全局限制：
COMPOSER_MEMORY_LIMIT=-1 composer install - 别碰
php.ini里的memory_limit，那影响Web服务，和CLI模式无关
最常被跳过的环节是换源后没清 composer.lock，结果看着进度条动了，其实还在读本地缓存的老包信息——表面没报错，实际装的全是旧版本，后续 require 新包时冲突就来了。
