必须先确保composer命令可用，再执行composer config -g repo.packagist composer https://packagist.phpcomposer.com设置全局镜像，且需确认php cli就绪、path配置正确、全局config.json可写，三者缺一不可。

直接改全局配置就行，不需要重装或动 php.ini —— 但必须先确认 composer 命令本身能正常运行，否则设置镜像会报错“command not found”或“Could not open input file”。

确认 composer 命令可用是前提

很多用户卡在镜像设置前，其实根本原因是 composer 还没真正装好。执行 composer --version 报错？那就别急着设镜像，先解决这个：

• 确保 WampServer 当前激活的 PHP 版本路径（如 C:\wamp64\bin\php\php8.2.12\）已加入系统 PATH
• 打开新命令行窗口，运行 php -v 能显示版本才算 CLI 就绪
• 再验证 composer --version 是否输出版本号；如果提示“不是内部或外部命令”，说明 composer.bat 或安装路径没进 PATH

用 config -g 设置国内镜像最可靠

WampServer 环境下，composer config -g repo.packagist composer https://packagist.phpcomposer.com 是最稳定的方式。注意三点：

First Principles Decomposer

把任何问题拆解为根本真理，再从原子层面重建解决方案。

下载

• 必须加 -g（global），否则只对当前目录生效，换个项目就失效
• 旧镜像地址 https://packagist.phpcomposer.com 仍可正常使用，别用已停服的 https://packagist.laravel-china.org
• 执行后运行 composer config -gl 查看结果，确认 [repositories.packagist.org.url] 显示为你刚设的地址

遇到 “Could not write to … config.json” 错误怎么办

这通常是因为 Windows 权限或路径含中文/空格导致 Composer 写不了全局配置文件。常见现象是命令看似执行成功，但 config -gl 里没变，或者报错：

• 不要把 WampServer 安装在 C:\Program Files\ 或带中文用户名的路径下（比如 C:\Users\张三\）
• 检查 %APPDATA%\Composer\config.json 文件是否可写；右键属性 → 安全 → 编辑当前用户权限，勾选“写入”
• 临时用管理员身份运行命令提示符再试一次 composer config -g ...

镜像设置本身很简单，难点永远在环境链路：PHP CLI 可用 → composer 命令可达 → 全局 config 目录可写。三者缺一不可，而最后一步最容易被忽略。