当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 的全局配置
Composer 在拉取私有或公开 Git 仓库时会调用系统 Git。如果 Git 被配置为强制使用 HTTPS 或 SSH，而网络不通，就会报错。查看当前 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 默认使用 git:// 协议，该协议使用 9418 端口，常被防火墙拦截。设置 Git 使用 HTTPS 代替：
git config --global url."https://".insteadOf git://
这样所有 git:// 开头的地址都会自动转为 https://，提高成功率。
alfred-github-backup
下载
GitHub 仓库备份技能 - 将 OpenClaw 工作空间自动或手动备份至 GitHub 私有仓库。支持自动定时备份和手动交互式配置，引导完成 Token 配置、仓库创建、首次备份及定时任务设置。用途：(1) 首次设置 (2) 日常备份。
3. 修改 Composer 配置使用镜像源
如果你在中国大陆，建议使用 Composer 镜像加速，并确保 Git 仓库也能走镜像。设置 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 中定义的是 git@github.com:xxx 的 SSH 地址，若 SSH 不通也会失败。可以在项目根目录的 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 外部命令（慎用）
如果只是想快速跳过 Git 问题，可以让 Composer 不调用外部 Git：composer config --global preferred-install dist
这会让 Composer 优先下载打包好的 zip 包，而不是通过 Git 克隆，适合生产环境。
基本上就这些。关键是让 Git 能正常访问远程仓库，要么修复网络，要么做协议替换，再配合 Composer 镜像，问题就能解决。不复杂但容易忽略配置细节。
