composer 提示 "git config source.xxx.git http" 错误怎么办？

当Composer因Git配置问题无法安装包时，需调整Git协议或使用镜像源。1. 检查并修正Git全局配置，删除错误的insteadOf规则；2. 设置git config --global url."https://".insteadOf git://，避免防火墙拦截；3. 配置Composer使用国内镜像如阿里云，并同步设置Git镜像地址；4. 在composer.json中为特定包指定HTTPS仓库地址或全局替换SSH为HTTPS；5. 可临时设置preferred-install为dist，优先下载zip包避免调用Git。核心是确保Git能通过HTTPS访问仓库并配合镜像加速。

当你在使用 Composer 安装或更新包时，遇到提示类似 "git config source.xxx.git http" 的错误，通常是因为 Composer 尝试通过 Git 克隆某个依赖包，但当前环境没有配置正确的 Git 源地址，或者 Git 配置被限制了 HTTP/HTTPS 的使用。

这个问题常见于企业内网、GitHub 被屏蔽或 Composer 镜像未完全生效的场景。下面是几种有效的解决方法：

1. 检查并修改 Git 的全局配置

查看当前 Git 配置是否有强制规则：

git config --global --get url."https://".insteadOf
git config --global --get url."git://".insteadOf

如果你看到类似：

git config --global url."https://github.com/".insteadOf "git@github.com:"

这表示 Git 正在尝试替换协议，但可能目标地址不可访问。你可以删除或修正它：

• 删除错误配置：
  git config --global --unset url."https://github.com/".insteadOf
• 改为使用镜像地址（如国内可用）：
  git config --global url."https://mirrors.tencent.com/git/".insteadOf "https://github.com/"

2. 让 Composer 使用 HTTPS 替代 Git 协议

设置 Git 使用 HTTPS 代替：

git config --global url."https://".insteadOf git://

这样所有 git:// 开头的地址都会自动转为 https://，提高成功率。

Looka

AI辅助Logo和品牌设计工具

894

查看详情

3. 修改 Composer 配置使用镜像源

设置 Composer 镜像（例如阿里云）：

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

同时确保 Git 可以访问镜像站点：

git config --global url."https://mirrors.aliyun.com/git/".insteadOf "https://github.com/"

4. 强制使用 HTTPS 拉取特定包

可以在项目根目录的 composer.json 中添加仓库配置，改用 HTTPS：

"repositories": [
    {
        "type": "vcs",
        "url": "https://github.com/xxx/package-name"
    }
]

或全局设置 Git 替换：

git config --global url."https://github.com/".insteadOf "git@github.com:"

5. 临时关闭 Git 外部命令（慎用）

composer config --global preferred-install dist

这会让 Composer 优先下载打包好的 zip 包，而不是通过 Git 克隆，适合生产环境。

基本上就这些。关键是让 Git 能正常访问远程仓库，要么修复网络，要么做协议替换，再配合 Composer 镜像，问题就能解决。不复杂但容易忽略配置细节。

以上就是composer 提示 "git config source.xxx.git http" 错误怎么办？的详细内容，更多请关注php中文网其它相关文章！