镜像源配置失效主因是四要素缺一不可：键名必须为repo.packagist（单数）、第二参数必填composer、URL须以https://开头且末尾带/、必须加-g；任一出错均静默回退官方源，且需运行composer config -g repo.packagist验证输出是否为完整JSON对象。
镜像源配不对，90% 的“慢”根本不是网络问题；自动加载没优化，autoload.php 就是生产环境的性能黑洞——这两件事必须分开解决，不能靠换源“顺便”提速。
repo.packagist 配置为什么总不生效
Composer 2.2+ 把 packagist.org 当作硬编码权威源，repositories 数组里的 packagist 条目会被忽略。真正起作用的只有全局 repo.packagist 字段，且四要素缺一不可：
- 键名必须是
repo.packagist（不是repos.packagist，多一个s就静默失效） - 第二个参数必须显式写
composer（这是仓库类型声明，漏掉会 fallback 到官方源） - URL 必须以
https://开头、末尾带/（https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌） - 必须加
-g参数（否则写进项目级配置，对 CI 或宝塔无效）
验证是否成功：运行 composer config -g repo.packagist，输出必须是完整 JSON：{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}。空、null、或只返回 URL 字符串，都说明没写进去。
composer install 卡在 “Resolving dependencies” 怎么办
这不是下载卡住，是本地 CPU 在暴力穷举满足所有约束的版本组合。尤其当 composer.json 里有宽泛约束时，求解器会指数级爆炸：
- 删掉
"minimum-stability": "dev"—— 稳定版能直接砍掉 80% 的求解时间 - 收紧 PHP 版本约束：
"php": "^8.1"比"php": ">=7.4"少查几百个包的兼容性元数据 - 确保
composer.lock已提交进 Git，并在 CI/部署中始终用composer install（不是update） - 临时禁用 xdebug：
php -d xdebug.mode=off $(which composer) install，它会让解析慢 5–10 倍
如果项目已有 repositories 字段，别手动编辑 composer.json，进项目根目录执行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g），让 Composer 自动合并。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
autoload_classmap.php 为什么没生成或不生效
镜像源不影响类映射生成逻辑，autoload_classmap.php 是否存在、是否被加载，完全取决于你执行的命令和配置：
-
composer dump-autoload -o在标准 PSR-4 项目中基本无效——它只刷新autoload_static.php和 PSR-4 映射表，不会重建vendor/composer/autoload_classmap.php - 真正生成 classmap 的唯一可靠方式是：
composer install --no-dev --optimize-autoloader --classmap-authoritative - 检查
vendor/composer/autoload_classmap.php是否存在且内容远超几十行（正常应含数千行） - 打开
vendor/composer/autoload_real.php，搜索addClassMap—— 若没调用，说明 classmap 根本没加载
生产环境必须加 --no-dev：开发依赖里的测试类、Mock 类会被扫进 classmap，导致文件体积暴涨（常达 2–5 MB），PHP-FPM 每次请求都要反序列化整个数组，而实际只用到其中不到 5% 的类。
缓存路径不合理会让 install 慢 2–5 倍
默认缓存路径 ~/.composer/cache 若落在机械盘、WSL2 挂载的 Windows 目录、加密卷或 NFS 上，解压 ZIP 包时 I/O 就成瓶颈：
- 查当前生效值：
composer config --global cache-dir - 强制迁移到 SSD 路径：
composer config -g cache-dir /mnt/ssd/composer-cache - 临时测试是否走新路径：
COMPOSER_CACHE_DIR=/tmp/composer-cache composer install --dry-run，再看/tmp/composer-cache下有没有新文件生成 - 缓存目录必须可写，且别挂到低速卷上；CI 或宝塔后台若用
www用户运行，得给该用户单独配缓存路径，而不是改root的全局配置
清缓存这一步不能跳过：composer clear-cache（不是 composer cache-clear，后者已废弃）。缓存里存着旧的 packages.json 和 provider 元数据，Composer 会优先读本地缓存再校验远程地址——哪怕你已经切了镜像，它仍可能反复尝试从 https://packagist.org 拉取索引。
