zh_cn/basic.txt

   1 == 基本技巧 ==
   2
   3 与其一头扎进Git命令的海洋中，不如来点基本的例子试试手。它们简单而且实用。实际
   4 上，在开始使用Git的头几个月，我所用的从来没超出本章介绍的内容。
   5
   6 === 保存状态 ===
   7
   8 要不来点猛的？在做之前，先为当前目录所有文件做个快照，使用：
   9
  10  $ git init
  11  $ git add .
  12  $ git commit -m "My first backup"
  13
  14 现在如果你的编辑乱了套，恢复之前的版本可以使用：
  15
  16  $ git reset --hard
  17
  18 再次保存状态：
  19
  20  $ git commit -a -m "Another backup"
  21
  22 === 添加、删除、重命名 ===
  23
  24 以上命令将只跟踪你第一次运行 *git add* 命令时就已经存在的文件。如果要添加新文
  25 件或子目录，你需要告诉Git：
  26
  27  $ git add readme.txt Documentation
  28
  29 类似，如果你想让Git忘记某些文件：
  30
  31  $ git rm kludge.h obsolete.c
  32  $ git rm -r incriminating/evidence/
  33
  34 这些文件如果还没被从系统中删除，Git将会删除它们。
  35
  36 重命名文件同删除旧文件，并同时添加新文件一样。也有一个快捷方式 *git mv* ，和
  37 *mv* 命令的用法一样。例如：
  38
  39  $ git mv bug.c feature.c
  40
  41 === 进阶撤销/重做 ===
  42
  43 有时候你只想把某个时间点之后的所有改动都回滚掉，因为这些的改动是不正确的。那
  44 么使用这个命令：
  45
  46  $ git log
  47
  48 来显示最近提交列表，以及查看他们的SHA1哈希值:
  49
  50 ----------------------------------
  51 commit 766f9881690d240ba334153047649b8b8f11c664
  52 Author: Bob <bob@example.com>
  53 Date:   Tue Mar 14 01:59:26 2000 -0800
  54
  55     Replace printf() with write().
  56
  57 commit 82f5ea346a2e651544956a8653c0f58dc151275c
  58 Author: Alice <alice@example.com>
  59 Date:   Thu Jan 1 00:00:00 1970 +0000
  60
  61     Initial commit.
  62 ----------------------------------
  63
  64 哈希值的前几个字符足够确定一个提交；也可以拷贝粘贴完整的哈希值，输入：
  65
  66  $ git reset --hard 766f
  67
  68 来恢复到一个指定的提交状态，并从记录里永久抹掉所有比该记录新一些的提交。
  69
  70 另一些时候你想简单地回朔到某一个旧状态。这种情况，键入：
  71
  72  $ git checkout 82f5
  73
  74 这个操作将把你带回过去，同时也保留较新提交。然而，像科幻电影里时光旅行一样，
  75 如果你这时编辑并提交的话，你将身处另一个现实里，因为你的动作与开始时相比是不
  76 同的。
  77
  78 这另一个现实叫作“分支”（branch），之后 <<branch,我们会对这点多讨论一些>>。
  79 至于现在，只要记住：
  80
  81  $ git checkout master
  82
  83 会把你带到当下来就可以了。另外，为避免Git的抱怨，应该在每次运行checkout之前提
  84 交（commit）或重置（reset）你的改动。
  85
  86 还以电脑游戏作为类比：
  87
  88 - *`git reset --hard`*: 加载一个旧记录并删除所有比之新的记录。
  89
  90 - *`git checkout`*: 加载一个旧记录，但如果你在这个记录上玩，游戏状态将偏离第
  91   一轮的较新状态。你现在打的所有游戏记录会在你刚进入的、代表另一个真实的分支
  92   里。<<branch,我们稍后论述>>。
  93
  94 你可以选择只恢复特定文件和目录，这将通过将其加在命令之后来实现：
  95
  96  $ git checkout 82f5 some.file another.file
  97
  98 小心，这种形式的 *checkout* 会不声不响地覆盖当前文件。为阻止意外发生，在运行任何
  99 checkout命令之前做提交，尤其在初学Git的时候。通常，任何时候你觉得对运行某个命
 100 令不放心，无论Git命令还是不是Git命令，就先运行一下 *git commit -a* 。
 101
 102 不喜欢拷贝旧提交的哈希值？那就用：
 103
 104  $ git checkout :/"My first b"
 105
 106 来跳到以特定字符串开头的提交。你也可以回到倒数第五个保存状态：
 107
 108  $ git checkout master~5
 109
 110 === 撤销 ===
 111
 112 在法庭上，事件可以从法庭记录里敲出来。同样，你可以检出特定提交以撤销。
 113
 114  $ git commit -a
 115  $ git revert 1b6d
 116
 117 讲撤销给定哈希值的提交。本撤销被记录为一个新的提交，你可以通过运行 *git log*
 118 来确认这一点。
 119
 120 === 变更日志生成 ===
 121
 122 一些项目要求生成变更日志http://en.wikipedia.org/wiki/Changelog[changelog]. 若
 123 要生成一个变更日志，可以键入：
 124
 125  $ git log > ChangeLog
 126
 127 来实现。
 128
 129 === 下载文件 ===
 130
 131 得到一个由Git管理的项目的拷贝，则键入：
 132
 133  $ git clone git://server/path/to/files
 134
 135 例如，得到我用来创建该站的所有文件：
 136
 137  $ git clone git://git.or.cz/gitmagic.git
 138
 139 我们很快会对 *clone* 命令谈的很多。
 140
 141 === 到最新 ===
 142
 143 如果你已经使用 *git clone* 命令得到了一个项目的一份拷贝，你可以更新到最新版，
 144 通过：
 145
 146  $ git pull
 147
 148
 149 === 快速发布 ===
 150
 151 假设你写了一个脚本，想和他人分享。你可以只告诉他们从你的计算机下载，但如果此
 152 时你正在改进你的脚本，或加入了试验性质的改动，他们下载了你的脚本，他们可能因
 153 此陷入困境。当然，这就是发布周期存在的原因。开发人员可能频繁进行项目修改，但
 154 他们只在他们觉得代码可以见人的时候才择时发布。
 155
 156 用Git来完成这项，需要进入你的脚本所在目录：
 157
 158  $ git init
 159  $ git add .
 160  $ git commit -m "First release"
 161
 162 然后告诉你的用户去运行：
 163
 164  $ git clone your.computer:/path/to/script
 165
 166 来下载你的脚本。这要假定他们有ssh访问权限。如果没有，需要运行 *git daemon* 并
 167 告诉你的用户去运行：
 168
 169  $ git clone git://your.computer/path/to/script
 170
 171 从现在开始，每次你的脚本准备好发布时，就运行：
 172
 173  $ git commit -a -m "Next release"
 174
 175 而你的用户则可以进入包含你脚本的目录，并键入下列命令，来更新他们的版本：
 176
 177  $ git pull
 178
 179 你的用户永远也不会取到你不想让他们看到的脚本版本。显然这个技巧对所有代码库都
 180 适用，而不仅仅局限于脚本。
 181
 182
 183 === 我们已经做了什么？ ===
 184
 185 找出自从上次提交之后你已经做了什么改变：
 186
 187  $ git diff
 188
 189 或者自昨天的改变：
 190
 191  $ git diff "@{yesterday}"
 192
 193 或者一个特定版本与倒数第二个变更之间：
 194
 195  $ git diff 1b6d "master~2"
 196
 197 输出结果都是补丁格式，可以用 *git apply* 来把补丁打上。也可以试一下：
 198
 199  $ git whatchanged --since="2 weeks ago"
 200
 201 我也经常用http://sourceforge.net/projects/qgit[qgit] 浏览历史, 因为他的图形界
 202 面很养眼，或者 http://jonas.nitro.dk/tig/[tig] ，一个文本界面的东西，很慢的网
 203 络状况下也可以工作的很好。也可以安装web 服务器，运行 *git instaweb* ，就可以用
 204 任意浏览器浏览了。
 205
 206 === 练习 ===
 207
 208 比方A，B，C，D是四个连续的提交，其中B与A一样，除了一些文件删除了。我们想把这
 209 些删除的文件加回D。我们如何做到这个呢？
 210
 211 至少有三个解决方案。假设我们在D：
 212
 213   1. A与B的差别是那些删除的文件。我们可以创建一个补丁代表这些差别，然后吧补丁
 214      打上：
 215
 216    $ git diff B A | git apply
 217
 218   2. 既然这些文件存在A，我们可以把它们拿出来：
 219
 220    $ git checkout A foo.c bar.h
 221
 222   3. 我们可以把从A到B的变化视为可撤销的变更：
 223
 224    $ git revert B
 225
 226 哪个选择最好？这取决于你的喜好。利用Git满足自己需求是容易，经常还有多个方法。