Git 基本配置

2026-01-13 2026-01-13 约 515 字预计阅读 3 分钟

Windows 可以在 https://git-scm.com/ 下载安装, Linux 一般发行版都自带 Git .

使用 ssh-keygen 命令可以生成 ssh-key , 在 Windows 和 Linux 一般都是自带的, 终端运行后可以交互式生成, 没有特殊需求直接按三次回车即可.

生成的密钥对在用户目录的 .ssh 目录下, 其中名称为 xxx.pub 的是公钥, 名称取决于加密方式, 比如 id_ed25519.pub .

将公钥文件中的内容可以添加到 GitHub 配置中或者远端服务器, 实现无密码 SSH 通信.

使用以下命令配置 Git 名称与邮箱.

git config --global user.name "name"
git config --global user.email "email@example.com"

默认 Git 在终端无法输出中文, 执行以下命令让终端 Git 命令可以正常显示中文.

git config --global core.quotepath false

如果系统配置了代理, HTTP(S) 的仓库源会走代理, 但是 SSH 源不会走代理, 如果是私有仓库 HTTP(S) 方式 Pull/Push 需要输密码, SSH 方式又会很慢, 所以需要让本机和 GitHub 的 SSH 连接也经过代理.

Linux 下, 在 ~/.ssh/config 中添加以下内容让 GitHub 的 SSH 连接的 push/pull/clone 走代理

Host github.com
    # 使github的ssh连接走代理
    ProxyCommand socat - PROXY:127.0.0.1:%h:%p,proxyport=7897

如果没有 socat 需要自行安装.

Windows 下, 可以在 C:\Users\你的用户名\.ssh\config 添加以下内容

Host github.com
    # 使github的ssh连接走代理
    ProxyCommand "C:\Program Files\Git\mingw64\bin\connect.exe" -S 127.0.0.1:7897 %h %p

注意 C:\Program Files\Git 替换成你安装 Git 的路径, Git 安装时会默认勾选安装 mingw64 , 如果你的 Git 目录下面没有这个可以尝试重新安装一下 Git .

配置文件中的代理 IP 和端口要注意替换成自己的.

配置完成后使用 ssh -T git@github.com 可以测试连通性检验配置是否成功.