Composer配置导出：备份开发环境的全局设置与插件

直接复制全局配置文件是最可靠备份方式：先用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）命令来测试是否能找到全局安装的命令。