Composer install在Windows+Docker下卡住的根本原因是宿主机与容器路径、权限、缓存不一致：需用正斜杠路径（如/c/Users/xxx/project）、清缓存、设COMPOSER_HOME，并确保镜像配置满足repo.packagist单数键名、显式type=composer、URL以/结尾三条件。
Composer install在Windows+Docker下卡住，不是网络问题
根本原因是宿主机和容器对路径、权限、缓存的理解不一致。Windows的C:\路径写进docker-compose.yml的volumes里，Docker Desktop会映射失败或权限拒绝，导致vendor/写入异常，后续composer install反复重试直到超时。
- 改用正斜杠路径：
/c/Users/xxx/project，而非C:\Users\xxx\project - 优先用相对路径：
./src:/app/src，避免硬编码盘符 - 容器内执行前先清空缓存：
composer clear-cache，否则仍读取旧的packages.json快照 - CI/CD中必须显式设置
COMPOSER_HOME=/tmp/composer，否则每次容器重启都丢失全局镜像配置
镜像配置写了却没生效，检查这三处硬伤
composer config -g repo.packagist命令看似成功，但日志里还在请求packagist.org，99%是以下三个条件没同时满足：
- 键名必须是
repo.packagist（单数，不能是repos.packagist或packagist.org） -
type值必须显式写composer，漏掉就静默 fallback - URL必须以
/结尾，例如https://mirrors.aliyun.com/composer/✅，少斜杠会拼出/composerpackages.json返回404
验证是否真写进去了：composer config -g repo.packagist输出必须是完整 JSON，如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null或报Key does not exist，说明压根没写进去。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
换源后报“hash does not match”，删vendor和composer.lock再装
这不是校验失败，是旧composer.lock里记录的包 URL 和哈希来自官方源，切换镜像后 Composer 仍按原路径去阿里云或腾讯云找 zip 包——但镜像服务的内部路径映射与packagist.org不同，校验必然失败。
- 删掉项目根目录下的
vendor/目录 - 删掉
composer.lock文件 - 运行
composer install（不是update），让 Composer 重新解析依赖并生成适配新镜像的 lock 文件 - 加
-vvv确认实际请求域名：composer install -vvv | grep "mirrors\."，看到mirrors.aliyun.com或mirrors.cloud.tencent.com才算真正走镜像
CI/CD里Composer install总失败，别信“本地能跑”
本地成功 ≠ CI 环境成功。GitHub Actions、GitLab Runner、宝塔面板等环境默认没有用户级~/.composer/config.json，全局镜像配置完全无效。
- 进项目根目录运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g），把镜像写进composer.json的repositories字段 - 确保
composer.json里"repositories"是对象{}，不是数组[]；否则命令会失败，需手动改成"repositories": {} - 必须加
"packagist.org": false，否则 Composer 2.2+ 仍可能 fallback 到官方源触发超时 - CI脚本开头加
composer validate --strict，提前捕获composer.json语法或依赖冲突，比等install失败后再查快得多
跨平台项目最易被忽略的点：镜像配置只是第一步，缓存、lock 文件、CI 环境变量、路径格式，四个环节任一断开，composer install就会在不同平台表现不一致。
