composer config -g repo.packagist 命令必须同时满足四个硬性条件：加-g参数、键名repo.packagist（单数）、显式指定type值composer、URL为HTTPS且末尾带/，缺一则静默失效，验证需输出完整JSON对象。
composer config -g repo.packagist 命令为什么总不生效
这条命令必须同时满足四个硬性条件，漏一个就静默失败、查不到值、install 依然卡在 Loading composer repositories：
-
-g参数不能省：没加就是项目级配置，对全局无效 - 键名必须是
repo.packagist（单数），写成repos.packagist（多了一个 s）会写进无效字段 - type 值必须显式写出：
composer不能省，否则 Composer 2.0+ 直接 fallback 回官方源 - URL 必须是 HTTPS + 末尾带斜杠：
https://mirrors.aliyun.com/composer/少了/，请求会变成/composerpackages.json，返回 404 且不报错
验证是否真写入：运行 composer config -g repo.packagist，输出应为完整 JSON 对象，例如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null 或报错都说明失败。
WSL2 下镜像“配了但没用”的真实原因
即使 composer config -g repo.packagist 输出正确，composer install 还是慢或卡住，大概率是这两个隐藏问题：
- DNS 缓存未刷新：PHP 的 cURL 复用系统 DNS 缓存，
mirrors.aliyun.com可能仍被解析到海外 IP。不用改系统 DNS，临时加环境变量即可：COMPOSER_IPV4=1 composer install - 项目级
repositories字段覆盖全局：只要项目根目录composer.json里出现"repositories"字段（哪怕只有一行[]），全局镜像立刻失效。删掉该字段或设为null才能恢复
验证是否真走镜像：加 -vvv 运行 composer update，grep mirrors.aliyun.com；或跑 composer diagnose，看 Repo packagist.org: 后面显示的地址是不是你设的镜像 URL。
为什么不能用 apt install composer
Ubuntu 官方源里的 composer 包版本老旧（常为 1.x 或极旧 2.x），运行 composer install 时大概率报 Package manifest version mismatch —— 这不是你项目写错了，是 lock 文件格式和源码不兼容。
在 Windows 上执行终端命令，或对比 Windows 与 Linux 的 Shell 语法时使用。建议先检测当前 Shell 是 PowerShell 还是 cmd.exe，再给出相应命令……
官方脚本安装会直接拉取最新稳定版（当前为 2.7.x），且自动校验 SHA384 哈希值，安全性与一致性都有保障。别图省事走 apt，多敲三行命令换半年不踩坑更划算。
正确安装方式（推荐）：
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === 'e0012edf3e80b6978849f5eff0d4b4e4c79ff1609dd1f6133267b7b9067c888a00ce5aa39641261124005205c58f97413303') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer
中文路径和空格到底能不能用
WSL2 默认使用 UTF-8 编码，composer.json 里写中文包名、中文注释、甚至项目路径含中文（如 ~/我的项目）完全没问题 —— Composer 本身不解析路径语义，只调用 PHP 的 file_get_contents 和 proc_open，而这些函数在 WSL2 的 ext4 分区上对 UTF-8 支持良好。
唯一要注意的是：composer create-project 如果指定目标目录含空格或中文，务必用引号包裹，例如：composer create-project laravel/laravel "我的新项目"。不加引号会导致 shell 把空格当分隔符，命令直接崩。
真正要避开的是 /mnt/c/ 这类 Windows 挂载路径：符号链接、权限、大小写敏感等问题频发。项目尽量放在 WSL 原生文件系统下，比如 ~/projects/。
