阿里云镜像是目前最快最稳的国内Composer镜像源，执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/即可全局切换，验证命令composer config -g repo.packagist应输出该地址。
直接换源就行，不用改项目配置、不碰 composer.json，全局生效最省事。阿里云镜像目前（2026年）仍是最快最稳的选择，packagist.phpcomposer.com 已停更多年，别再用。
执行一条命令完成全局镜像切换
运行以下命令即可把 Packagist 源永久切到阿里云镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
验证是否成功：
composer config -g repo.packagist
输出应为 https://mirrors.aliyun.com/composer/。如果报错“command not found”，说明 composer 未加入系统 PATH，或 composer global bin 路径没配进环境变量。
高级模板必须同步装 fxp/composer-asset-plugin
Yii2 高级模板（yii2-app-advanced）依赖前端资源（jQuery、Bootstrap 等），这些由 fxp/composer-asset-plugin 管理。它虽已停止维护，但 Yii2 2.0.x 仍强依赖它。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 必须用
global require方式安装，不能只在项目里require - 推荐版本是
~1.4.6或~1.5.0，新版 Composer（2.5+）对~1.4.6兼容性更好 - 执行：
composer global require "fxp/composer-asset-plugin:~1.4.6"
- 若提示 “Plugin installation failed”，大概率是 PHP 版本太低（需 ≥ 7.4）或权限问题（Windows 下建议以管理员身份运行 CMD）
创建项目时加 --repository 参数更保险
即使已设全局镜像，某些旧版 Composer 或 CI 环境仍可能 fallback 到官方源。创建项目时显式指定，可彻底规避卡在 yiisoft/yii2 包下载的问题：
composer create-project --prefer-dist --repository=https://mirrors.aliyun.com/composer/ yiisoft/yii2-app-advanced advanced
注意点：
-
--repository是 Composer 2.2+ 的写法；老版本请用--repository-url（已逐步弃用） - 不要混用
--repository和--repository-url，会冲突 -
--prefer-dist强制走 zip 包而非 git clone，国内网络下快得多，也避免 SSH key 或 GitHub 访问失败
换源后仍报错“Could not find package”？检查这三处
常见于本地已有旧项目或缓存污染，不是镜像本身问题：
-
composer clear-cache清掉本地包缓存（尤其换源后首次运行） - 确认没在项目根目录下误配了
composer.json里的repositories字段，它会覆盖全局设置 - 运行
composer diagnose，重点看 “Checking platform settings” 和 “Checking git settings” 是否有 warning
真正容易被忽略的是：换源只加速包下载，不解决 cookieValidationKey 未配置、runtime/ 不可写、PHP 扩展缺失（如 mbstring、openssl）这些启动级问题——镜像再快，项目起不来照样白搭。
