直接复制全局配置文件是最可靠备份方式：先用composer config --global --list确认路径（如~/.composer/config.json），再用cp命令备份并添加时间戳，例如cp ~/.composer/config.json ~/.composer/config.json.backup-20260415；切勿手动编辑或重建该JSON文件，避免格式错误导致Composer命令全部失败。
怎么备份 Composer 全局配置文件本身
说到备份 Composer 的全局配置，其实并没有一个专门的“导出命令”。真相是，所有通过 composer config --global 写入的设置，都老老实实地待在一个 JSON 文件里。所以，最直接、最可靠的办法，就是直接复制这个文件本身。
这里有个常见的误区：不少人以为运行 composer config --global --list 输出的内容，可以直接拿来还原配置。其实那只是个只读的快照，并非可写入的配置源文件。
- 第一步，找到它：运行
composer config --global --list，第一行显示的 “Global configuration file” 路径就是目标（比如/home/user/.composer/config.json或 Windows 下的%APPDATA%\Composer\config.json）。 - 第二步，复制它：直接用
cp命令或文件管理器复制这个文件。强烈建议在备份文件名里加上时间戳，例如：cp ~/.composer/config.json ~/.composer/config.json.backup-20260415。 - 一个关键提醒：千万别手动新建一个空的
config.json再把内容粘贴进去。JSON 格式极其敏感，少个逗号或者引号不闭合，就会导致后续所有composer命令都报file_get_contents(): Failed to open stream错误。 - 另外，如果你设置了
COMPOSER_HOME环境变量，备份前务必确认它指向的正确位置，否则可能备份错了文件。
怎么备份已全局安装的插件（如 lara vel/installer）
全局安装的插件（比如 Lara vel 安装器）有点特殊，它们不会被项目的 composer.json 或 composer.lock 记录，官方也没有提供导出机制。不过，它们实际上都安装在 COMPOSER_HOME/vendor/ 目录下，对应的可执行文件则统一放在 COMPOSER_HOME/vendor/bin/。
那么，真正需要备份的是什么？其实是“安装了哪些包以及它们的版本”这个清单，而不是整个 vendor 目录的文件。因为对于全局包来说，重新安装通常比直接复制文件更安全、兼容性也更好。
- 列出所有全局包：运行
composer global show --format=plain，这会输出包名和版本，适合人工核对。 - 导出为机器可读格式：如果需要给 CI 等工具使用，可以运行
composer global show --format=json。 - 只关注直接安装的包：使用
composer global show --direct --format=plain，这样可以排除那些被自动拉进来的嵌套依赖，清单更清晰。 - 注意：
composer global list这个命令已经废弃了，不要再用。另外，composer show如果不加global，查询的是当前项目的依赖，很容易混淆。
为什么不能用 composer install 恢复全局环境
想用 composer install 来恢复全局环境？这个思路从根本上就错了。composer install 只认当前目录下的 composer.json 文件，它完全感知不到全局配置或者全局安装的包。
全局环境的本质，其实是两样东西的组合：一份配置文件，加上一系列 composer global require 命令执行后的结果。这两者无法通过一个单一的命令来重建。
- 还原配置：备份好配置文件后，最稳妥的方式是用
composer config --global逐项还原。例如：composer config --global repo.packagist composer https://mirrors.aliyun.com/composer/。 - 还原插件：拿到备份的插件列表后，写个简单的脚本循环执行
composer global require vendor/name:^x.y即可。这比直接复制vendor/目录要干净得多，能避免权限、平台差异、文件校验错误等一系列潜在问题。 - 切记：不要试图删除
~/.composer/vendor目录后，再运行composer global update来恢复。这会导致所有包都被升级到最新版，很可能引入不兼容的变更，把事情搞得更复杂。
最容易被忽略的 PATH 问题
这是最后一步，也是最容易踩坑的一步。即便你完美备份并还原了全局配置和所有插件，如果系统的 PATH 环境变量里没有包含 COMPOSER_HOME/vendor/bin 这个路径，那么你在命令行里输入 lara vel 或 phpunit 时，依然会得到 “command not found” 的提示。
这个路径需要手动配置，Composer 不会自动添加，而且配置后通常需要重启终端才能生效。
- 在 Linux/macOS 上：检查你的
~/.zshrc或~/.bashrc文件，确保里面有类似这样一行：export PATH="$HOME/.composer/vendor/bin:$PATH"。如果你修改过COMPOSER_HOME，这里的路径也要同步更新。 - 在 Windows 上：确认系统环境变量
PATH中包含了%APPDATA%\Composer\vendor\bin。注意，在 PowerShell 中%APPDATA%不会自动展开，可能需要使用完整路径。 - 如何验证：可以运行
echo $PATH（macOS/Linux）或echo %PATH%（Windows）查看路径是否包含。更进一步，用which lara vel（macOS/Linux）或where lara vel（Windows）命令来测试是否能找到全局安装的命令。
