必须配置国内镜像源，因国内直连packagist.org存在dns污染、tls握手阻塞等刚性不可达问题；需严格满足键名repo.packagist、type值为composer、url末尾带/三条件，否则配置静默失效。
国内直连 packagist.org 基本不可用——不是你网络差，是物理距离+防火墙导致 TLS 握手超时、首字节延迟高、could not find package 或卡在 Downloading 阶段。必须配镜像，且要配对到位，否则 composer create-project 会静默失败或拉空 vendor/。
为什么 composer config -g repo.packagist 不生效
这条命令看似简单，但漏掉任意一个细节就白配：键名必须是 repo.packagist（不能写成 repos.packagist 或 repository），中间的 composer 是 type 值，不可省略，URL 末尾必须带斜杠 /。否则命令执行无报错，但 composer config -g repo.packagist 输出为空或仍是 https://packagist.org。
- 先运行
composer config -g --list看全局配置路径是否可写（比如 Windows 下权限不足时写入失败） - 已有项目里若存在
composer.json且含"repositories"字段，它会覆盖全局配置，得先删掉或注释掉再试 - 验证是否生效：执行
composer config -g repo.packagist，正确输出应为{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
composer create-project 卡住或拉不到包
这不是 Composer 坏了，是没走镜像源。国内环境下，create-project 默认直连海外源，容易卡在 Installing dependencies 或直接报 Connection timed out。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 优先用全局镜像：配好后直接运行
composer create-project topthink/think tp-demo，不加额外参数 - 临时切镜像（适合单次调试）：
composer create-project --repository=https://mirrors.aliyun.com/composer/ laravel/laravel myapp - 目标路径不能含中文、空格或大写字母（如
My Project），Windows 下易触发Could not delete错误 - 如果
vendor/为空，先清缓存：composer clear-cache，再重试
Docker 和 CI 环境下镜像配置常被忽略
很多人在 Dockerfile 里只写了 RUN composer config -g repo.packagist ...，但构建阶段用的是 composer:latest 镜像，运行阶段切换到 php:8.2-fpm-alpine 后，这个配置就丢了——因为 composer 是独立容器，它的配置不会自动同步到 PHP 容器里。
- 正确做法是在 PHP 运行阶段镜像中重新配置：
RUN composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 多阶段构建中，若用
COPY --from=composer /app/vendor /var/www/html/vendor，确保构建阶段也用了镜像源，否则vendor里包还是从国外拉的 - GitHub Actions 或宝塔等环境，默认以
www或runner用户运行，读不到你本地root的全局配置，必须做项目级配置
项目级镜像配置怎么写才安全
团队协作或 CI 场景下，全局配置靠不住，必须把镜像写进项目本身。推荐用命令自动写入，避免 JSON 格式错误。
- 进入项目根目录（含
composer.json），执行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/ - 手动编辑时，确保
"repositories"是数组，首位对象为{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，且顶层保留"packagist": true（千万别设为false，否则基础包全拉不到） - 改完必须删掉
vendor/和composer.lock，再跑composer install（不是update）
镜像配对只是第一步，xdebug 也会拖慢 composer install ——尤其 Laravel、ThinkPHP 这类框架，autoloader 初始化阶段可能多耗 3–5 秒。PHP CLI 环境下记得关掉它：php.ini 中注释掉 xdebug 相关行，再重启服务。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
