如何通过 composer config 命令修改本地或全局配置？_网络技术

发布时间 - 2025-12-09 00:00:00 点击率：次

composer config 可直接修改本地或全局配置，无需手动编辑文件；通过--local（默认）或--global指定作用域，用点号分隔的路径设置嵌套键值，支持查看(--list)、删除(--unset)及重置配置。

用 composer config 可以直接修改 Composer 的本地（项目级）或全局配置，无需手动编辑 composer.json 或 auth.json 文件。关键在于指定作用域和配置项路径。

默认情况下，composer config 修改的是当前项目的 composer.json（即 local 模式）。加 --global 参数则操作全局配置（通常位于 ~/.composer/config.json）。

改本地配置：直接运行命令，如 composer config repo.packagist composer https://packagist.phpcomposer.com
改全局配置：加上 --global，如 composer config --global github-oauth.github.com your_token

配置项路径遵循 JSON 键名结构，支持嵌套（用点号分隔）。几个高频场景：

设置私有仓库：composer config repositories.myrepo vcs https://git.example.com/my/package.git
配置 GitHub OAuth Token：composer config --global github-oauth.github.com abc123def456
禁用 Packagist 默认源：composer config --global packagist.org false
设置镜像源（推荐国内用户）：composer config --global repo.packagist composer https://packagist.phpcomposer.com

除了设置，config 命令也支持读取和清理：

查看某项配置：加 --list 列出全部，或直接跟键名，如 composer config github-oauth.github.com
删除某项配置：加 --unset，如 composer config --global --unset github-oauth.github.com
清空整个配置文件（慎用）：composer config --global --unset *（仅限 global）

修改后配置立即写入对应 JSON 文件，但部分设置（如镜像源、OAuth）在下次 composer install 或 update 时才实际生效。全局配置需确保当前用户对 ~/.composer/ 有读写权限；若报错“Permission denied”，可 chown 修复。

基本上就这些。不复杂但容易忽略作用域和路径写法，多试两次就熟了。