Git 实战系列（一）Git 安装与配置

发表于 更新于

要想 Git 用得爽，首先要安装与配置好。

如何选择版本？

Git 1.x

旧版本，不再维护。

Git 2.x

新版本，推荐使用。不向下兼容 1.x。

如何安装？

Windows

需要安装 Git for Windows 的客户端 msysgit。推荐使用 绿色便携版 ，优势如下：

  • 无需安装，无需写注册表，无需管理员权限；
  • 可以从任意目录运行，甚至 U 盘；

与安装版的区别：

  • 不提供右键上下文菜单（如 Git GUI Here、Git Bash Here），因为该功能需要写入注册表；
  • 不修改环境变量 %path% ，因此无法在命令行工具 cmd 中直接运行 git.exe 和 gitk.exe，解决办法：
    • 推荐使用自带的 Git Bash （类 Unix Shell）或 Git Cmd 进行替代；
    • 或将 %GIT_HOME%\cmd 目录永久加入环境变量 %path% （如果只想在当前会话中临时使用，只需在 cmd 中运行 set path=%GIT_HOME%\cmd;%path% 即可），然后运行 git --help 测试配置效果；

Linux / Unix

使用包管理 apt-get 或 yum 即可。

OS X

Homebrew 是最快最便捷的安装方式：

1
$ sudo brew install git

如何配置？

Git 相关的配置文件有三个：

  1. /etc/gitconfig 包含了适用于系统所有用户和所有项目的值。
  2. ~/.gitconfig 只适用于当前登录用户的配置。
  3. Git 项目中的 .git/config 适用于特定 Git 项目的配置。

对于同一配置项，三个配置文件的优先级是 3 > 2 >1。

配置提交作者

开始使用 Git 之前，第一件重要的事情就是配置提交作者，配置后就可以愉快的开始使用 Git 了。更多配置请参考 这里 。

首先做如下检查：

全局配置

使用 --global 查看或修改全局配置文件 ~/.gitconfig：

1
$ git config -l | grep user

如果返回为空表示未配置，需要配置如下：

1
2
$ git config --global user.name "你的姓名"
$ git config --global user.email "你的邮箱"

项目配置

如果需要单独修改项目配置文件 .git/config，去掉 --global 参数即可，或者直接打开该文件添加：

1
2
3
[user]
name = who
email = who@where.com

配置格式化与空白

格式化与空白是许多开发人员在协作时，特别是在跨平台情况下，遇到的令人头疼的细小问题。由于编辑器的不同或者Windows程序员在跨平台项目中的文件行尾加入了回车换行符，一些细微的空格变化会不经意地进入大家合作的工作或提交的补丁中。不用怕，Git 的一些配置选项会帮助你解决这些问题。

core.autocrlf

Git 在你提交时自动地把行结束符 CRLF 转换成 LF，而在签出代码时把 LF 转换成 CRLF。假如团队成员只在 Windows 上写程序，可以关闭此功能，避免 Git 自动格式化代码后干扰代码对比：

1
$ git config --global core.autocrlf false

core.whitespace

Git 预先设置了一些选项来探测和修正空白问题，配置方法待补充。

常见问题

Git 长期使用上的一点不便，解决方案仅供参考。

中文乱码显示问题

  1. 打开 GitBash（git-bash.exe）后，对窗口右键->Options->Text->Locale 改为 zh_CN，Character set 改为 GBK ;

  2. 键入exit退出关闭再打开即可。

配置工作目录

Git 默认使用程序运行目录作为工作目录，这会带来使用上的不便。解决办法是新建 .bashrc 文件：

1
$ vim ~/.bashrc

添加一行：

1
2
# 请将 /d/Repos/ 替换成你的仓库目录
cd /d/Repos/

即可自动切换到本地仓库所在目录。

配置 SSH 代理和密钥

另一个潜在的问题是运行 Git Bash 并拉取远程仓库提示错误：

1
Could not open a connection to your authentication agent.

这是因为 ssh-agent 未随 bash 一起启动。你可以每次都手工启动，或推荐编写脚本自启动。

新建 .bashrc 文件，并添加如下代码：

1
2
3
4
5
6
7
8
9
#!/bin/sh
if [ -f ~/.agent.env ]; then
  . ~/.agent.env >/dev/null
  kill -15 $SSH_AGENT_PID
fi

echo "Starting ssh-agent..."
eval `ssh-agent |tee ~/.agent.env`
ssh-add ~/.ssh/github_rsa

这将会自启动 ssh-agent 并添加指定私钥。 ssh-agent 是一个密钥管理器，运行 ssh-agent 以后，使用 ssh-add 将指定私钥交给 ssh-agent 保管，其它程序（例如 git）在需要身份认证的时候，可以将认证申请交给 ssh-agent 来代为完成整个认证过程。

那么以后每次运行 Git Bash 的时候，就会看到输出效果如下：

1
2
3
Starting ssh-agent...
Agent pid 8828
Identity added: ~/.ssh/github_rsa

参考