Composer config -g –unset 删除全局配置项操作【命令】

composer config -g –unset 是删除 Composer 全局配置项的正确命令，但必须指定完整点路径键名（如 github-oauth.github.com），不支持删数组元素或无键执行，且不操作 auth.json 文件。

composer config -g --unset 是删除 Composer 全局配置项的正确命令，但它必须指定具体的配置键名，否则会报错或无效果。

必须指定要删除的配置键名

该命令不能单独运行，--unset 后面必须跟一个有效的全局配置键（如 github-oauth.github.com、http-basic.repo.packagist.org 等）。不带键名执行会提示“Not enough arguments”或直接失败。

• composer config -g --unset github-oauth.github.com —— 删除 GitHub Token 配置
• composer config -g --unset http-basic.repo.packagist.org —— 删除 Packagist 基础认证
• composer config -g --unset foo.bar —— 若键不存在，不会报错，但也不起作用

确认键名是否存在再删除

全局配置文件默认在 ~/.composer/config.json（linux/macOS）或 %appDATA%Composerconfig.json（windows），但直接编辑有风险。建议先用 composer config -g --list 查看当前所有已设项，避免误删或删错层级。

• 嵌套键名需用点号分隔，例如 repositories.packagist.org 是合法键，而 repositories 是对象，不能直接 --unset
• 删除数组元素（如某个 repositories 条目）不支持，--unset 只能删顶层键或点路径键，不能删数组索引
• 若删的是整个 section（如 repositories），需确保它不是 Composer 自动写入的关键结构，否则可能影响后续 install

删完后记得验证是否生效

删除操作不会自动刷新内存缓存，某些行为（如访问私有仓库）可能仍沿用旧凭据，直到下次请求触发重读配置。建议配合以下方式验证：

• 运行 composer config -g --list | grep "your-key" 检查是否已消失
• 执行 composer diagnose 查看是否有配置冲突提示
• 必要时加 -v 参数重跑安装命令，观察是否还尝试使用已删的凭证

真正容易被忽略的是：键名大小写敏感、点路径必须完全匹配、以及删除后某些凭据可能仍保留在系统 keyring 或 auth.json 中 —— config -g --unset 只动 config.json，不碰 auth.json。