composer镜像配置必须同时满足三要素：正确字段名repo.packagist、必填type值composer、url末尾带斜杠，否则静默回退至官方源；还需清缓存、确认执行用户、检查项目级配置冲突，并用-vvv验证真实请求地址。
Composer项目初始化慢，不是网络差，是镜像根本没生效，或者参数没加对——换源+清缓存+关键参数缺一不可。
composer config -g repo.packagist 命令为什么总不生效
这条命令极易静默失败：写错字段名、漏掉composer type 参数、URL末尾少斜杠，都会导致 Composer 自动 fallback 到 https://packagist.org，但你不报错也看不到提示。
-
repo.packagist不能写成repos.packagist（多一个 s 就完全忽略） - 必须带
composer这个 type 值：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/✅；漏掉中间的composer❌ - URL 必须是 HTTPS + 末尾严格带一个
/：https://mirrors.aliyun.com/composer/✅；https://mirrors.aliyun.com/composer❌（部分 Composer 2.2+ 版本会 404 后静默回退） - 验证是否真生效：
composer config -g repo.packagist输出应为完整 JSON，形如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；空、null或仍是https://packagist.org都说明没写进去
为什么换了镜像还是卡在 Downloading
镜像只加速元数据和包下载，但如果你没清缓存、或执行用户不对、或项目里已有冲突配置，它照样走默认源。
- 必须执行
composer clear-cache：旧缓存里存着packages.json的签名和地址，Composer 会优先读它，哪怕你已改配置，它仍尝试从旧地址校验 - 宝塔、CI、systemd 服务中实际运行用户常是
www或jenkins，不是你登录终端的用户；查清执行身份：whoami && echo $HOME，再用对应用户执行sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 项目根目录下已有
composer.json且含"repositories"字段？它会覆盖全局配置；此时要么删掉该字段重试，要么手动编辑，在repositories里加一条"packagist": { "type": "composer", "url": "https://mirrors.aliyun.com/composer/" }，并在根节点加"packagist.org": false
create-project 必须带的四个参数
Laravel 或 ThinkPHP 新项目初始化本质是一次完整的 composer install，不加参数就等于裸跑，默认行为全是拖慢的源头。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
--prefer-dist：强制走 ZIP 包下载，跳过git clone和 submodule 同步（实测快 2–5 倍） -
--no-dev：新项目初始化阶段完全不需要phpunit、laravel/pint等开发依赖，省下 30+ 个包 -
--optimize-autoloader：生成静态类映射，减少后续 autoload 阶段文件扫描（尤其对 IDE 补全和首次请求有感知提升） -
--no-interaction：避免交互式提示阻塞自动化流程（比如 Laravel 安装时问你是否创建 Git 仓库）
完整命令示例：composer create-project laravel/laravel myapp --prefer-dist --no-dev --optimize-autoloader --no-interaction
怎么确认当前到底走的是哪个源
别猜，直接看日志。加 -vvv 是唯一可靠手段，它会打印出真实请求地址。
- 执行
composer install -vvv或composer create-project laravel/laravel test --vvv - 搜日志里的
Downloading行，例如：Downloading https://mirrors.aliyun.com/composer/packages.json✅；Downloading https://packagist.org/packages.json❌ - 如果看到
packagist.org，说明镜像未生效；如果看到镜像域名（如mirrors.aliyun.com），才算真正到位 - 临时验证某次命令是否走镜像，也可用
--repository-url参数：composer update -vvv --repository-url=https://mirrors.aliyun.com/composer/
最常被忽略的是：镜像只管下载，不管 Resolving dependencies 阶段——那完全是本地 CPU 暴力求解，和网络无关。如果卡在这里，得收紧 composer.json 里的版本约束，而不是换源。
