使用GitGit GUI和TortoiseGit

Posted 2020-08-04

1. 关于命令行

我一直建议在命令行中使用Git或者SVN。因为这样可能更加了解他们的工作方式，也不容易遗漏重要的问题和提醒。

在Windows习惯的驱使下，大多数人是不会看弹出的对话框中有什么信息的，一般都是直接关掉。但是，版本库给我们的提示信息都是非常重要的，有的是冲突，有的是提交失败，等等，这些都被略过了。

我碰到的关于版本库使用问题主要包括下面这些：

• 没有获取到最新版本就编译程序
  出现这个问题的原因，主要是忽略了文件的冲突。有的是从不看版本库给的提示，有的是太依赖Windows资源管理器中指示冲突的图标覆盖。众所周知，Windows系统的图标缓存一直都有那么点问题。
• 用删除文件的方式解决冲突
  许多程序猿并不知道如何解决冲突，也看不懂版本库在文件中加入的解决冲突的提示。
• 用删除文件代替revert
  至于为什么大家都这么用，我还搞不懂……
• 强行覆盖提交
  碰到冲突后，备份自己修改的文件，然后恢复版本库中最新文件，再用自己的文件覆盖版本库中的文件然后提交。 哥哥诶～～你干的好事！

其实如果在命令行中使用 Git 或者 SVN ，以上的问题应该都不会存在。因为命令行会事无巨细的给我们提示，尤其是Git的命令行，会非常聪明的猜测我们的意图并给我们提示。
使用者要正确的使用命令行，就必须去仔细阅读版本库的文档。这样就能进一步了解版本库的工作原理，减少在使用中的错误。

另外，Git的很多功能，尤其是高级功能，只有命令行能实现。

但并非所有程序猿都愿意使用命令行工具，尤其是被Windows惯坏了的那批。

所以，有了TortoiseSVN和TortoiseGit。

2. Git GUI

Git自带GUI界面。使用 git gui 命令可以打开它。在这个界面中可以完成commit、merge、push、pull等等常用操作。

使用 gitk 可以打开查看Git版本库历史，在 git gui 中也有菜单可以打开它。

个人以为，完全可以不用安装TortoiseGit，对于绝大多数程序猿来说，这个界面已经足够了。

但是，和“关于命令行”中说的那句话一样，并非所有的程序猿都愿意使用这个 界面简陋到丑陋 的工具，尤其是被TortoiseSVN惯坏了的那批。

那些从SVN转换过来的程序猿，绝大多数都只用过TortoisSVN。那么好吧，就让界面、名字都完全一样的TortoiseGit登场吧！

3. 安装TortoiseGit

3.1 TortoiseGit没有集成Git

在TortoiseGit官方网站可以下载到它。有32bit和64bit版本，同时也有中文语言包（但我不建议你安装）。

安装完毕之后，如果你没有安装过Git，那么还需要去下载msysGit来安装。因为TortoiseGit其实只是一个壳，它需要调用Git命令行才能发挥作用。（现在你知道我为什么推荐你用命令行了么？）

如果你不安装msysGit，那么在运行TortoiseGit的时候会弹出这个提示：

为什么TortoiseGit不像TortoiseSVN一样，把SVN命令行工具集成在安装包中呢？我猜想是以下几点原因：

• Git官方从未出过Windows版本二进制包；
• msysGit和TortoiseGit是两个不同的团队开发的；
• msysGit和TortoiseGit的更新周期差异较大；
• TortoiseGit团队希望安装包更小；
• TortoiseGit团队给用户更灵活的选择Git版本的权利。

3.2 Git for Windows VS msysGit

msysGit的主页提供了两个项目：Git for Windows和msysGit，并写明了它们的详细区别。
个人认为，Git for Windows适合绝大多数程序猿（又见绝大多数 :D）。所以，强烈建议安装Git for Window。
msysGit使用一种很BT也很NB的方式来安装。先安装一个最小的MinGW/MSYS系统，然后使用git pull 所有的源码，调用gcc在本地编译成可执行文件。

3.3 Cygwin

如果本机安装过Cygwin，那么在安装msysGit的时候，cygwin的bin目录不能位于PATH环境变量中，否则msysGit会拒绝安装。
其实，如果你不在意Cygwin提供的Git版本比较老，你完全可以不安装Git for Windows或者msysGit，直接在TortoiseGit中设置Git.exe的路径为Cygwin的bin目录即可。

由于Cygwin目前的Git版本较老，在运行TortoiseGit的时候你会得到这个提示：

关于Cygwin、MinGW以及msysGit的关系和选择，可以看这篇文章：Cygwin与MinGW，如何选择？
还有这篇转载的文章：Msys/MinGW与Cygwin/gcc

4. TortoiseGit的密钥

我认为TortoiseGit最大的问题，就是在于它使用ppk密钥格式，而不是使用OpenSSH密钥格式。
因为linux系统是默认使用OpenSSH的，所以Git在基于命令行的时候是使用OpenSSH格式的密钥。
同理，gitolite这种服务器端程序使用的是OpenSSH格式的密钥。
所以，必须将原有的OpenSSH密钥转换成PPK密钥才能在TortoiseGit中使用。

在安装TortoiseGit的时候，你可以选择使用Putty还是OpenSSH作为SSH客户端。安装程序中说，Putty和Windows配合得更好。

如何选择？我分别给出它们的特点：

Putty

1. Putty有GUI界面，可以通过配置sessions来访问不同的git服务器端口；
2. Putty有GUI程序(Putty Key Generator)来生成密钥；
3. 如果使用Putty作为SSH客户端，那么传输速度可能会比较慢（个人感觉，当然也有人和我有一样的感觉）；
4. Putty不能直接使用原有的OpenSSH密钥，必须将其转换成PPK密钥才行。

OpenSSH

1. OpenSSH是Git命令行程序默认使用的SSH客户端程序；
2. Git for Windows默认就包含了OpenSSH程序；
3. 你可以利用已有的OpenSSH密钥，不用做转换（例如我原来用cygwin的时候积累了一堆OpenSSH密钥，现在只需要在~/.ssh下做一个符号链接就能用了）；
4. GitHub/bitbucket等Host使用的都是OpenSSH密钥；
5. 大多数Linux发行版默认使用OpenSSH作为服务端；
6. 你可以方便的使用命令行程序来实现自动化处理。

看完上面的特点，如果你还是选择了Putty作为客户端的话，那么需要转换原有的OpenSSH密钥（如果有的话）；
如果你依然义无反顾选择了OpenSSH作为客户端的话，我相信你已经知道如何生成、修改、配置SSH了，看来我也不必罗嗦 

4.1 转换OpenSSH密钥到ppk格式

可以使用TortoiseGit自带的Putty Key Generator来转换原来的OpenSSH密钥到ppk格式。

打开该程序，选择 Conversions->Import Key 命令将OpenSSH 私钥 导入界面中，然后点击 Save private key 按钮将密钥保存成ppk格式。建议在 Key comment 中输入说明，否则密钥多了很难分辨。至于密码，为了方便可以不设置。

4.2 生成OpenSSH和ppk格式的密钥

为了同时支持服务端和客户端，我们可以在生成一个密钥的时候，同时生成该密钥的ppk格式和OpenSSH格式。而每个密钥对都包含 公钥 和 私钥，两对一共是4个文件。这样就可以满足所有情况了。

打开Putty Key Generator，选择 Generator 按钮，晃动鼠标生成一个密钥，然后这样处理：

• 点击 Save private key 按钮将密钥保存成 ppk格式私钥；
• 点击 Save public key 按钮将密钥保存成 ppk格式公钥；
• 点击 Conversions->Export OpenSSH Key 按钮将密钥保存成 OpenSSH格式私钥；
• 获取上图红框中的所有文本内容，粘贴到文本编辑软件中，保存为一个单行的文件，这就是 OpenSSH格式公钥；

4.3 在TortoiseGit中使用SSH host

如果使用Putty作为TortoiseGit的SSH客户端，那么就不能使用OpenSSH的 ~/.ssh/config 来定义使用不同的端口和密钥访问SSH，而是需要使用 PuTTY Session。这篇文章进行了详细讲解： 在TortoiseGit中使用SSH host

4.4 从 putty 切换到 OpenSSH

也许是你一时 手贱……唔，手快选择了 putty 作为客户端，某天又良心发现想用 OpenSSH ，是否必须重装一次 TortoiseGit 来重新选择一次呢？

我曾经这样做过，直到我找到这个设置：

是的，只需要把 ssh客户端 改成 git for windows 提供的 ssh.exe 即可。如果用 Cygwin，那么这个程序在 cygwin/bin 目录中。

5. 杂项

5.1 换行符的问题 autocrlf and safecrlf

Windows(\r\n)、Linux(\n)和MacOS(\r)三个主流系统的换行符各不相同，这样在跨平台合作的时候就容易出现换行符的问题。

Git提供了 autocrlf 和 safecrlf 两个参数来解决这个问题。但这两个参数如果没用好，就会影响开发。

例如，出现这种情况：

A和B两个开发人员，A使用LF(\n)做换行符，B使用CRLF(\r\n)做换行符，且都没有开启 autocrlf 参数，那么A在迁出B的文件，并使用自己的编辑器打开之后就会发现，虽然没有对文件做任何修改，但它的状态是modified。这是由于A的编辑器自动将B的文件中的所有换行符替换成了(LF)，这与版本库中的(CRLF)不同。

让我们来看看 autocrlf 参数的作用：

# 签出时将换行符转换成CRLF，签入时转换回 LF。
git config --global core.autocrlf true

#签出时不转换换行符，签入时转换回 LF
git config --global core.autocrlf input

#签出签入均不转换
git config --global core.autocrlf false

这些选项在TorgoiseGit中也可以设置。

我的建议是在无论在什么系统下编程，都把所有人的编辑器的换行符模式设置成Unix格式，然后把autocrlf设置成false，这样一劳永逸。
毕竟除了Windows记事本这类软件外，已经很少有文本编辑器不支持换行符设置了。

如果你把换行符搞乱了，在一个文件中既包含windows风格的换行符也包含unix风格换行符，那么 safecrlf 就可以发挥作用了：

# 拒绝提交包含混合换行符的文件
git config --global core.safecrlf true

# 允许提交包含混合换行符的文件
git config --global core.safecrlf false 

# 提交包含混合换行符的文件时候给出警示
git config --global core.safecrlf warn

5.2 文件权限问题 755 and 664

我在Cygwin下以命令行的形式使用Git，同时也使用TortoiseGit。
在使用TortoiseGit签出使用cygwin提交的项目时，发现所有的文件权限都改变了：

$ git diff 
diff --git a/launch4j/spritesheet_conterver.xml b/launch4j/spritesheet_conterver.xml
old mode 100755
new mode 100644

这是因为msysgit是一个类Unix模拟器，需要拥有Unix形式的文件访问权限。而由于Windows的种种限制，信息不能复原，从而导致原来的755成644了。

解决方法：

git config --global core.filemode false
git config core.filemode false

这个选择的在TortoiseGit中没有界面来设置，只能用命令行或者手动修改git配置文件。

6. Mac OS X GUI 选择

因为 Mac OS X 已经自带了 git 工具，绝大多数情况下，不需要使用 GUI 工具。

如果一定要使用，那么建议使用下面两款：

6.1 GitX-dev

6.2 SourceTree

我的选择主要参考 The Best Mac Git Gui 以及 Git 官网的 GUI Clients 。

7. 文章参考

• http://blog.csdn.net/dbzhang800/article/details/6426834
• http://ycyuxin.blog.hexun.com/37440972_d.html
• http://stackoverflow.com/questions/4181870/git-on-windows-what-do-the-crlf-settings-mean
• http://www.360doc.com/content/11/0117/18/2036337_87178762.shtml

---

关联文章

1. git乱码解决方案汇总
2. PuTTYcyg的替代者FuTTY
3. 安装gitolite
4. 修改了SSH默认端口之后，如何配置git？
5. cygwin升级到1.7后，git gui和gitk报错