必须确认镜像已生效，否则composer install会卡在packages.json请求并报“could not fetch”；正确配置为composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（末尾斜杠不可少），输出应为{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。
composer install前必须确认镜像已生效
迁移 PHP 应用时，composer install 不会自动继承旧环境的镜像配置——它只读 composer.lock 和本地 Composer 配置。如果镜像没提前配好，install 过程会卡在 packages.json 或一堆 provider-*.json 请求上，报错却显示 “Could not fetch” 而非明确提示镜像问题。
- 执行
composer config -g repo.packagist，输出必须是{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}（注意末尾/） - 若输出
Key "repo.packagist" does not exist，说明全局镜像未设，或被项目级repositories字段覆盖 - 验证真实请求地址：加
-vvv运行composer install，日志中应出现类似Downloading https://mirrors.aliyun.com/composer/packages.json - Windows 用户执行完命令后必须关闭并重开终端，否则仍读缓存配置
项目级配置会完全屏蔽全局镜像
只要项目根目录的 composer.json 里有 "repositories" 字段（哪怕空数组），Composer 就无视 composer config -g repo.packagist，直接回退到默认源。这种“静默覆盖”是迁移失败最常见原因。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 检查
composer.json是否含"repositories": [...]——CI/CD 模板或旧团队脚本常悄悄加这一行 - 若存在且需保留私有源，必须把镜像源显式写进该数组首位，并确保
"packagist.org": false显式禁用官方源 - 别依赖
"type": "package"或"type": "vcs"来“代理”官方包——Composer 3.x+ 对 packagist 元数据走硬编码路由，不经过 repositories 列表 - 临时排查：删掉
composer.json中整个repositories字段，再试composer install
金融级应用要额外防 TLS/DNS 卡顿
专线网络下，packagist.org 常因 TLS 握手超时、OCSP Stapling 失败或 DNS 解析卡顿而彻底连不通，不是慢，是根本无响应。这时镜像 URL 的证书链完整性、IPv4 强制策略就成关键。
- 必须用支持 OCSP Stapling 和完整证书链的镜像，如阿里云
https://mirrors.aliyun.com/composer/或华为云https://www.php.cn/link/2f159dfb71adadd9ed3956f59a97c248 - 设置环境变量
COMPOSER_IPV4=1，避免 IPv6 路由异常导致卡死 - 禁用 fallback：执行
composer config -g repo.packagist composer https://www.php.cn/link/1569ae888190eb8c53b218b0d529e1e9后，再运行composer config -g --unset repos.packagist.org（注意是repos.packagist.org，不是repo.packagist） - 别用
packagist.phpcomposer.com等已停服或证书过期的旧镜像，它们在金融环境会触发证书链校验失败
vendor-dir 变更和镜像必须分步验证
config.vendor-dir 和镜像源互不干扰，但迁移时若同时改这两项，容易误判失效原因：看似 vendor 目录没生成，实际是镜像没生效，根本没走到解压那步。
-
vendor-dir必须写在项目级composer.json的config字段下，值为相对路径（如"libs"），不能用环境变量或全局 config 设置 - 改完
vendor-dir后，必须先删掉旧vendor/目录，再跑composer install；update不会迁移已有包 - 镜像未生效时，
install会卡在下载阶段，vendor-dir根本不会被触及——先确认镜像，再验证路径 - IDE（如 PHPStorm）不感知
vendor-dir变更，需手动更新索引路径和autoload.php引用
composer config -g repo.packagist 和 -vvv 日志交叉验证。php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
