必须在镜像URL末尾加斜杠，否则静默回退官方源；需手动编辑composer.json添加packagist镜像并禁用packagist.org；换源后须删除vendor和composer.lock重新安装，并配置有效缓存路径。

composer config -g repo.packagist 命令必须带尾斜杠

不加 / 会静默 fallback 到官方源，composer diagnose 看不出异常，但下载速度仍是 0 B/s。命令必须写成：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。验证方式是运行 composer config -g repo.packagist，输出应为完整 JSON，且 url 字段值末尾有且仅有一个 /，type 必须是 "composer"。

项目级配置比全局更可靠，但别清空原有 repositories

在项目根目录执行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不带 -g）会全量覆盖 composer.json 中的 repositories 字段，导致私有 VCS 源丢失。正确做法是手动编辑 composer.json，在 repositories 对象内添加 "packagist": {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，并在顶层设 "packagist.org": false。

Browser Setup (No-Root Linux)

在无 root/sudo 权限的环境（云容器、VPS、隔离主机）中安装并配置 OpenClaw 浏览器工具的 headless Chrome。适用场景：...

下载

已有 composer.lock 时换源必须重装

旧 composer.lock 记录的是官方源的 dist URL 和哈希，阿里云镜像路径不同，校验必然失败。直接 composer install 会报错或卡住。必须先删掉 vendor/ 和 composer.lock，再跑 composer install --no-dev --prefer-dist --optimize-autoloader 重新生成。

缓存路径未设置会导致加速失效

只配镜像不配缓存，90% 的包仍要重复下载。执行 composer config -g cache-files-dir ~/.composer/cache/files 确保路径有效；再设 composer config -g cache-files-ttl 3600 防止缓存过期误用。Docker 构建中若挂载 ~/.composer/cache，务必同步保证 composer.lock 和 PHP 版本严格一致，否则缓存无意义。

换源本身很简单，真正容易被忽略的是：镜像 URL 尾部斜杠、lock 文件残留、缓存路径缺失这三点——任何一个出错，都会让“换源”变成无效操作。