@git / git-reference / commits / 4e6a83d

zh version

Scott Chacon committed Apr 7, 2011 at 16:46 UTC 4e6a83d28d188463e9575328537b245c06fb6d77
11 files changed +2218
_layouts/zh_reference.html new
+106
@@ -0,0 +1,106 @@
1 +<!DOCTYPE html>
2 +<html>
3 + <head>
4 + <meta charset="utf-8" />
5 + <title>Git 参考手册</title>
6 + <link rel="stylesheet" type="text/css" href="/zh//css/reset.css" media="screen" />
7 + <link rel="stylesheet" type="text/css" href="/zh//css/text.css" media="screen" />
8 + <link rel="stylesheet" type="text/css" href="/zh//css/grid.css" media="screen" />
9 + <link rel="stylesheet" type="text/css" href="/zh//css/layout.css" media="screen" />
10 + <link rel="stylesheet" type="text/css" href="/zh//css/nav.css" media="screen" />
11 + <!--[if IE 6]><link rel="stylesheet" type="text/css" href="/zh//css/ie6.css" media="screen" /><![endif]-->
12 + <!--[if IE 7]><link rel="stylesheet" type="text/css" href="/zh//css/ie.css" media="screen" /><![endif]-->
13 + <script type="text/javascript" src="/js/jquery-1.4.1.min.js"></script>
14 + <script type="text/javascript" src="/js/jquery-ui.min.js"></script>
15 + <script type="text/javascript" src="/js/action.js"></script>
16 + </head>
17 + <body>
18 + <div class="container_12">
19 +
20 + <div class="grid_12">
21 + <span id="branding">Git 参考手册</span>
22 + </div>
23 +
24 + <div class="grid_12">
25 + <ul id="menu">
26 + <li><a id="menu_home" href="/zh/index.html">参考手册</a></li>
27 + <!-- <li><a id="menu_cookbook" href="/zh//cookbook.html">Cookbook</a></li> -->
28 + <li><a id="menu_about" href="/zh/about.html">关于</a></li>
29 + <li>&#167;</li>
30 + <li><a href="/zh/http://github.com/dotnil/git-reference">网站源码</a></li>
31 + </ul>
32 + <br/>
33 + &nbsp;
34 + </div>
35 +
36 + <div class="grid_2" id="reflist">
37 + <div class="block">
38 + <h3><a href="/zh/creating">获取与创建项目</a></h3>
39 + <ul>
40 + <li><a href="/zh/creating/#init">init</a></li>
41 + <li><a href="/zh/creating/#clone">clone</a></li>
42 + </ul>
43 + </div>
44 +
45 + <div class="block">
46 + <h3><a href="/zh/basic">基本的快照</a></h3>
47 + <ul>
48 + <li><a href="/zh/basic/#add">add</a></li>
49 + <li><a href="/zh/basic/#status">status</a></li>
50 + <li><a href="/zh/basic/#diff">diff</a></li>
51 + <li><a href="/zh/basic/#commit">commit</a></li>
52 + <li><a href="/zh/basic/#reset">reset</a></li>
53 + <li><a href="/zh/basic/#rm-mv">rm, mv</a></li>
54 + </ul>
55 + </div>
56 +
57 + <div class="block">
58 + <h3><a href="/zh/branching">分支与合并</a></h3>
59 + <ul>
60 + <li><a href="/zh/branching/#branch">branch</a></li>
61 + <li><a href="/zh/branching/#branch">checkout</a></li>
62 + <li><a href="/zh/branching/#merge">merge</a></li>
63 + <li><a href="/zh/branching/#log">log</a></li>
64 + <li><a href="/zh/branching/#tag">tag</a></li>
65 + </ul>
66 + </div>
67 +
68 + <div class="block">
69 + <h3><a href="/zh/remotes">分享与更新项目</a></h3>
70 + <ul>
71 + <li><a href="/zh/remotes/#fetch">fetch, pull</a></li>
72 + <li><a href="/zh/remotes/#push">push</a></li>
73 + <li><a href="/zh/remotes/#remote">remote</a></li>
74 + </ul>
75 + </div>
76 +
77 + <div class="block">
78 + <h3><a href="/zh/inspect">检查与比较</a></h3>
79 + <ul>
80 + <li><a href="/zh/inspect/#log">log</a></li>
81 + <li><a href="/zh/inspect/#diff">diff</a></li>
82 + </ul>
83 + </div>
84 +
85 + <!--
86 + <div class="block">
87 + <h3><a href="/zh//fixing">Fixing and Changing History</a></h3>
88 + <ul>
89 + <li><a href="/zh//fixing/rebase.html">rebase</a></li>
90 + <li><a href="/zh//fixing/revert.html">revert</a></li>
91 + <li><a href="/zh//fixing/checkout.html">checkout</a></li>
92 + <li><a href="/zh//fixing/reset.html">reset</a></li>
93 + <li><a href="/zh//fixing/cherry-pick.html">cherry-pick</a></li>
94 + </ul>
95 + </div>
96 + -->
97 + </div>
98 +
99 + <div class="grid_10 home_box" id="content_box">
100 + {{ content }}
101 + </div>
102 +
103 + <div class="clear"></div>
104 + </div>
105 + </body>
106 +</html>
zh/.gitignore new
+2
@@ -0,0 +1,2 @@
1 +_site
2 +*~
zh/about.html new
+8
@@ -0,0 +1,8 @@
1 +---
2 +layout: zh_reference
3 +---
4 +<div class="box">
5 + <h2>谁的作品?</h2>
6 + <br/>
7 + <p>Git 参考手册是 Github 项目组的成果。<a href="http://cyj.me">逸才</a>在 <a href="http://gitref.org">Git Reference</a> 的基础上做了中文翻译。</p>
8 +</div>
zh/basic/index.html new
+586
@@ -0,0 +1,586 @@
1 +---
2 +layout: zh_reference
3 +---
4 +
5 +<div class="box">
6 + <h2>
7 + <span class="docs">
8 + <a target="new" href="http://progit.org/book/ch2-2.html">书</a>
9 + </span>
10 + 基本的快照
11 + </h2>
12 + <div class="block">
13 + <p>
14 + Git 的所有工作就是创建与保存您的项目的快照以及之后的快照对比等工作。本章将对有关创建与提交您的项目的快照的命令作介绍。
15 + </p>
16 +
17 + <p>
18 + 这里有个重要的概念,Git 有一个叫做“索引”的东东,有点像是您的快照的缓存区。这就使您能够从更改的文件中创建出一系列组织良好的快照,而不是一次提交所有的更改。
19 + </p>
20 +
21 + <p class="nutshell">
22 + <strong>一言以蔽之</strong>,使用 <code>git add</code> 添加需要追踪的新文件和待提交的更改,然后使用 <code>git status</code> 和 <code>git diff</code> 查看有何改动,最后用 <code>git commit</code> 将您的快照记录。这就是您要用的基本流程,绝大部分时候都是这样的。
23 + </p>
24 +
25 + </div>
26 +</div>
27 +
28 +<div class="box">
29 + <h2>
30 + <span class="docs">
31 + <a target="new" href="http://www.kernel.org/pub/software/scm/git/docs/git-add.html">文档</a> &nbsp;
32 + <a target="new" href="http://progit.org/book/ch2-2.html#tracking_new_files">书</a>
33 + </span>
34 + <a name="add">git add</a>
35 + <span class="desc">添加文件到缓存</span>
36 + </h2>
37 +
38 + <div class="block">
39 + <p>
40 + 在 Git 中,在提交您修改的文件之前,您需要把它们添加到缓存。如果该文件是新的,您可以执行 <code>git add</code> 将该文件添加到缓存,但是,即使该文件已经被追踪了 —— 也就是说,曾经提交过了 —— 你仍然需要执行 <cpde>git add</code> 将新更改的文件添加到缓存去。让我们看几个例子:
41 + </p>
42 +
43 + <p>回到我们的 Hello World 示例,初始化该项目之后,我们就要用 <code>git add</code> 将我们的文件添加进去了。我们可以用 <code>git status</code> 看看我们的项目的当前状态。
44 + </p>
45 +
46 +<pre>
47 +<b>$ git status -s</b>
48 +<span class="red">??</span> README
49 +<span class="red">??</span> hello.rb
50 +</pre>
51 +
52 + 我们有俩尚未被追踪的文件,得添加一下。
53 +
54 +<pre>
55 +<b>$ git add README hello.rb</b>
56 +</pre>
57 +
58 + 现在我们再执行 <code>git status</code>,就可以看到这俩文件已经加上去了。
59 +
60 +<pre>
61 +<b>$ git status -s</b>
62 +<span class="green">A</span> README
63 +<span class="green">A</span> hello.rb
64 +</pre>
65 +
66 + <p class="aside">
67 + 新项目中,添加所有文件很普遍,可以在当前工作目录执行命令:<code>git add .</code>。因为 Git 会递归地将您执行命令时所在的目录中的所有文件添加上去,所以如果你将当前的工作目录作为参数,它就会追踪那儿的所有文件了。如此,<code>git add .</code> 就和 <code>git add README hello.rb</code> 有一样的效果。此外,效果一致的还有 <code>git add *</code>,不过那只是因为我们这还木有子目录,不需要递归地添加新文件。
68 + </p>
69 +
70 + <p>好了,现在我们改个文件,再跑一下 <code>git status</code>,有点古怪。</p>
71 +<pre>
72 +<b>$ vim README</b>
73 +<b>$ git status -s</b>
74 +<span class="green">A</span><span class="red">M</span> README
75 +<span class="green">A</span> hello.rb
76 +</pre>
77 +
78 + <p>
79 + “AM” 状态的意思是,这个文件在我们将它添加到缓存之后又有改动。这意味着如果我们现在提交快照,我们记录的将是上次跑 <code>git add</code> 的时候的文件版本,而不是现在在磁盘中的这个。Git 并不认为磁盘中的文件与您想快照的文件必须是一致的 —— (如果您需要它们一致,)得用 <code>git add</code> 命令告诉它。
80 + </p>
81 +
82 + <p class="nutshell">
83 + <strong>一言以蔽之</strong>,
84 + 当您要将您的修改包含在即将提交的快照里的时候,执行 <code>git add</code>。任何您没有添加的改动都不会被包含在内 —— 这意味着您可以比绝大多数其他源代码版本控制系统更精确地归置您的快照。
85 + </p>
86 +
87 + <p>请查看《Pro Git》中 <code>git add</code> 的 “-p” 参数,以了解更多关于提交文件的灵活性的例子。
88 + </p>
89 +
90 + </div>
91 +
92 +</div>
93 +
94 +<div class="box">
95 + <h2>
96 + <span class="docs">
97 + <a target="new" href="http://www.kernel.org/pub/software/scm/git/docs/git-status.html">文档</a> &nbsp;
98 + <a target="new" href="http://progit.org/book/ch2-2.html#checking_the_status_of_your_files">书</a>
99 + </span>
100 + <a name="status">git status</a>
101 + <span class="desc">查看您的文件在工作目录与缓存的状态</span>
102 + </h2>
103 +
104 + <div class="block">
105 + <p>正如您在 <code>git add</code> 小节中所看到的,您可以执行 <code>git status</code> 命令查看您的代码在缓存与当前工作目录的状态。我演示该命令的时候加了 <code>-s</code> 参数,以获得简短的结果输出。若没有这个标记,命令 <code>git status</code> 将告诉您更多的提示与上下文欣喜。以下便是同样状态下,有跟没有 <code>-s</code> 参数的输出对比。简短的输出如下:
106 + </p>
107 +
108 +<pre>
109 +<b>$ git status -s</b>
110 +<span class="green">A</span><span class="red">M</span> README
111 +<span class="green">A</span> hello.rb
112 +</pre>
113 +
114 + 而同样的状态,详细的输出看起来是这样的:
115 +
116 +<pre>
117 +<b>$ git status</b>
118 +# On branch master
119 +#
120 +# Initial commit
121 +#
122 +# Changes to be committed:
123 +# (use "git rm --cached <file>..." to unstage)
124 +#
125 +# <span class="green">new file: README</span>
126 +# <span class="green">new file: hello.rb</span>
127 +#
128 +# Changed but not updated:
129 +# (use "git add <file>..." to update what will be committed)
130 +# (use "git checkout -- <file>..." to discard changes in working directory)
131 +#
132 +# <span class="red">modified: README</span>
133 +#
134 +</pre>
135 +
136 + <p>您很容易发现简短的输出看起来很紧凑。而详细输出则很有帮助,提示您可以用何种命令完成您接下来可能要做的事情。
137 + </p>
138 +
139 + <p>Git 还会告诉您在您上次提交之后,有哪些文件被删除、修改或者存入缓存了。</p>
140 +
141 +<pre>
142 +<b>$ git status -s</b>
143 +<span class="green">M</span> README
144 + <span class="red">D</span> hello.rb
145 +</pre>
146 +
147 + 您可以看到,在简短输出中,有两栏。第一栏是缓存的,第二栏则是工作目录的。所以假设您临时提交了 README 文件,然后又改了些,并且没有执行 <code>git add</code>,您会看到这个:
148 +
149 +<pre>
150 +<b>$ git status -s</b>
151 +<span class="green">M</span><span class="red">M</span> README
152 + <span class="red">D</span> hello.rb
153 +</pre>
154 +
155 + <p class="nutshell">
156 + <strong>一言以蔽之</strong>,执行 <code>git status</code> 以查看在您上次提交之后有啥被修改或者临时提交了,从而决定自己是否需要提交一次快照,同时也能知道有什么改变被记录进去了。
157 + </p>
158 +
159 + </div>
160 +</div>
161 +
162 +<div class="box">
163 + <h2>
164 + <span class="docs">
165 + <a target="new" href="http://www.kernel.org/pub/software/scm/git/docs/git-diff.html">文档</a> &nbsp;
166 + <a target="new" href="http://progit.org/book/ch2-2.html#viewing_your_staged_and_unstaged_changes">书</a>
167 + </span>
168 + <a name="diff">git diff</a>
169 + <span class="desc">显示已写入缓存与已修改但尚未写入缓存的改动的区别</span>
170 + </h2>
171 +
172 + <div class="block">
173 + <p><code>git diff</code> 有两个主要的应用场景。我们将在此介绍其一,在 <a href="/inspect">检阅与对照</a> 一章中,我们将介绍其二。我们这里介绍的方式是用此命令描述已临时提交的或者已修改但尚未提交的改动。
174 + </p>
175 +
176 + <h4>
177 + git diff
178 + <small>#尚未缓存的改动</small>
179 + </h4>
180 +
181 + <p>如果没有其他参数,<code>git diff</code> 会以规范化的 diff 格式(一个补丁)显示自从您上次提交快照之后尚未缓存的所有更改。
182 + </p>
183 +
184 +<pre>
185 +<b>$ vim hello.rb</b>
186 +<b>$ git status -s</b>
187 + <span class="red">M</span> hello.rb
188 +<b>$ git diff</b>
189 +<span class="umber">diff --git a/hello.rb b/hello.rb
190 +index d62ac43..8d15d50 100644
191 +--- a/hello.rb
192 ++++ b/hello.rb</span>
193 +<span class="lblue">@@ -1,7 +1,7 @@</span>
194 + class HelloWorld
195 +
196 + def self.hello
197 +<span class="red">- puts "hello world"</span>
198 +<span class="green">+ puts "hola mundo"</span>
199 + end
200 +
201 + end
202 +</pre>
203 +
204 + <p>所以,<code>git status</code>显示您上次提交更新至后所更改或者写入缓存的改动,而 <code>git diff</code> 一行一行地显示这些改动具体是啥。通常执行完 <code>git status</code> 之后接着跑一下 <code>git diff</code> 是个好习惯。
205 + </p>
206 +
207 + <h4>
208 + git diff --cached
209 + <small>#查看已缓存的改动</small>
210 + </h4>
211 +
212 + <p><code>git diff --cached</code> 命令会告诉您有哪些内容已经写入缓存了。也就是说,此命令显示的是接下来要写入快照的内容。所以,如果您将上述示例中的 <code>hello.rb</code> 写入缓存,因为 <code>git diff</code> 显示的是尚未缓存的改动,所以在此执行它不会显示任何信息。
213 + </p>
214 +
215 +<pre>
216 +<b>$ git status -s</b>
217 + <span class="red">M</span> hello.rb
218 +<b>$ git add hello.rb </b>
219 +<b>$ git status -s</b>
220 +<span class="green">M</span> hello.rb
221 +<b>$ git diff</b>
222 +<b>$ </b>
223 +</pre>
224 +
225 + <p>如果您想看看已缓存的改动,您需要执行的是
226 + <code>git diff --cached</code>。</p>
227 +
228 +<pre>
229 +<b>$ git status -s</b>
230 +<span class="green">M</span> hello.rb
231 +<b>$ git diff</b>
232 +<b>$ </b>
233 +<b>$ git diff --cached</b>
234 +<span class="umber">diff --git a/hello.rb b/hello.rb
235 +index d62ac43..8d15d50 100644
236 +--- a/hello.rb
237 ++++ b/hello.rb</span>
238 +<span class="lblue">@@ -1,7 +1,7 @@</span>
239 + class HelloWorld
240 +
241 + def self.hello
242 +<span class="red">- puts "hello world"</span>
243 +<span class="green">+ puts "hola mundo"</span>
244 + end
245 +
246 + end
247 +</pre>
248 +
249 + <h4>
250 + git diff HEAD
251 + <small>查看已缓存的与未缓存的所有改动</small>
252 + </h4>
253 +
254 + <p>如果您想一并查看已缓存的与未缓存的改动,可以执行 <code>git diff HEAD</code> ——也就是说您要看到的是工作目录与上一次提交的更新的区别,无视缓存。假设我们又改了些 <code>ruby.rb</code> 的内容,那缓存的与未缓存的改动我们就都有了。以上三个 <code>diff</code> 命令的结果如下:
255 + </p>
256 +<pre>
257 +<b>$ vim hello.rb </b>
258 +<b>$ git diff</b>
259 +<span class="umber">diff --git a/hello.rb b/hello.rb
260 +index 4f40006..2ae9ba4 100644
261 +--- a/hello.rb
262 ++++ b/hello.rb</span>
263 +<span class="lblue">@@ -1,7 +1,7 @@</span>
264 + class HelloWorld
265 +
266 +<span class="green">+ # says hello</span>
267 + def self.hello
268 + puts "hola mundo"
269 + end
270 +
271 + end
272 +<b>$ git diff --cached</b>
273 +<span class="umber">diff --git a/hello.rb b/hello.rb
274 +index 2aabb6e..4f40006 100644
275 +--- a/hello.rb
276 ++++ b/hello.rb</span>
277 +<span class="lblue">@@ -1,7 +1,7 @@</span>
278 + class HelloWorld
279 +
280 + def self.hello
281 +<span class="red">- puts "hello world"</span>
282 +<span class="green">+ puts "hola mundo"</span>
283 + end
284 +
285 + end
286 +<b>$ git diff HEAD</b>
287 +<span class="umber">diff --git a/hello.rb b/hello.rb
288 +index 2aabb6e..2ae9ba4 100644
289 +--- a/hello.rb
290 ++++ b/hello.rb</span>
291 +<span class="lblue">@@ -1,7 +1,8 @@</span>
292 + class HelloWorld
293 +
294 +<span class="green">+ # says hello</span>
295 + def self.hello
296 +<span class="red">- puts "hello world"</span>
297 +<span class="green">+ puts "hola mundo"</span>
298 + end
299 +
300 + end
301 +</pre>
302 +
303 + <h4>
304 + git diff --stat
305 + <small>显示摘要而非整个 diff</small>
306 + </h4>
307 +
308 + <p>如果我们不想要看整个 diff 输出,但是又想比 <code>git status</code> 详细点,就可以用 <code>--stat</code> 选项。该选项使它显示摘要而非全文。上文示例在使用 <code>--stat</code> 选项时,输出如下:
309 + </p>
310 +
311 +<pre>
312 +<b>$ git status -s</b>
313 +<span class="green">M</span><span class="red">M</span> hello.rb
314 +<b>$ git diff --stat</b>
315 + hello.rb | 1 <span class="green">+</span>
316 + 1 files changed, 1 insertions(+), 0 deletions(-)
317 +<b>$ git diff --cached --stat</b>
318 + hello.rb | 2 <span class="green">+</span><span class="red">-</span>
319 + 1 files changed, 1 insertions(+), 1 deletions(-)
320 +<b>$ git diff HEAD --stat</b>
321 + hello.rb | 3 <span class="green">++</span><span class="red">-</span>
322 + 1 files changed, 2 insertions(+), 1 deletions(-)
323 +</pre>
324 +
325 + <p>您还可以在上述命令后面制定一个目录,从而只查看特定文件或子目录的 <code>diff</code> 输出。
326 + </p>
327 +
328 +
329 + <p class="nutshell">
330 + <strong>一言以蔽之</strong>,
331 + 执行 <code>git diff</code> 来查看执行 <code>git status</code> 的结果的详细信息 —— 一行一行地显示这些文件是如何被修改或写入缓存的。
332 + </p>
333 +
334 + </div>
335 +</div>
336 +
337 +<div class="box">
338 + <h2>
339 + <span class="docs">
340 + <a target="new" href="http://www.kernel.org/pub/software/scm/git/docs/git-commit.html">文档</a> &nbsp;
341 + <a target="new" href="http://progit.org/book/ch2-2.html#committing_your_changes">书</a>
342 + </span>
343 + <a name="commit">git commit</a>
344 + <span class="desc">记录缓存内容的快照</span>
345 + </h2>
346 +
347 + <div class="block">
348 +
349 + <p>现在您使用 <code>git add</code> 命令将想要快照的内容写入了缓存,执行 <code> git commit</code> 就将它实际存储快照了。Git 为您的每一个提交都记录您的名字与电子邮箱地址,所以第一步是告诉 Git 这些都是啥。
350 + </p>
351 +
352 +<pre>
353 +<b>$ git config --global user.name 'Your Name'</b>
354 +<b>$ git config --global user.email you@somedomain.com</b>
355 +</pre>
356 +
357 + <p>让我们写入缓存,并提交对 <code>hello.rb</code> 的所有改动。在首个例子中,我们使用 <code>-m</code> 选项以在命令行中提供提交注释。
358 + </p>
359 +
360 +<pre>
361 +<b>$ git add hello.rb </b>
362 +<b>$ git status -s</b>
363 +<span class="green">M</span> hello.rb
364 +<b>$ git commit -m 'my hola mundo changes'</b>
365 +[master 68aa034] my hola mundo changes
366 + 1 files changed, 2 insertions(+), 1 deletions(-)
367 +</pre>
368 +
369 + <p>现在我们已经记录了快照。如果我们再执行 <code>git status</code>,会看到我们有一个“干净的工作目录”。这意味着我们在最近一次提交之后,没有做任何改动 —— 在我们的项目中没有未快照的工作。
370 + </p>
371 +
372 +<pre>
373 +<b>$ git status</b>
374 +# On branch master
375 +nothing to commit (working directory clean)
376 +</pre>
377 +
378 + <p>如果您漏掉了 <code>-m</code> 选项,Git 会尝试为您打开一个编辑器以填写提交信息。如果 Git 在您对它的配置中找不到相关信息,默认会打开 <code>vim</code>。屏幕会像这样:
379 + </p>
380 +
381 +<pre>
382 +
383 +# Please enter the commit message for your changes. Lines starting
384 +# with '#' will be ignored, and an empty message aborts the commit.
385 +# On branch master
386 +# Changes to be committed:
387 +# (use "git reset HEAD <file>..." to unstage)
388 +#
389 +# modified: hello.rb
390 +#
391 +~
392 +~
393 +".git/COMMIT_EDITMSG" 9L, 257C
394 +</pre>
395 +
396 + <p>在此,您在文件头部添加实际的提交信息。以“#”开头的行都会被无视 ——Git 将 <code> git status</code> 的输出结果放在那儿以提示您都改了、缓存了啥。
397 + </p>
398 +
399 + <p>通常,撰写良好的提交信息是很重要的。以开放源代码项目为例,多多少少以以下格式写您的提示消息是个不成文的规定:
400 + </p>
401 +
402 +<pre>
403 +简短的关于改动的总结(25个字或者更少)
404 +
405 +如果有必要,更详细的解释文字。约 36 字时换行。在某些情况下,
406 +第一行会被作为电子邮件的开头,而剩余的则会作为邮件内容。
407 +将小结从内容隔开的空行是至关重要的(除非你没有内容);
408 +如果这两个待在一起,有些 git 工具会犯迷糊。
409 +
410 +空行之后是更多的段落。
411 +
412 + - 列表也可以
413 +
414 + - 通常使用连字符(-)或者星号(*)来标记列表,前面有个空格,
415 + 在列表项之间有空行,不过这些约定也会有些变化。
416 +
417 +# Please enter the commit message for your changes. Lines starting
418 +# with '#' will be ignored, and an empty message aborts the commit.
419 +# On branch master
420 +# Changes to be committed:
421 +# (use "git reset HEAD <file>..." to unstage)
422 +#
423 +# modified: hello.rb
424 +#
425 +~
426 +~
427 +~
428 +".git/COMMIT_EDITMSG" 25L, 884C written
429 +</pre>
430 +
431 + <p class="aside">
432 + 提交注解是很重要的。因为 Git 很大一部分能耐就是它在组织本地提交和与他人分享的弹性,它很给力地能够让您为逻辑独立的改变写三到四条提交注解,以便您的工作被同仁审阅。因为提交与推送改动是有区别的,请务必花时间将各个逻辑独立的改动放到另外一个提交,并附上一份良好的提交注解,以使与您合作的人能够方便地了解您所做的,以及您为何要这么做。
433 + </p>
434 +
435 + <h4>
436 + git commit -a
437 + <small>自动将在提交前将已记录、修改的文件放入缓存区</small>
438 + </h4>
439 +
440 + <p>如果您觉得 <code>git add</code> 提交缓存的流程太过繁琐,Git 也允许您用 <code>-a</code> 选项跳过这一步。基本上这句话的意思就是,为任何已有记录的文件执行 <code>git add</code> —— 也就是说,任何在您最近的提交中已经存在,并且之后被修改的文件。这让您能够用更 Subversion 方式的流程,修改些文件,然后想要快照所有所做的改动的时候执行 <code>git commit -a</code>。不过您仍然需要执行 <code>git add</code> 来添加新文件,就像 Subversion 一样。
441 + </p>
442 +
443 +<pre>
444 +<b>$ vim hello.rb</b>
445 +<b>$ git status -s</b>
446 + <span class="red">M</span> hello.rb
447 +<b>$ git commit -m 'changes to hello file'</b>
448 +# On branch master
449 +# Changed but not updated:
450 +# (use "git add <file>..." to update what will be committed)
451 +# (use "git checkout -- <file>..." to discard changes in working directory)
452 +#
453 +# modified: hello.rb
454 +#
455 +<span class="hl">no changes added to commit (use "git add" and/or "git commit -a")</span>
456 +<b>$ git commit -am 'changes to hello file'</b>
457 +[master 78b2670] changes to hello file
458 + 1 files changed, 2 insertions(+), 1 deletions(-)
459 +</pre>
460 +
461 + <p>注意,如果您如果您不缓存改动,直接执行 <code>git commit</code>,Git 会直接给出 <code>git status</code> 命令的输出,提醒您啥也没缓存。我已将该消息中的重要部分高亮,它说没有添加需要提交的缓存。如果您使用 <code>-a</code>,它会缓存并提交每个改动(不含新文件)。
462 + </p>
463 +
464 + <p>
465 + 现在您就完成了整个快照的流程 ——改些文件,然后用 <code>git add</code> 将要提交的改动提交到缓存,用 <code>git status</code> 和 <code>git diff</code> 看看您都改了啥,最后 <code>git commit</code> 永久地保存快照。
466 + </p>
467 +
468 + <p class="nutshell">
469 + <strong>一言以蔽之</strong>,执行 <code>git commit</code> 记录缓存区的快照。这个快照就可以用来做比较、分享以及,如果需要,恢复。
470 + </p>
471 +
472 + </div>
473 +</div>
474 +
475 +<div class="box">
476 + <h2>
477 + <span class="docs">
478 + <a target="new" href="http://www.kernel.org/pub/software/scm/git/docs/git-reset.html">文档</a> &nbsp;
479 + <a target="new" href="http://progit.org/book/ch2-4.html#unstaging_a_staged_file">书</a>
480 + </span>
481 + <a name="reset">git reset HEAD</a>
482 + <span class="desc">取消缓存已缓存的内容</span>
483 + </h2>
484 +
485 + <div class="block">
486 + <p><code>git reset</code> 可能是人类写的最费解的命令了。我用 Git 有些年头了,甚至还写了本书,但有的时候还是会搞不清它会做什么。所以,我只说三个明确的,通常有用的调用。请您跟我一样尽管用它 —— 因为它可以很有用。
487 + </p>
488 +
489 + <p>在此例中,我们可以用它来将不小心缓存的东东取消缓存。假设您修改了两个文件,想要将它们记录到两个不同的提交中去。您应该缓存并提交一个,再缓存并提交另外一个。如果您不小心两个都缓存了,那要如何才能<i>取消</i>缓存呢?您可以用 <code>git reset HEAD -- file</code>。技术上说,在这里您不需要使用 <code>--</code> —— 它用来告诉 Git 这时您已经不再列选项,剩下的是文件路径了。不过养成使用它分隔选项与路径的习惯很重要,即使在您可能并不需要的时候。
490 + </p>
491 +
492 + <p>好,让我们看看取消缓存是什么样子的。这里我们有两个最近提交之后又有所改动的文件。我们将两个都缓存,并取消缓存其中一个。
493 + </p>
494 +
495 +<pre>
496 +<b>$ git status -s</b>
497 + <span class="red">M</span> README
498 + <span class="red">M</span> hello.rb
499 +<b>$ git add .</b>
500 +<b>$ git status -s</b>
501 +<span class="green">M</span> README
502 +<span class="green">M</span> hello.rb
503 +<b>$ git reset HEAD -- hello.rb </b>
504 +Unstaged changes after reset:
505 +M hello.rb
506 +<b>$ git status -s</b>
507 +<span class="green">M</span> README
508 + <span class="red">M</span> hello.rb
509 +</pre>
510 +
511 + <p>
512 + 现在您执行 <code>git commit</code> 将只记录 <code>README</code> 文件的改动,并不含现在并不在缓存中的 <code>hello.rb</code>。
513 + </p>
514 +
515 + <p class="aside">
516 + 如果您好奇,它实际的操作是将该文件在“索引”中的校验和重置为最近一次提交中的值。<code>git add</code> 会计算一个文件的校验和,将它添加到“索引”中,而 <code>git reset HEAD</code> 将它改写回原先的,从而取消缓存。
517 + </p>
518 +
519 + <p class="tip">
520 + 如果您想直接执行 <code>git unstage</code>,您可以在 Git 中配置个别名。执行 <code>git config --global alias.unstage "reset HEAD"</code> 即可。一旦执行完它,您就可以直接用 <code>git unstage [file]</code> 作为代替了。
521 + </p>
522 +
523 + <p>如果您忘了取消缓存的命令,Git 的常规 <code>git status</code> 输出的提示会很有帮助。例如,在您有已缓存的文件时,如果您不带 <code>-s</code> 执行 <code>git status</code>,它将告诉您怎样取消缓存:
524 + </p>
525 +
526 +<pre>
527 +<b>$ git status</b>
528 +# On branch master
529 +# Changes to be committed:
530 +# <span class="hl">(use "git reset HEAD <file>..." to unstage)</span>
531 +#
532 +# <span class="green">modified: README</span>
533 +# <span class="green">modified: hello.rb</span>
534 +#
535 +</pre>
536 +
537 + <p class="nutshell">
538 + <strong>一言以蔽之</strong>,执行 <code>git reset HEAD</code> 以取消之前 <code>git add</code> 添加,但不希望包含在下一提交快照中的缓存。
539 + </p>
540 +
541 + </div>
542 +</div>
543 +
544 +<div class="box">
545 + <h2>
546 + <span class="docs">
547 + <a href="http://www.kernel.org/pub/software/scm/git/docs/git-rm.html">文档</a> &nbsp;
548 + <a href="http://progit.org/book/ch2-2.html#removing_files">书</a>
549 + </span>
550 + <a name="rm-mv">git rm</a>
551 + <span class="desc">将文件从缓存区移除</span>
552 + </h2>
553 +
554 + <div class="block">
555 +
556 + <p>
557 + <code>git rm</code> 会将条目从缓存区中移除。这与 <code>git reset HEAD</code> 将条目取消缓存是有区别的。“取消缓存”的意思就是将缓存区恢复为我们做出修改之前的样子。在另一方面,<code>git rm</code> 则将该文件彻底从缓存区踢出,因此它不再下一个提交快照之内,进而有效地删除它。
558 + </p>
559 +
560 + <p>
561 + 默认情况下,<code>git rm file</code> 会将文件从缓存区和您的硬盘中(工作目录)删除。如果要在工作目录中留着该文件,可以使用 <code>git rm --cached</code>
562 + </p>
563 +
564 + <h4>
565 + git mv
566 + <small>git rm --cached orig; mv orig new; git add new</small>
567 + </h4>
568 +
569 + <p>
570 + 不像绝大多数其他版本控制系统,Git 并不记录记录文件重命名。它反而只记录快照,并对比快照以找到有啥文件可能被重命名了。如果一个文件从更新中删除了,而在下次快照中新添加的另一个文件的内容与它很相似,Git 就知道这极有可能是个重命名。因此,虽然有 <code>git mv</code> 命令,但它有点多余 —— 它做得所有事情就是 <code>git rm --cached</code>,重命名磁盘上的文件,然后再执行 <code>git add</code> 把新文件添加到缓存区。您并不需要用它,不过如果觉得这样容易些,尽管用吧。
571 + </p>
572 +
573 + <p class="aside">
574 + 我自己不会用此命令的普通形式 —— 删除文件。通常直接从硬盘删除文件,然后执行 <code>git commit -a</code> 会简单些。它会自动将删除的文件从索引中移除。
575 + </p>
576 +
577 + <p class="nutshell">
578 + <strong>一言以蔽之</strong>,
579 + 执行 <code>git rm</code> 来删除 Git 追踪的文件。它还会删除您的工作目录中的相应文件。
580 + </p>
581 +
582 + </div>
583 +</div>
584 +
585 +<p><a href="/zh/branching">到 分支与合并 &#187;</a></p>
586 +
zh/branching/index.html new
+630
@@ -0,0 +1,630 @@
1 +---
2 +layout: zh_reference
3 +---
4 +
5 +<div class="box">
6 + <h2>
7 + <span class="docs">
8 + <a target="new" href="http://progit.org/book/ch3-0.html">书</a>
9 + </span>
10 + 分支与合并
11 + </h2>
12 + <div class="block">
13 + <p>分支是我最喜欢的 Git 特性之一。如果您用过其他版本控制系统,把您所知的分支给忘记,倒可能更有帮助些 —— 事实上,以我们使用分支的方式,把 Git 的分支看作 <i>上下文</i> 反而更合适。当您检出分支时,您可以在两三个不同的分支之间来回切换。
14 + </p>
15 +
16 + <p class="nutshell">
17 + <b>一言以蔽之</b>,您可以执行 <code>git branch (branchname)</code> 来创建分支,使用 <code>git checkout (branchname)</code> 命令切换到该分支,在该分支的上下文环境中,提交快照等,之后可以很容易地来回切换。当您切换分支的时候,Git 会用该分支的最后提交的快照替换您的工作目录的内容,所以多个分支不需要多个目录。使用 <code>git merge</code> 来合并分支。您可以多次合并到统一分支,也可以选择在合并之后直接删除被并入的分支。
18 + </p>
19 +
20 + </div>
21 +</div>
22 +
23 +<div class="box">
24 + <h2>
25 + <span class="docs">
26 + <a target="new" href="http://www.kernel.org/pub/software/scm/git/docs/git-branch.html">文档</a> &nbsp;
27 + <a target="new" href="http://progit.org/book/ch3-2.html">书</a>
28 + </span>
29 + <a name="branch">git branch</a>
30 + <span class="desc">列出、创建与管理工作上下文</span>
31 + </h2>
32 +
33 + <br/>
34 +
35 + <h2>
36 + <span class="docs">
37 + <a target="new" href="http://www.kernel.org/pub/software/scm/git/docs/git-checkout.html">文档</a> &nbsp;
38 + <a target="new" href="http://progit.org/book/ch3-2.html">书</a>
39 + </span>
40 + <a name="checkout">git checkout</a>
41 + <span class="desc">切换到新的分支上下文</span>
42 + </h2>
43 +
44 + <div class="block">
45 + <p><code>git branch</code> 命令是 Git 中的通用分支管理工具,可以通过它完成多项任务。我们先说您会用到的最多的命令 —— 列出分支、创建分支和删除分支。我们还会介绍用来切换分支的 <code>git checkout</code> 命令。
46 + </p>
47 +
48 + <h4>
49 + git branch
50 + <small>列出可用的分支</small>
51 + </h4>
52 +
53 + <p>没有参数是,<code>git branch</code> 会列出您在本地的分支。您所在的分支的行首会有个星号作标记。如果您开启了<a href="http://progit.org/book/ch7-1.html#colors_in_git">彩色模式</a>,当前分支会用绿色显示。
54 + </p>
55 +
56 +<pre>
57 +$ git branch
58 +* <span class="green">master</span>
59 +</pre>
60 +
61 + <p>此例的意思就是,我们有一个叫做“master”的分支,并且该分支是当前分支。当您执行 <code>git init</code> 的时候,缺省情况下 Git 就会为您创建“master”分支。但是这名字一点特殊意味都没有 —— 事实上您并不非得要一个叫做“master”的分支。不过由于它是缺省分支名的缘故,绝大部分项目都有这个分支。
62 + </p>
63 +
64 + <h4>
65 + git branch (branchname)
66 + <small>创建新分支</small>
67 + </h4>
68 +
69 + <p>我们动手创建一个分支,并切换过去。执行 <code>git branch (branchname)</code> 即可。
70 +
71 +<pre>
72 +$ git branch testing
73 +$ git branch
74 +* <span class="green">master</span>
75 + testing
76 +</pre>
77 +
78 + <p>现在我们可以看到,有了一个新分支。当您以此方式在上次提交更新之后创建了新分支,如果后来又有更新提交,然后又切换到了“testing”分支,Git 将还原您的工作目录到您创建分支时候的样子 —— 您可以把它看作一个记录您当前进度的书签。让我们实际运用看看 —— 我们用 <code>git checkout (branch)</code> 切换到我们要修改的分支。
79 + </p>
80 +
81 +<pre>
82 +<b>$ ls</b>
83 +README hello.rb
84 +<b>$ echo 'test content' > test.txt</b>
85 +<b>$ echo 'more content' > more.txt</b>
86 +<b>$ git add *.txt</b>
87 +<b>$ git commit -m 'added two files'</b>
88 +[master 8bd6d8b] added two files
89 + 2 files changed, 2 insertions(+), 0 deletions(-)
90 + create mode 100644 more.txt
91 + create mode 100644 test.txt
92 +<b>$ ls</b>
93 +README hello.rb more.txt test.txt
94 +<b>$ git checkout testing</b>
95 +Switched to branch 'testing'
96 +<b>$ ls</b>
97 +README hello.rb
98 +</pre>
99 +
100 + <p>当我们切换到“测试”分支的时候,我们添加的新文件被移除了。切换回“master”分支的时候,它们有重新出现了。
101 + </p>
102 +
103 +<pre>
104 +<b>$ ls</b>
105 +README hello.rb
106 +<b>$ git checkout master</b>
107 +Switched to branch 'master'
108 +<b>$ ls</b>
109 +README hello.rb more.txt test.txt
110 +</pre>
111 +
112 + <h4>
113 + git checkout -b (branchname)
114 + <small>创建新分支,并立即切换到它</small>
115 + </h4>
116 +
117 + <p>
118 + 通常情况下,您会更希望立即切换到新分支,从而在该分支中操作,然后当此分支的开发日趋稳定时,将它合并到稳定版本的分支(例如“master”)中去。执行 <code>git branch newbranch; git checkout newbranch</code> 也很简单,不过 Git 还为您提供了快捷方式:<code>git checkout -b newbranch</code>。
119 + </p>
120 +
121 +<pre>
122 +<b>$ git branch</b>
123 +* master
124 +<b>$ ls</b>
125 +README hello.rb more.txt test.txt
126 +<b>$ git checkout -b removals</b>
127 +Switched to a new branch 'removals'
128 +<b>$ git rm more.txt </b>
129 +rm 'more.txt'
130 +<b>$ git rm test.txt </b>
131 +rm 'test.txt'
132 +<b>$ ls</b>
133 +README hello.rb
134 +<b>$ git commit -am 'removed useless files'</b>
135 +[removals 8f7c949] removed useless files
136 + 2 files changed, 0 insertions(+), 2 deletions(-)
137 + delete mode 100644 more.txt
138 + delete mode 100644 test.txt
139 +<b>$ git checkout master</b>
140 +Switched to branch 'master'
141 +<b>$ ls</b>
142 +README hello.rb more.txt test.txt
143 +</pre>
144 +
145 + <p>如您所见,我们创建了一个分支,在该分支的上下文中移除了一些文件,然后切换回我们的主分支,那些文件又回来了。使用分支将工作切分开来,从而让我们能够在不同上下文中做事,并来回切换。
146 + </p>
147 +
148 + <p>
149 + 创建新分支,在其中完成一部分工作,完成之后将它合并到主分支并删除。您会觉得这很方便,因为这么做很快很容易。如此,当您觉得这部分工作并不靠谱,舍弃它很容易。并且,如果您必须回到稳定分支做些事情,也可以很方便地这个独立分支的工作先丢在一边,完成要事之后再切换回来。
150 + </p>
151 +
152 + <h4>
153 + git branch -d (branchname)
154 + <small>删除分支</small>
155 + </h4>
156 +
157 + <p>假设我们要删除一个分支(比如上例中的“testing”分支,该分支没啥特殊的内容了),可以执行 <code>git branch -d (branch)</code> 把它删掉。
158 +
159 +<pre>
160 +<b>$ git branch</b>
161 +* <span class="green">master</span>
162 + testing
163 +<b>$ git branch -d testing</b>
164 +Deleted branch testing (was 78b2670).
165 +<b>$ git branch</b>
166 +* <span class="green">master</span>
167 +</pre>
168 +
169 + <p class="nutshell">
170 + <b>一言以蔽之</b> 使用 <code>git branch</code> 列出现有的分支、创建新分支以及删除不必要或者已合并的分支。
171 + </p>
172 +
173 + </div>
174 +</div>
175 +
176 +<div class="box">
177 + <h2>
178 + <span class="docs">
179 + <a target="new" href="http://www.kernel.org/pub/software/scm/git/docs/git-merge.html">docs</a> &nbsp;
180 + <a target="new" href="http://progit.org/book/ch3-2.html#basic_merging">book</a>
181 + </span>
182 + <a name="merge">git merge</a>
183 + <span class="desc">将分支合并到您的当前分支</span>
184 + </h2>
185 +
186 + <div class="block">
187 + <p>一旦某分支有了独立内容,您终究会希望将它合并回到您的主分支。您可以使用 <code>git merge</code> 命令将任何分支合并到当前分支中去。我们那上例中的“removals”分支为例。假设我们创建了一个分支,移除了一些文件,并将它提交到该分支,其实该分支是与我们的主分支(也就是“master”)独立开来的。要想将这些移除操作包含在主分支中,您可以将“removals”分支合并回去。
188 + </p>
189 +
190 +<pre>
191 +<b>$ git branch</b>
192 +* <span class="green">master</span>
193 + removals
194 +<b>$ ls</b>
195 +README hello.rb more.txt test.txt
196 +<b>$ git merge removals</b>
197 +Updating 8bd6d8b..8f7c949
198 +Fast-forward
199 + more.txt | 1 -
200 + test.txt | 1 -
201 + 2 files changed, 0 insertions(+), 2 deletions(-)
202 + delete mode 100644 more.txt
203 + delete mode 100644 test.txt
204 +<b>$ ls</b>
205 +<span class="hl">README hello.rb</span>
206 +</pre>
207 +
208 + <h4>
209 + 更多复杂合并
210 + </h4>
211 +
212 + <p>当然,合并并不仅仅是简单的文件添加、移除的操作,Git 也会合并修改 —— 事实上,它很会合并修改。举例,我们看看在某分支中编辑某个文件,然后在另一个分支中把它的名字改掉再做些修改,最后将这俩分支合并起来。您觉得会变成一坨 shi?我们试试看。
213 + </p>
214 +
215 +<pre>
216 +<b>$ git branch</b>
217 +* master
218 +<b>$ cat hello.rb </b>
219 +class HelloWorld
220 + def self.hello
221 + puts "Hello World"
222 + end
223 +end
224 +
225 +HelloWorld.hello
226 +</pre>
227 +
228 + <p>首先,我们创建一个叫做“change_class”的分支,切换过去,从而将重命名类等操作独立出来。我们将类名从 “HelloWorld” 改为 “HiWorld”。
229 + </p>
230 +
231 +<pre>
232 +<b>$ git checkout -b change_class</b>
233 +M hello.rb
234 +Switched to a new branch 'change_class'
235 +<b>$ vim hello.rb </b>
236 +<b>$ head -1 hello.rb </b>
237 +class HiWorld
238 +<b>$ git commit -am 'changed the class name'</b>
239 +[change_class 3467b0a] changed the class name
240 + 1 files changed, 2 insertions(+), 4 deletions(-)
241 +</pre>
242 +
243 + <p>然后,将重命名类操作提交到 “change_class” 分支中。现在,假如切换回 “master” 分支我们可以看到类名恢复到了我们切换到 “change_class” 分支之前的样子。现在,再做些修改(即代码中的输出),同时将文件名从 <code>hello.rb</code> 改为 <code>ruby.rb</code>。
244 +
245 +<pre>
246 +<b>$ git checkout master</b>
247 +Switched to branch 'master'
248 +<b>$ git mv hello.rb ruby.rb</b>
249 +<b>$ vim ruby.rb </b>
250 +<b>$ git diff</b>
251 +<span class="umber">diff --git a/ruby.rb b/ruby.rb
252 +index 2aabb6e..bf64b17 100644
253 +--- a/ruby.rb
254 ++++ b/ruby.rb</span>
255 +<span class="lblue">@@ -1,7 +1,7 @@</span>
256 + class HelloWorld
257 +
258 + def self.hello
259 +<span class="red">- puts "Hello World"</span>
260 +<span class="green">+ puts "Hello World from Ruby"</span>
261 + end
262 +
263 + end
264 +<b>$ git commit -am 'added from ruby'</b>
265 +[master b7ae93b] added from ruby
266 + 1 files changed, 1 insertions(+), 1 deletions(-)
267 + rename hello.rb => ruby.rb (65%)
268 +</pre>
269 +
270 + <p>现在这些改变已经记录到我的 “master” 分支了。请注意,这里类名还是 “HelloWorld”,而不是 “HiWorld”。然后我想将类名的改变合并过来,我把 “change_class” 分支合并过来就行了。但是,我已经将文件名都改掉了,Git 知道该怎么办么?
271 + </p>
272 +
273 +<pre>
274 +<b>$ git branch</b>
275 + change_class
276 +* master
277 +<b>$ git merge change_class</b>
278 +Renaming hello.rb => ruby.rb
279 +Auto-merging ruby.rb
280 +Merge made by recursive.
281 + ruby.rb | 6 ++----
282 + 1 files changed, 2 insertions(+), 4 deletions(-)
283 +<b>$ cat ruby.rb</b>
284 +class HiWorld
285 + def self.hello
286 + puts "Hello World from Ruby"
287 + end
288 +end
289 +
290 +HiWorld.hello
291 +</pre>
292 +
293 + <p>不错,它就是发现了。请注意,在这部操作,我没有遇到合并冲突,并且文件已经重命名、类名也换掉了。挺酷。
294 + </p>
295 +
296 + <h4>
297 + 合并冲突
298 + </h4>
299 +
300 + <p>那么,Git 合并很有魔力,我们再也不用处理合并冲突了,对吗?不太确切。不同分支中修改了相同区块的代码,电脑自己猜不透神马的情况下,冲突就摆在我们面前了。我们看看两个分支中改了同一行代码的例子。
301 + <p>
302 +
303 +<pre>
304 +<b>$ git branch</b>
305 +* master
306 +<b>$ git checkout -b fix_readme</b>
307 +Switched to a new branch 'fix_readme'
308 +<b>$ vim README </b>
309 +<b>$ git commit -am 'fixed readme title'</b>
310 +[fix_readme 3ac015d] fixed readme title
311 + 1 files changed, 1 insertions(+), 1 deletions(-)
312 +</pre>
313 +
314 + <p>我们在某分支中修改了 README 文件中的一行,并提交了。我们再在 “master” 分支中对同个文件的同一行内容作不同的修改。
315 + </p>
316 +
317 +<pre>
318 +<b>$ git checkout master</b>
319 +Switched to branch 'master'
320 +<b>$ vim README </b>
321 +<b>$ git commit -am 'fixed readme title differently'</b>
322 +[master 3cbb6aa] fixed readme title differently
323 + 1 files changed, 1 insertions(+), 1 deletions(-)
324 +</pre>
325 +
326 + <p>有意思的来了 —— 我们将前一个分支合并到 “master” 分支,一个合并冲突就出现了。
327 + </p>
328 +
329 +<pre>
330 +<b>$ git merge fix_readme</b>
331 +Auto-merging README
332 +CONFLICT (content): Merge conflict in README
333 +Automatic merge failed; fix conflicts and then commit the result.
334 +<b>$ cat README </b>
335 +<<<<<<< HEAD
336 +Many Hello World Examples
337 +=======
338 +Hello World Lang Examples
339 +>>>>>>> fix_readme
340 +
341 +This project has examples of hello world in
342 +nearly every programming language.
343 +</pre>
344 +
345 + <p>您可以看到,Git 在产生合并冲突的地方插入了标准的与 Subversion 很像的合并冲突标记。轮到我们去解决这些冲突了。在这里我们就手动把它解决。如果您要 Git 打开一个图形化的合并工具,可以看看 <a href="http://www.kernel.org/pub/software/scm/git/docs/git-mergetool.html">git 合并工具</a>(比如 kdiff3、emerge、p4merge 等)。
346 + </p>
347 +
348 +<pre>
349 +<b>$ vim README </b> <span class="exp">here I'm fixing the conflict</span>
350 +<b>$ git diff</b>
351 +<span class="umber">diff --cc README
352 +index 9103e27,69cad1a..0000000
353 +--- a/README
354 ++++ b/README</span>
355 +<span class="lblue">@@@ -1,4 -1,4 +1,4 @@@</span>
356 +<span class="red">- Many Hello World Examples</span>
357 + <span class="red">-Hello World Lang Examples</span>
358 +<span class="green">++Many Hello World Lang Examples</span>
359 +
360 + This project has examples of hello world in
361 +</pre>
362 +
363 + <p>在 Git 中,处理合并冲突的时候有个很酷的提示。如果您执行 <code>git diff</code>,就像我演示的这样,它会告诉您冲突的两方,和您是如何解决的。现在是时候把它标记为已解决了。在 Git 中,我们可以用 <code>git add</code> —— 要告诉 Git 文件冲突已经解决,您必须把它写入缓存区。
364 + </p>
365 +
366 +<pre>
367 +<b>$ git status -s</b>
368 +UU README
369 +<b>$ git add README </b>
370 +<b>$ git status -s</b>
371 +M README
372 +<b>$ git commit </b>
373 +[master 8d585ea] Merge branch 'fix_readme'
374 +</pre>
375 +
376 + <p>现在我们成功解决了合并中的冲突,并提交了结果
377 + </p>
378 +
379 + <p class="nutshell">
380 + <b>一言以蔽之</b> 使用 <code>git merge</code> 将另一个分支并入当前的分支中去。Git 会自动以最佳方式将两个不同快照中独特的工作合并到一个新快照中去。
381 + </p>
382 +
383 + </div>
384 +</div>
385 +
386 +<div class="box">
387 + <h2>
388 + <span class="docs">
389 + <a target="new" href="http://www.kernel.org/pub/software/scm/git/docs/git-log.html">文档</a> &nbsp;
390 + <a target="new" href="http://progit.org/book/ch6-1.html#commit_ranges">书</a>
391 + </span>
392 + <a name="log">git log</a>
393 + <span class="desc">显示一个分支中提交的更改记录</span>
394 + </h2>
395 +
396 + <div class="block">
397 +
398 + <p>
399 + 到目前为止,我们已经提交快照到项目中,在不同的各自分离的上下文中切换,但假如我们忘了自己是如何到目前这一步的那该怎么办?或者假如我们想知道此分支与彼分支到底有啥区别?Git 提供了一个告诉您使您达成当前快照的所有提交消息的工具,叫做 <code>git log</code>。
400 + </p>
401 +
402 + <p>
403 + 要理解日志(log)命令,您需要了解当执行 <code>git commit</code> 以存储一个快照的时候,都有啥信息被保存了。除了文件详单、提交消息和提交者的信息,Git 还保存了您的此次提交所基于的快照。也就是,假如您克隆了一个项目,您是在什么快照的基础上做的修改而得到新保存的快照的?这有益于为项目进程提供上下文,使 Git 能够弄明白谁做了什么改动。如果 Git 有您的快照所基于的快照的话,它就能自动判断您都改变了什么。而新提交所基于的提交,被称作新提交的“父亲”。
404 + </p>
405 +
406 + <p>某分支的按时间排序的“父亲”列表,当您在该分支时,可以执行 <code>git log</code> 以查看。例如,如果我们在本章中操作的 Hello World 项目中执行 <code>git log</code>,我们可以看到已提交的消息。
407 +
408 +<pre>
409 +<b>$ git log</b>
410 +<span class="yellow">commit 8d585ea6faf99facd39b55d6f6a3b3f481ad0d3d</span>
411 +Merge: 3cbb6aa 3ac015d
412 +Author: Scott Chacon &lt;schacon@gmail.com>
413 +Date: Fri Jun 4 12:59:47 2010 +0200
414 +
415 + Merge branch 'fix_readme'
416 +
417 + Conflicts:
418 + README
419 +
420 +<span class="yellow">commit 3cbb6aae5c0cbd711c098e113ae436801371c95e</span>
421 +Author: Scott Chacon &lt;schacon@gmail.com>
422 +Date: Fri Jun 4 12:58:53 2010 +0200
423 +
424 + fixed readme title differently
425 +
426 +<span class="yellow">commit 3ac015da8ade34d4c7ebeffa2053fcac33fb495b</span>
427 +Author: Scott Chacon &lt;schacon@gmail.com>
428 +Date: Fri Jun 4 12:58:36 2010 +0200
429 +
430 + fixed readme title
431 +
432 +<span class="yellow">commit 558151a95567ba4181bab5746bc8f34bd87143d6</span>
433 +Merge: b7ae93b 3467b0a
434 +Author: Scott Chacon &lt;schacon@gmail.com>
435 +Date: Fri Jun 4 12:37:05 2010 +0200
436 +
437 + Merge branch 'change_class'
438 +...
439 +</pre>
440 +
441 + <p>我们可以用 <code>--oneline</code> 选项来查看历史记录的紧凑简洁的版本。
442 + </p>
443 +
444 +<pre>
445 +<b>$ git log --oneline</b>
446 +8d585ea Merge branch 'fix_readme'
447 +3cbb6aa fixed readme title differently
448 +3ac015d fixed readme title
449 +558151a Merge branch 'change_class'
450 +b7ae93b added from ruby
451 +3467b0a changed the class name
452 +17f4acf first commit
453 +</pre>
454 +
455 + <p>
456 + 这告诉我们的是,此项目的开发历史。如果提交消息描述性很好,这就能为我们提供关于有啥改动被应用、或者影响了当前快照的状态、以及这快照里头都有啥。
457 + </p>
458 +
459 + <p>我们还可以用它的十分有帮助的 <code>--graph</code> 选项,查看历史中什么时候出现了分支、合并。以下为相同的命令,开启了拓扑图选项:
460 + </p>
461 +
462 +<pre>
463 +<b>$ git log --oneline --graph</b>
464 +* 8d585ea Merge branch 'fix_readme'
465 +|\
466 +| * 3ac015d fixed readme title
467 +* | 3cbb6aa fixed readme title differently
468 +|/
469 +* 558151a Merge branch 'change_class'
470 +|\
471 +| * 3467b0a changed the class name
472 +* | b7ae93b added from ruby
473 +|/
474 +* 17f4acf first commit
475 +</pre>
476 +
477 + <p>现在我们可以更清楚明了地看到何时工作分叉、又何时归并。这对查看发生了什么、应用了什么改变很有帮助,并且极大地帮助您管理您的分支。让我们创建一个分支,在里头做些事情,然后切回到主分支,也做点事情,然后看看 <code>log</code> 命令是如何帮助我们理清这俩分支上都发生了啥的。
478 + </p>
479 +
480 + <p>首先我们创建一个分支,来添加 Erlang 编程语言的 Hello World 示例 —— 我们想要在一个分支里头做这个,以避免让可能还不能工作的代码弄乱我们的稳定分支。这样就可以切来切去,片叶不沾身。
481 + </p>
482 +
483 +<pre>
484 +<b>$ git checkout -b erlang</b>
485 +Switched to a new branch 'erlang'
486 +<b>$ vim erlang_hw.erl</b>
487 +<b>$ git add erlang_hw.erl </b>
488 +<b>$ git commit -m 'added erlang'</b>
489 +[erlang ab5ab4c] added erlang
490 + 1 files changed, 5 insertions(+), 0 deletions(-)
491 + create mode 100644 erlang_hw.erl
492 +</pre>
493 +
494 + <p>由于我们玩函数式编程很开心,以至于沉迷其中,又在“erlang”分支中添加了一个 Haskell 的示例程序。
495 + </p>
496 +
497 +<pre>
498 +<b>$ vim haskell.hs</b>
499 +<b>$ git add haskell.hs </b>
500 +<b>$ git commit -m 'added haskell'</b>
501 +[erlang 1834130] added haskell
502 + 1 files changed, 4 insertions(+), 0 deletions(-)
503 + create mode 100644 haskell.hs
504 +</pre>
505 +
506 + <p>最后,我们决定还是把 Ruby 程序的类名改回原先的样子。与其创建另一个分支,我们可以返回主分支,改变它,然后直接提交。
507 + </p>
508 +
509 +<pre>
510 +<b>$ git checkout master</b>
511 +Switched to branch 'master'
512 +<b>$ ls</b>
513 +README ruby.rb
514 +<b>$ vim ruby.rb </b>
515 +<b>$ git commit -am 'reverted to old class name'</b>
516 +[master 594f90b] reverted to old class name
517 + 1 files changed, 2 insertions(+), 2 deletions(-)
518 +</pre>
519 +
520 + <p>现在假设我们有段时间不做这个项目了,我们做别的去了。当我们回来的时候,我们想知道“erlang”分支都是啥,而主分支的进度又是怎样。仅仅看分支的名字,我们是无从知道自己还在里面有 Haskell 的改动的,但是用 <code>git log</code> 我们就可以。如果您在命令行中提供一个分支名字,它就会显示该分支历史中“可及”的提交,即从该分支创立起可追溯的影响了最终的快照的提交。
521 + </p>
522 +
523 +<pre>
524 +<b>$ git log --oneline erlang</b>
525 +<span class="hl">1834130 added haskell</span>
526 +ab5ab4c added erlang
527 +8d585ea Merge branch 'fix_readme'
528 +3cbb6aa fixed readme title differently
529 +3ac015d fixed readme title
530 +558151a Merge branch 'change_class'
531 +b7ae93b added from ruby
532 +3467b0a changed the class name
533 +17f4acf first commit
534 +</pre>
535 +
536 + <p>如此,我们很容易就看到分支里头还包括了 Haskell 代码(高亮显示了)。更酷的是,我们很容易地告诉 Git,我们只对某个分支中可及的提交感兴趣。换句话说,某分支中与其他分支相比唯一的提交。
537 + </p>
538 +
539 + <p>在此例中,如果我们想要合并“erlang”分支,我们需要看当合并的时候,都有啥提交会作用到我们的快照上去。我们告诉 Git 的方式是,在不想要看到的分支前放一个 <code>^</code>。例如,如果我们想要看“erlang”分支中但不在主分支中的提交,我们可以用 <code>erlang ^master</code>,或者反之。
540 + </p>
541 +
542 +<pre>
543 +<b>$ git log --oneline erlang ^master</b>
544 +1834130 added haskell
545 +ab5ab4c added erlang
546 +<b>$ git log --oneline master ^erlang</b>
547 +594f90b reverted to old class name
548 +</pre>
549 +
550 + <p>这为我们提供了一个良好的、简易的分支管理工具。它使我们能够非常容易地查看对某个分支唯一的提交,从而知道我们缺少什么,以及当我们要合并时,会有什么被合并进去。
551 + </p>
552 +
553 + <p class="nutshell">
554 + <b>一言以蔽之</b> 使用 <code>git log</code> 列出促成当前分支目前的快照的提交历史记录。这使您能够看到项目是如何到达现在的状况的。
555 + </p>
556 +
557 + </div>
558 +</div>
559 +
560 +<div class="box">
561 + <h2>
562 + <span class="docs">
563 + <a target="new" href="http://www.kernel.org/pub/software/scm/git/docs/git-tag.html">文档</a> &nbsp;
564 + <a target="new" href="http://progit.org/book/ch2-6.html">书</a>
565 + </span>
566 + <a name="tag">git tag</a>
567 + <span class="desc">给历史记录中的某个重要的一点打上标签</span>
568 + </h2>
569 +
570 + <div class="block">
571 +
572 + <p>
573 + 如果您达到一个重要的阶段,并希望永远记住那个特别的提交快照,您可以使用 <code>git tag</code> 给它打上标签。该 <code>tag</code> 命令基本上会给该特殊提交打上永久的书签,从而使您在将来能够用它与其他提交比较。通常,您会在切取一个发布版本或者交付一些东西的时候打个标签。
574 + </p>
575 +
576 + <p>比如说,我们想为我们的 Hello World 项目发布一个“1.0”版本。我们可以用 <code>git tag -a v1.0</code> 命令给最新一次提交打上(<code>HEAD</code>)“v1.0”的标签。<code>-a</code> 选项意为“创建一个带注解的标签”,从而使您为标签添加注解。绝大部分时候都会这么做的。不用 <code>-a</code> 选项也可以执行的,但它不会记录这标签是啥时候打的,谁打的,也不会让你添加个标签的注解。我推荐一直创建带注解的标签。</p>
577 +
578 +<pre>
579 +<b>$ git tag -a v1.0 </b>
580 +</pre>
581 +
582 + <p>当您执行 <code>git tag -a</code> 命令时,Git 会打开您的编辑器,让您写一句标签注解,就像您给提交写注解一样。
583 + </p>
584 +
585 + <p>现在,注意当我们执行 <code>git log --decorate</code> 时,我们可以看到我们的标签了:
586 + </p>
587 +
588 +<pre>
589 +<b>$ git log --oneline --decorate --graph</b>
590 +* 594f90b (HEAD, <span class="hl">tag: v1.0</span>, master) reverted to old class name
591 +* 8d585ea Merge branch 'fix_readme'
592 +|\
593 +| * 3ac015d (fix_readme) fixed readme title
594 +* | 3cbb6aa fixed readme title differently
595 +|/
596 +* 558151a Merge branch 'change_class'
597 +|\
598 +| * 3467b0a changed the class name
599 +* | b7ae93b added from ruby
600 +|/
601 +* 17f4acf first commit
602 +</pre>
603 +
604 + <p>如果我们有新提交,该标签依然会待在该提交的边上,所以我们已经给那个特定快照永久打上标签,并且能够将它与未来的快照做比较。
605 + </p>
606 +
607 + <p>不过我们并不需要给当前提交打标签。如果我们忘了给某个提交打标签,又将它发布了,我们可以给它追加标签。在相同的命令末尾加上提交的 SHA,执行,就可以了。例如,假设我们发布了提交 <code>558151a</code>(几个提交之前的事情了),但是那时候忘了给它打标签。我们现在也可以:</p>
608 +
609 +<pre>
610 +<b>$ git tag -a v0.9 558151a</b>
611 +<b>$ git log --oneline --decorate --graph</b>
612 +* 594f90b (HEAD, tag: v1.0, master) reverted to old class name
613 +* 8d585ea Merge branch 'fix_readme'
614 +|\
615 +| * 3ac015d (fix_readme) fixed readme title
616 +* | 3cbb6aa fixed readme title differently
617 +|/
618 +* 558151a (<span class="hl">tag: v0.9</span>) Merge branch 'change_class'
619 +|\
620 +| * 3467b0a changed the class name
621 +* | b7ae93b added from ruby
622 +|/
623 +* 17f4acf first commit
624 +</pre>
625 +
626 + </div>
627 +</div>
628 +
629 +<p><a href="/zh/remotes">到 分享与更新项目 &#187;</a></p>
630 +
zh/cookbook.html new
+12
@@ -0,0 +1,12 @@
1 +---
2 +layout: zh_reference
3 +---
4 +<div class="box">
5 + <h2>Git Cookbook</h2>
6 + <ul>
7 + <li>Revert a file</li>
8 + <li>Recover a lost branch</li>
9 + <li>Contribute to a project on GitHub</li>
10 + <li>Undo a merge</li>
11 + </ul>
12 +</div>
zh/creating/index.html new
+112
@@ -0,0 +1,112 @@
1 +---
2 +layout: zh_reference
3 +---
4 +
5 +<div class="box">
6 + <h2>获取与创建项目</h2>
7 + <div class="block">
8 + <p>
9 + 您得现有一个 Git 仓库,才能用它进行操作。仓库是 Git 存放您要保存的快照的数据的地方。
10 + </p>
11 +
12 + <p>
13 + 拥有一个 Git 仓库的途径有两种。在已有的目录中,初始化一个新的,其一。比如一个新的项目,或者一个已存在的项目,但该项目尚未有版本控制。如果您想要复制一份别人的项目,或者与别人合作某个项目,也可以从一个公开的 Git 仓库克隆,其二。本章将对两者都做介绍。
14 + </p>
15 + </div>
16 +</div>
17 +
18 +<div class="box">
19 + <h2>
20 + <span class="docs">
21 + <a target="new" href="http://www.kernel.org/pub/software/scm/git/docs/git-init.html">文档</a> &nbsp;
22 + <a target="new" href="http://progit.org/book/ch2-1.html#initializing_a_repository_in_an_existing_directory">书</a>
23 + </span>
24 + <a name="init">git init</a>
25 + <span class="desc">将一个目录初始化为 Git 仓库</span>
26 + </h2>
27 +
28 + <div class="block">
29 + 在目录中执行 <code>git init</code>,就可以创建一个 Git 仓库了。比如,我们恰好有个目录,里头有些许文件,如下:
30 +<pre>
31 +<b>$ cd konichiwa</b>
32 +<b>$ ls</b>
33 +README hello.rb
34 +</pre>
35 +
36 + 在这个项目里头,我们会用各种编程语言写 "Hello World" 实例。到目前为止,我们只有 Ruby 的,不过,这才刚上路嘛。为了开始用 Git 对这个项目作版本控制,我们执行一下 <code>git init</code>。
37 +
38 +<pre>
39 +<b>$ git init</b>
40 +Initialized empty Git repository in /opt/konichiwa/.git/
41 +# 在 /opt/konichiwa/.git 目录初始化空 Git 仓库完毕。
42 +</pre>
43 +
44 + 现在您可以看到在您的项目目录中有个 <code>.git</code> 的子目录。这就是您的 Git 仓库了,所有有关您的此项目的快照数据都存放在这里。
45 +
46 +<pre>
47 +<b>$ ls -a</b>
48 +. .. .git README hello.rb
49 +</pre>
50 +
51 + 恭喜,现在您就有了一个 Git 仓库的架子,可以开始快照您的项目了。
52 +
53 + <p class="nutshell">
54 + <strong>一言以蔽之</strong>,用 <code>git init</code> 来在目录中创建新的 Git 仓库。您可以在任何时候、任何目录中这么做,完全是本地化的。
55 + </p>
56 +
57 + </div>
58 +</div>
59 +
60 +<div class="box">
61 + <h2>
62 + <span class="docs">
63 + <a target="new" href="http://www.kernel.org/pub/software/scm/git/docs/git-clone.html">文档 </a> &nbsp;
64 + <a target="new" href="http://progit.org/book/ch2-1.html#cloning_an_existing_repository">书</a>
65 + </span>
66 + <a name="clone">git clone</a>
67 + <span class="desc">复制一个 Git 仓库,以上下其手</span>
68 + </h2>
69 + <div class="block">
70 + <p>
71 + 如果您需要与他人合作一个项目,或者想要拷贝一个项目,看看代码,您就可以克隆那个项目。执行 <code>git clone [url]</code>,[url] 为您想要拷贝的项目,就可以了。
72 + </p>
73 +
74 +<pre>
75 +<b>$ git clone git://github.com/schacon/simplegit.git</b>
76 +Initialized empty Git repository in /private/tmp/simplegit/.git/
77 +remote: Counting objects: 100, done.
78 +remote: Compressing objects: 100% (86/86), done.
79 +remote: Total 100 (delta 35), reused 0 (delta 0)
80 +Receiving objects: 100% (100/100), 9.51 KiB, done.
81 +Resolving deltas: 100% (35/35), done.
82 +<b>$ cd simplegit/</b>
83 +<b>$ ls</b>
84 +README Rakefile <span class="blue">lib</span>
85 +</pre>
86 +
87 + <p>
88 + 上述操作将拷贝该项目的全部记录,让您本地拥有这些。并且该操作将拷贝该项目的主分支,是您能够查看代码,或编辑修改。进到该目录中,您会看到 <code>.git</code> 子目录。所有的项目数据都存在那里。
89 + </p>
90 +
91 +<pre>
92 +<b>$ ls -a</b>
93 +. .. <span class="blue">.git</span> README Rakefile <span class="blue">lib</span>
94 +<b>$ cd .git</b>
95 +<b>$ ls</b>
96 +HEAD description <span class="blue">info</span> packed-refs
97 +<span class="blue">branches hooks logs refs</span>
98 +config index <span class="blue">objects</span>
99 +</pre>
100 +
101 + <p>
102 + 默认情况下,Git 会按照您提供的 URL 所指示的项目的名称创建您的本地项目目录。通常就是该 URL 最后一个 <code>/</code> 之后的任何东西。如果你想要一个不一样的名字,您可以在该命令后加上它,就在那个 URL 后面。
103 + </p>
104 +
105 + <p class="nutshell">
106 + <strong>一言以蔽之</strong>,使用 <code>git clone</code> 本地拷贝一个 Git 仓库,让自己能够查看该项目,或者动手修改
107 + </p>
108 +
109 + </div>
110 +</div>
111 +
112 +<p><a href="/zh/basic">接下来:简单快照 &#187;</a></p>
zh/images/snapshots.png
Binary files /dev/null and b/zh/images/snapshots.png differ
zh/index.html new
+73
@@ -0,0 +1,73 @@
1 +---
2 +layout: zh_reference
3 +---
4 +<div class="box">
5 + <h2>Git 手册简介</h2>
6 + <div class="block">
7 + <p>
8 + 本站为 Git 参考手册。目的是为学习与记忆 Git 使用中最重要、最普遍的命令提供快速翻阅。这些命令以您可能需要的操作类型划分,并且将提供日常使用中需要的一些常用的命令以及参数。
9 + </p>
10 + <p>
11 + 每个章节都有到下一个章节的链接,所以本手册也可以当作一个入门指导。每个页面还有一个深度 Git 文档阅读的链接,比如官方的使用手册页面或者<a href="http://progit.org">《Pro Git》</a>书中的相关章节,以便于您学习了解更多的 Git 命令。首先,我们要从如何以 Git 的思维方式管理源代码开始。
12 + </p>
13 + </div>
14 +</div>
15 +
16 +<div class="box">
17 + <h2>如何以 Git 的方式思考</h2>
18 + <div class="block">
19 + <p>
20 + 懂得 Git,第一件重要的事情就是要知道它与 Subversion、Perforce 或者任何您用过的版本控制工具都有着很大的差别。通常,忘掉您预想的版本控制方式,改以 Git 的方式思考,能够帮助你更好地学习 Git。
21 + </p>
22 +
23 + <p>
24 + 让我们从头开始。假设您正在设计一个新的源代码管理系统。在您使用某个工具之前,是如何完成基本的源码版本控制工作的呢?十有八九,您只是在项目到达某些阶段的时候,对项目做一份拷贝。
25 + </p>
26 +
27 + <pre> $ cp -R project project.bak </pre>
28 +
29 + <p>
30 + 这样,您就可以在事情变得一团糟的时候很方便的返回到之前的状态,或者通过对比当前的项目与之前的拷贝,看看自己在之后的工作中,都做了哪些修改。
31 + </p>
32 +
33 + <p>
34 + 如果您有点偏执,您可能会经常作上面说的事情,或许还会给项目拷贝加个日期:
35 + </p>
36 +
37 + <pre> $ cp -R project project.2010-06-01.bak </pre>
38 +
39 + <p>
40 + 如此,您就有了一堆项目在各个阶段的快照,来作比较、查看。使用这种模式,您还可以有效地与人分享项目变更。如果您会在项目到达一定阶段的时候给它打个包,丢到自己的网站上,那其他的开发者们,就能很方便地下载它,做点改动,并给你补丁回馈。
41 + </p>
42 +
43 + <pre>
44 + $ wget http://sample.com/project.2010-06-01.zip
45 + $ unzip project.2010-06-01.zip
46 + $ cp -R project.2010-06-01 project-my-copy
47 + $ cd project-my-copy
48 + $ (改了些东西)
49 + $ diff project-my-copy project.2010-06-01 > change.patch
50 + $ (email change.patch)</pre>
51 +
52 + <p>
53 + 以此方式,原先的开发者就能将其他人的改动应用到他的项目中去,其他开发者也能了解您做的变更。其实这便是许多开源项目采用过多年的协作方式。
54 + </p>
55 +
56 + <p>
57 + 这办法其实很好使,所以假设我们现在想要写个工具,让这个办法更快、更简单。我们与其实现一个工具以记录每个文件的版本,可能不如去实现个工具以使创建、储存项目的快照更加方便,不用每次都去人肉作整个项目的拷贝。
58 + </p>
59 +
60 + <p>
61 + 这就是 Git 的精要所在。您通过 <code>git commit</code>告诉 Git 您想保存一份项目快照,Git 就会为您的项目中的各个文件的当前状态存一份记录。之后,绝大部分的 Git 命令都围绕这些记录展开。比如查看它们的区别(diff),提取它们的内容,等等。
62 + </p>
63 +
64 + <center><img src="./images/snapshots.png"/></center>
65 +
66 + <p>
67 + 如果您可以将 Git 看作一个排序、对比以及合并项目更新的工具,那就容易理解状况和正确做事了。
68 + </p>
69 +
70 + </div>
71 +</div>
72 +
73 +<p><a href="/zh/creating">接下来:获取与创建项目&#187;</a></p>
zh/inspect/index.html new
+415
@@ -0,0 +1,415 @@
1 +---
2 +layout: zh_reference
3 +---
4 +
5 +<div class="box">
6 + <h2>
7 + <span class="docs">
8 + <a target="new" href="http://progit.org/book/ch2-3.html">书</a>
9 + </span>
10 + 检查与比较
11 + </h2>
12 + <div class="block">
13 + <p>
14 + 现在您有了一堆分支,短期的主题、长期的特性或者其它。怎样追踪他们呢?Git 有一组工具,可以帮助您弄明白工作是在哪儿完成的,两个分支间的区别是啥,等等。
15 + </p>
16 +
17 + <p class="nutshell">
18 + <b>一言以蔽之</b> 执行 <code>git log</code> 找到您的项目历史中的特定提交 —— 按作者、日期、内容或者历史记录。执行 <code>git diff</code> 比较历史记录中的两个不同的点 —— 通常是为了看看两个分支有啥区别,或者从某个版本到另一个版本,您的软件都有啥变化。
19 + </p>
20 + </div>
21 +</div>
22 +
23 +<div class="box">
24 + <h2>
25 + <span class="docs">
26 + <a target="new" href="http://www.kernel.org/pub/software/scm/git/docs/git-log.html">文档</a> &nbsp;
27 + <a target="new" href="http://progit.org/book/ch2-3.html">书k</a>
28 + </span>
29 + <a name="log">git log</a>
30 + <span class="desc">过滤您的提交历史记录</span>
31 + </h2>
32 +
33 + <div class="block">
34 + <p>
35 + 通过查看分支中另一分支看不到的提交记录,我们已经看到如何用 <code>git log</code> 来比较分支。(如果您不记得了,它看起来是这样的:<code>git log branchA ^branchB</code>)。而且,您也可以用 <code>git log</code> 去寻找特定的提交。在此,我们会看到一些更广为使用的 <code>git log</code> 选项,不过哪有很多。完整的清单可以看看官方文档。
36 + </p>
37 +
38 + <h4>
39 + git log --author
40 + <small>只寻找某个特定作者的提交</small>
41 + </h4>
42 +
43 + <p>
44 + 要过滤您的提交历史,只寻找某个特定作者的提交,您可以使用 <code>--author</code> 选项。例如,比方说我们要找 Git 源码中 Linus 提交的部分。我们可以执行类似 <code>git log --author=Linus</code> 的命令。这个查找是大小写敏感的,并且也会检索电子邮箱地址。我在此例中使用 <code>-[number]</code> 选项,以限制结果为最近 [number] 次的提交。
45 + </p>
46 +
47 +<pre>
48 +<b>$ git log --author=Linus --oneline -5</b>
49 +81b50f3 Move 'builtin-*' into a 'builtin/' subdirectory
50 +3bb7256 make "index-pack" a built-in
51 +377d027 make "git pack-redundant" a built-in
52 +b532581 make "git unpack-file" a built-in
53 +112dd51 make "mktag" a built-in
54 +</pre>
55 +
56 + <h4>
57 + git log --since --before
58 + <small>根据日期过滤提交记录</small>
59 + </h4>
60 +
61 + <p>
62 + 如果您要指定一个您感兴趣的日期范围以过滤您的提交,可以执行几个选项 —— 我用 <code>--since</code> 和 <code>--before</code>,但是您也可以用 <code>--until</code> 和 <code>--after</code>。例如,如果我要看 Git 项目中三周前且在四月十八日之后的所有提交,我可以执行这个(我还用了 <code>--no-merges</code> 选项以隐藏合并提交):
63 + </p>
64 +
65 +<pre>
66 +<b>$ git log --oneline --before={3.weeks.ago} --after={2010-04-18} --no-merges</b>
67 +5469e2d Git 1.7.1-rc2
68 +d43427d Documentation/remote-helpers: Fix typos and improve language
69 +272a36b Fixup: Second argument may be any arbitrary string
70 +b6c8d2d Documentation/remote-helpers: Add invocation section
71 +5ce4f4e Documentation/urls: Rewrite to accomodate transport::address
72 +00b84e9 Documentation/remote-helpers: Rewrite description
73 +03aa87e Documentation: Describe other situations where -z affects git diff
74 +77bc694 rebase-interactive: silence warning when no commits rewritten
75 +636db2c t3301: add tests to use --format="%N"
76 +</pre>
77 +
78 + <h4>
79 + git log --grep
80 + <small>根据提交注释过滤提交记录</small>
81 + </h4>
82 +
83 + <p>
84 + 您或许还想根据提交注释中的某个特定短语查找提交记录。可以用 <code>--grep</code> 选项。比如说我知道有个提交是有关使用 P4EDITOR 环境变量,又想回忆起那个改动是啥样子的 —— 我可以用 <code>--grep</code> 选项找到该提交。
85 + </p>
86 +
87 +<pre>
88 +<b>$ git log --grep=P4EDITOR --no-merges</b>
89 +<span class="yellow">commit 82cea9ffb1c4677155e3e2996d76542502611370</span>
90 +Author: Shawn Bohrer
91 +Date: Wed Mar 12 19:03:24 2008 -0500
92 +
93 + git-p4: Use P4EDITOR environment variable when set
94 +
95 + Perforce allows you to set the P4EDITOR environment variable to your
96 + preferred editor for use in perforce. Since we are displaying a
97 + perforce changelog to the user we should use it when it is defined.
98 +
99 + Signed-off-by: Shawn Bohrer <shawn.bohrer@gmail.com>
100 + Signed-off-by: Simon Hausmann <simon@lst.de>
101 +</pre>
102 +
103 + <p>
104 + Git 会对所有的 <code>--grep</code> 和 <code>--author</code> 参数作逻辑或。如果您用 <code>--grep</code> 和 <code>--author</code> 时,想看的是某人写作的并且有某个特殊的注释内容的提交记录,您需要加上 <code>--all-match</code> 选项。在这些例子中,我会用上 <code>--format</code> 选项,这样我们就可以看到每个提交的作者是谁了。
105 + </p>
106 +
107 + <p>
108 + 如果我查找注释内容含有 “p4 depo”的提交,我得到了三个提交:
109 + </p>
110 +
111 +<pre>
112 +<b>$ git log --grep="p4 depo" --format="%h %an %s"</b>
113 +ee4fd1a Junio C Hamano Merge branch 'master' of git://repo.or.cz/git/fastimport
114 +da4a660 Benjamin Sergeant git-p4 fails when cloning a p4 depo.
115 +1cd5738 Simon Hausmann Make incremental imports easier to use by storing the p4 d
116 +</pre>
117 +
118 + <p>
119 + 如果我加上 <code>--author=Hausmann</code> 参数,与进一步过滤上述结果到 Simon 的唯一提交相反,它会告诉我所有 Simon 的提交,或者注释中有“p4 demo”的提交:
120 + </p>
121 +
122 +<pre>
123 +<b>$ git log --grep="p4 depo" --format="%h %an %s" --author="Hausmann"</b>
124 +cdc7e38 Simon Hausmann Make it possible to abort the submission of a change to Pe
125 +f5f7e4a Simon Hausmann Clean up the git-p4 documentation
126 +30b5940 Simon Hausmann git-p4: Fix import of changesets with file deletions
127 +4c750c0 Simon Hausmann git-p4: git-p4 submit cleanups.
128 +0e36f2d Simon Hausmann git-p4: Removed git-p4 submit --direct.
129 +edae1e2 Simon Hausmann git-p4: Clean up git-p4 submit's log message handling.
130 +4b61b5c Simon Hausmann git-p4: Remove --log-substitutions feature.
131 +36ee4ee Simon Hausmann git-p4: Ensure the working directory and the index are cle
132 +e96e400 Simon Hausmann git-p4: Fix submit user-interface.
133 +38f9f5e Simon Hausmann git-p4: Fix direct import from perforce after fetching cha
134 +2094714 Simon Hausmann git-p4: When skipping a patch as part of "git-p4 submit" m
135 +1ca3d71 Simon Hausmann git-p4: Added support for automatically importing newly ap
136 +...
137 +</pre>
138 +
139 + <p>
140 + 不过,如果加上 <code>--all-match</code>,结果就是我想要的了:
141 + </p>
142 +
143 +<pre>
144 +<b>$ git log --grep="p4 depo" --format="%h %an %s" --author="Hausmann" --all-match</b>
145 +1cd5738 Simon Hausmann Make incremental imports easier to use by storing the p4 d
146 +</pre>
147 +
148 + <h4>
149 + git log -S
150 + <small>依据所引入的差值过滤</small>
151 + </h4>
152 +
153 + <p>
154 + 如果您写的提交注释都极度糟糕怎么办?或者,如果您要找某个函数是何时引入的,某些变量是在哪里开始被使用的?您可以告诉 Git 在每个提交之间的差值中查找特定字符串。例如,如果我们想要找出哪个提交修改出了类似函数名“userformat_find_requirements”,我们可以执行(注意在“-S”与您要找的东东之间没有“=”):
155 + </p>
156 +
157 +<pre>
158 +<b>$ git log -Suserformat_find_requirements</b>
159 +<span class="yellow">commit 5b16360330822527eac1fa84131d185ff784c9fb</span>
160 +Author: Johannes Gilger
161 +Date: Tue Apr 13 22:31:12 2010 +0200
162 +
163 + pretty: Initialize notes if %N is used
164 +
165 + When using git log --pretty='%N' without an explicit --show-notes, git
166 + would segfault. This patches fixes this behaviour by loading the needed
167 + notes datastructures if --pretty is used and the format contains %N.
168 + When --pretty='%N' is used together with --no-notes, %N won't be
169 + expanded.
170 +
171 + This is an extension to a proposed patch by Jeff King.
172 +
173 + Signed-off-by: Johannes Gilger
174 + Signed-off-by: Junio C Hamano
175 +</pre>
176 +
177 + <h4>
178 + git log -p
179 + <small>显示每个提交引入的补丁</small>
180 + </h4>
181 +
182 + <p>
183 + 每个提交都是项目的一个快照。由于每个提交都记录它所基于的快照,Git 能够经常对它们求差值,并以补丁形式向您展示。这意味着,对任意提交,您都可以获取该提交给项目引入补丁。您可以用 <code>git show [SHA]</code> 加上某个特定的提交 SHA 获取,或者执行 <code>git log -p</code>,它会告诉 Git 输出每个提交之后的补丁。这是个总结某一分支或者两个提交之间都发生了神马的好途径。
184 + </p>
185 +
186 +<pre>
187 +<b>$ git log -p --no-merges -2</b>
188 +<span class="yellow">commit 594f90bdee4faf063ad07a4a6f503fdead3ef606</span>
189 +Author: Scott Chacon schacon@gmail.com
190 +Date: Fri Jun 4 15:46:55 2010 +0200
191 +
192 + reverted to old class name
193 +
194 +<span class="umber">diff --git a/ruby.rb b/ruby.rb
195 +index bb86f00..192151c 100644
196 +--- a/ruby.rb
197 ++++ b/ruby.rb</span>
198 +<span class="lblue">@@ -1,7 +1,7 @@</span>
199 +<span class="red">-class HiWorld</span>
200 +<span class="green">+class HelloWorld</span>
201 + def self.hello
202 + puts "Hello World from Ruby"
203 + end
204 + end
205 +
206 +<span class="red">-HiWorld.hello</span>
207 +<span class="green">+HelloWorld.hello</span>
208 +
209 +<span class="yellow">commit 3cbb6aae5c0cbd711c098e113ae436801371c95e</span>
210 +Author: Scott Chacon schacon@gmail.com
211 +Date: Fri Jun 4 12:58:53 2010 +0200
212 +
213 + fixed readme title differently
214 +
215 +<span class="umber">diff --git a/README b/README
216 +index d053cc8..9103e27 100644
217 +--- a/README
218 ++++ b/README</span>
219 +<span class="lblue">@@ -1,4 +1,4 @@</span>
220 +<span class="red">-Hello World Examples</span>
221 +<span class="green">+Many Hello World Examples</span>
222 + ======================
223 +
224 + This project has examples of hello world in
225 +</pre>
226 +
227 + <p>
228 + 这是个总结改动,以及合并或发布之前重审一系列提交的好方式。
229 + </p>
230 +
231 + <h4>
232 + git log --stat
233 + <small>显示每个提交引入的改动的差值统计</small>
234 + </h4>
235 +
236 + <p>
237 + 如果 <code>-p</code> 选项对您来说太详细了,您可以用 <code>--stat</code> 总结这些改动。这是不用 <code>-p</code>,而用 <code>--stat</code> 选项时,同一份日志的输出。
238 + </p>
239 +
240 +<pre>
241 +<b>$ git log --stat --no-merges -2</b>
242 +<span class="yellow">commit 594f90bdee4faf063ad07a4a6f503fdead3ef606</span>
243 +Author: Scott Chacon schacon@gmail.com
244 +Date: Fri Jun 4 15:46:55 2010 +0200
245 +
246 + reverted to old class name
247 +
248 + ruby.rb | 4 <span class="green">++</span><span class="red">--</span>
249 + 1 files changed, 2 insertions(+), 2 deletions(-)
250 +
251 +<span class="yellow">commit 3cbb6aae5c0cbd711c098e113ae436801371c95e</span>
252 +Author: Scott Chacon schacon@gmail.com
253 +Date: Fri Jun 4 12:58:53 2010 +0200
254 +
255 + fixed readme title differently
256 +
257 + README | 2 <span class="green">+</span><span class="red">-</span>
258 + 1 files changed, 1 insertions(+), 1 deletions(-)
259 +</pre>
260 +
261 + <p>
262 + 同样的基本信息,但更紧凑 —— 它仍然让您看到相对改动,和改动了哪些文件。
263 + </p>
264 +
265 + </div>
266 +</div>
267 +
268 +<div class="box">
269 + <h2>
270 + <span class="docs">
271 + <a target="new" href="http://www.kernel.org/pub/software/scm/git/docs/git-diff.html">文档</a> &nbsp;
272 + <a target="new" href="http://progit.org/book/ch5-3.html#determining_what_is_introduced">书</a>
273 + </span>
274 + <a name="diff">git diff</a>
275 + <span class="desc"></span>
276 + </h2>
277 +
278 + <div class="block">
279 +
280 + <p>
281 + 最后,要查看两个提交快照的绝对改动,您可以用 <code>git diff</code> 命令。这在两个主要情况中广为使用 —— 查看两个分支彼此之间的差值,和查看自发布或者某个旧历史点之后都有啥变了。让我们看看这俩情况。
282 + </p>
283 +
284 + <p>
285 + 您仅需执行 <code>git diff [version]</code>(或者您给该发布打的任何标签)就可以查看自最近发布之后的改动。例如,如果我们想要看看自 v0.9 发布之后我们的项目改变了啥,我们可以执行 <code>git diff v0.9</code>
286 + </p>
287 +
288 +<pre>
289 +<b>$ git diff v0.9</b>
290 +<span class="umber">diff --git a/README b/README
291 +index d053cc8..d4173d5 100644
292 +--- a/README
293 ++++ b/README</span>
294 +<span class="lblue">@@ -1,4 +1,4 @@</span>
295 +<span class="red">-Hello World Examples</span>
296 +<span class="green">+Many Hello World Lang Examples</span>
297 + ======================
298 +
299 + This project has examples of hello world in
300 +<span class="umber">diff --git a/ruby.rb b/ruby.rb
301 +index bb86f00..192151c 100644
302 +--- a/ruby.rb
303 ++++ b/ruby.rb</span>
304 +<span class="lblue">@@ -1,7 +1,7 @@</span>
305 +<span class="red">-class HiWorld</span>
306 +<span class="green">+class HelloWorld</span>
307 + def self.hello
308 + puts "Hello World from Ruby"
309 + end
310 + end
311 +
312 +<span class="red">-HiWorld.hello</span>
313 +<span class="green">+HelloWorld.hello</span>
314 +</pre>
315 +
316 + <p>
317 + 正如 <code>git log</code>,您可以给它加上 <code>--stat</code> 参数。
318 + </p>
319 +
320 +<pre>
321 +<b>$ git diff v0.9 --stat</b>
322 + README | 2 +-
323 + ruby.rb | 4 ++--
324 + 2 files changed, 3 insertions(+), 3 deletions(-)
325 +</pre>
326 +
327 + <p>
328 + 要比较两个不同的分支,您可以执行类似 <code>git diff branchA branchB</code> 的命令。不过它的问题在于它会完完全全按您说的作 —— 它会直接给您个补丁文件,该补丁能够将甲分支的最新快照变成乙分支的最新快照的样子。这意味着如果两个分支已经产生分歧 —— 奔往两个不同方向了 —— 它会移除甲分支中引入的所有工作,然后累加乙分支中的所有工作。这大概不是您要的吧 —— 您想要不在甲分支中的乙分支的改动。所以您真的需要的是两个分支叉开去时,和最新的乙分支的差别。所以,如果我们的历史记录看起来像这样:
329 + </p>
330 +
331 +<pre>
332 +<b>$ git log --graph --oneline --decorate --all</b>
333 +* 594f90b (HEAD, tag: v1.0, master) reverted to old class name
334 +| * 1834130 (erlang) added haskell
335 +| * ab5ab4c added erlang
336 +|/
337 +* 8d585ea Merge branch 'fix_readme'
338 +...
339 +</pre>
340 +
341 + <p>
342 + 并且,我们想要看“erlang”分支与主分支相比的查别。执行 <code>git diff master erlang</code> 会给我们错误的结果。
343 + </p>
344 +
345 +<pre>
346 +<b>$ git diff --stat master erlang</b>
347 + erlang_hw.erl | 5 +++++
348 + haskell.hs | 4 ++++
349 + ruby.rb | 4 ++--
350 + 3 files changed, 11 insertions(+), 2 deletions(-)
351 +</pre>
352 +
353 + <p>
354 + 您可以看到,它加上了 erlang 和 haskell 文件,这确实是我们在该分支中做的,但是它同时恢复了我们在主分支中改动的 ruby 文件。我们真心想要的只是“erlang”分支中的改动(添加两个文件)。我们可以通过求两个分支分歧时的共同提交与该分支的差值得到想要的结果:
355 + </p>
356 +
357 +<pre>
358 +<b>$ git diff --stat 8d585ea erlang</b>
359 + erlang_hw.erl | 5 +++++
360 + haskell.hs | 4 ++++
361 + 2 files changed, 9 insertions(+), 0 deletions(-)
362 +</pre>
363 +
364 + <p>
365 + 这才是我们在找的,但是我们可不想要每次都要找出两个分支分歧时的那次提交。幸运的是,Git 为此提供了一个快捷方式。如果您执行 <code>git diff master...erlang</code>(在分支名之间有三个半角的点),Git 就会自动找出两个分支的共同提交(也被成为合并基础),并求差值。
366 + </p>
367 +
368 +<pre>
369 +<b>$ git diff --stat master erlang</b>
370 + erlang_hw.erl | 5 +++++
371 + haskell.hs | 4 ++++
372 + ruby.rb | 4 ++--
373 + 3 files changed, 11 insertions(+), 2 deletions(-)
374 +<b>$ git diff --stat master...erlang</b>
375 + erlang_hw.erl | 5 +++++
376 + haskell.hs | 4 ++++
377 + 2 files changed, 9 insertions(+), 0 deletions(-)
378 +</pre>
379 +
380 + <p>
381 + 几乎每一次您要对比两个分支的时候,您都会想用三个点的语法,因为它通常会给您您想要的。
382 + </p>
383 +
384 + <p>
385 + 顺带提一句,您还可以让 Git 手工计算两次提交的合并基础(第一个共同的祖提交),即 <code>git merge-base</code> 命令:
386 + </p>
387 +
388 +<pre>
389 +<b>$ git merge-base master erlang</b>
390 +8d585ea6faf99facd39b55d6f6a3b3f481ad0d3d
391 +</pre>
392 +
393 + <p>
394 + 所以您执行下面这个也跟 <code>git diff master...erlang</code> 一样:
395 + </p>
396 +
397 +<pre>
398 +<b>$ git diff --stat $(git merge-base master erlang) erlang</b>
399 + erlang_hw.erl | 5 +++++
400 + haskell.hs | 4 ++++
401 + 2 files changed, 9 insertions(+), 0 deletions(-)
402 +</pre>
403 +
404 + <p>当然,我会推荐简单点的那个。</>
405 +
406 +
407 + <p class="nutshell">
408 + <b>一言以蔽之</b> 使用 <code>git diff</code> 查看某一分支自它偏离出来起与过去某一点之间项目的改动。总是使用 <code>git diff branchA...branchB</code> 来查看 branchB 与 branchA 的相对差值,这会让事情简单点。
409 + </p>
410 +
411 + </div>
412 +</div>
413 +
414 +<p>就是这样了! 请阅读
415 +<a href="http://progit.org">《Pro Git》</a> 以获得更多信息。</p>
zh/remotes/index.html new
+274
@@ -0,0 +1,274 @@
1 +---
2 +layout: zh_reference
3 +---
4 +
5 +<div class="box">
6 + <h2>
7 + <span class="docs">
8 + <a target="new" href="http://progit.org/book/ch2-5.html">书</a>
9 + </span>
10 + 分享与更新项目
11 + </h2>
12 + <div class="block">
13 + <p>
14 + Git 并不像 Subversion 那样有个中心服务器。目前为止所有的命令都是本地执行的,更新的知识本地的数据库。要通过 Git 与其他开发者合作,您需要将数据放到一台其他开发者能够连接的服务器上。Git 实现此流程的方式是将您的数据与另一个仓库同步。在服务器与客户端之间并没有实质的区别 —— Git 仓库就是 Git 仓库,您可以很容易地在两者之间同步。
15 + </p>
16 +
17 + <p>
18 + 一旦您有了个 Git 仓库,不管它是在您自己的服务器上,或者是由 GitHub 之类的地方提供,您都可以告诉 Git 推送您拥有的远端仓库还没有的数据,或者叫 Git 从别的仓库把差别取过来。
19 + </p>
20 +
21 + <p>
22 + 联网的时候您可以随时做这个,它并不需要对应一个 <code>commit</code> 或者别的什么。一般您会本地提交几次,然后从您的项目克隆自的线上的共享仓库提取数据以保持最新,将新完成的合并到您完成的工作中去,然后推送您的改动会服务器。
23 + </p>
24 +
25 + <p class="nutshell">
26 + <b>一言以蔽之</b> 使用 <code>git fetch</code> 更新您的项目,使用 <code>git push</code> 分享您的改动。您可以用 <code>git remote</code> 管理您的远程仓库。
27 + </p>
28 + </div>
29 +</div>
30 +
31 +<div class="box">
32 + <h2>
33 + <span class="docs">
34 + <a target="new" href="http://www.kernel.org/pub/software/scm/git/docs/git-remote.html">文档</a> &nbsp;
35 + <a target="new" href="http://progit.org/book/ch2-5.html#showing_your_remotes">书</a>
36 + </span>
37 + <a name="remote">git remote</a>
38 + <span class="desc">罗列、添加和删除远端仓库别名</span>
39 + </h2>
40 +
41 + <div class="block">
42 +
43 + <p>不像中心化的版本控制系统(客户端与服务端很不一样),Git 仓库基本上都是一致的,并且并可以同步他们。这使得拥有多个远端仓库变得容易 —— 您可以可以拥有一些只读的仓库,另外的一些也可写的仓库。
44 + </p>
45 +
46 + <p>
47 + 当您需要与远端仓库同步的时候,不需要使用它详细的链接。Git 储存了您感兴趣的远端仓库的链接的别名或者昵称。您可以使用 <code>git remote</code> 命令管理这个远端仓库列表。
48 + </p>
49 +
50 + <h4>
51 + git remote
52 + <small>列出远端别名</small>
53 + </h4>
54 +
55 + <p>
56 + 如果没有任何参数,Git 会列出它存储的远端仓库别名了事。默认情况下,如果您的项目是克隆的(与本地创建一个新的相反),Git 会自动将您的项目克隆自的仓库添加到列表中,并取名“origin”。如果您执行时加上 <code>-v</code> 参数,您还可以看到每个别名的实际链接地址。
57 + </p>
58 +
59 +<pre>
60 +<b>$ git remote</b>
61 +origin
62 +<b>$ git remote -v</b>
63 +origin git@github.com:schacon/git-reference.git (fetch)
64 +origin git@github.com:schacon/git-reference.git (push)
65 +</pre>
66 +
67 + <p>在此您看到了该链接两次,是因为 Git 允许您为每个远端仓库添加不同的推送与获取的链接,以备您读写时希望使用不同的协议。
68 + </p>
69 +
70 + <h4>
71 + git remote add
72 + <small>为您的项目添加一个新的远端仓库</small>
73 + </h4>
74 +
75 + <p>
76 + 如果您希望分享一个本地创建的仓库,或者您想要获取别人的仓库中的贡献 —— 如果您想要以任何方式与一个新仓库沟通,最简单的方式通常就是把它添加为一个远端仓库。执行 <code>git remote add [alias] [url]</code> 就可以。此命令将 <code>[url]</code> 以 <code>[alias]</code> 的别名添加为本地的远端仓库。
77 + </p>
78 +
79 + <p>
80 + 例如,假设我们想要与整个世界分享我们的 Hello World 程序。我们可以在一台服务器上创建一个新仓库(我以 GitHub 为例子)。它应该会给您一个链接,在这里就是“git@github.com:schacon/hw.git”。要把它添加到我们的项目以便我们推送以及获取更新,我们可以这样:
81 + </p>
82 +
83 +<pre>
84 +<b>$ git remote</b>
85 +<b>$ git remote add github git@github.com:schacon/hw.git</b>
86 +<b>$ git remote -v</b>
87 +github git@github.com:schacon/hw.git (fetch)
88 +github git@github.com:schacon/hw.git (push)
89 +</pre>
90 +
91 + <p>
92 + 像分支的命名一样,远端仓库的别名是强制的 —— 就像“master”,没有特别意义,但它广为使用,因为 <code>git init</code> 默认用它;“origin”经常被用作远端仓库别名,就因为 <code>git clone</code> 默认用它作为克隆自的链接的别名。此例中,我决定给我的远端仓库取名“github”,但我叫它随便什么都可以。
93 + </p>
94 +
95 + <h4>
96 + git remote rm
97 + <small>删除现存的某个别名</small>
98 + </h4>
99 +
100 + <p>
101 + Git addeth and Git taketh away. 如果您需要删除一个远端 —— 不再需要它了、项目已经没了,等等 —— 您可以使用 <code>git remote rm [alias]</code> 把它删掉。
102 + </p>
103 +
104 +<pre>
105 +<b>$ git remote -v</b>
106 +github git@github.com:schacon/hw.git (fetch)
107 +github git@github.com:schacon/hw.git (push)
108 +<b>$ git remote add origin git://github.com/pjhyett/hw.git</b>
109 +<b>$ git remote -v</b>
110 +github git@github.com:schacon/hw.git (fetch)
111 +github git@github.com:schacon/hw.git (push)
112 +origin git://github.com/pjhyett/hw.git (fetch)
113 +origin git://github.com/pjhyett/hw.git (push)
114 +<b>$ git remote rm origin</b>
115 +<b>$ git remote -v</b>
116 +github git@github.com:schacon/hw.git (fetch)
117 +github git@github.com:schacon/hw.git (push)
118 +</pre>
119 +
120 + <p class="nutshell">
121 + <b>一言以蔽之</b> 您可以用 <code>git remote</code> 列出您的远端仓库和那些仓库的链接。您可以使用 <code>git remote add</code> 添加新的远端仓库,用 <code>git remote rm</code> 删掉已存在的那些。
122 + </p>
123 +
124 + </div>
125 +</div>
126 +
127 +<div class="box">
128 + <h2>
129 + <span class="docs">
130 + <a target="new" href="http://www.kernel.org/pub/software/scm/git/docs/git-fetch.html">文档</a> &nbsp;
131 + <a target="new" href="http://progit.org/book/ch2-5.html#fetching_and_pulling_from_your_remotes">书</a>
132 + </span>
133 + <a name="fetch">git fetch</a>
134 + <span class="desc">从远端仓库下载新分支与数据</span>
135 + </h2>
136 +
137 + <br/>
138 +
139 + <h2>
140 + <span class="docs">
141 + <a target="new" href="http://www.kernel.org/pub/software/scm/git/docs/git-pull.html">文档</a> &nbsp;
142 + <a target="new" href="http://progit.org/book/">书</a>
143 + </span>
144 + <a name="pull">git pull</a>
145 + <span class="desc">从远端仓库提取数据并尝试合并到当前分支</span>
146 + </h2>
147 +
148 + <div class="block">
149 +
150 + <p>
151 + Git 有两个命令用来从某一远端仓库更新。<code>git fetch</code> 会使您与另一仓库同步,提取您本地所没有的数据,为您在同步时的该远端的每一分支提供书签。这些分支被叫做“远端分支”,除了 Git 不允许您检出(切换到该分支)之外,跟本地分支没区别 —— 您可以将它们合并到当前分支,与其他分支作比较差异,查看那些分支的历史日志,等等。同步之后您就可以在本地操作这些。
152 + </p>
153 +
154 + <p>
155 + 第二个会从远端服务器提取新数据的命令是 <code>git pull</code>。基本上,该命令就是在 <code>git fetch</code> 之后紧接着 <code>git merge</code> 远端分支到您所在的任意分支。我个人不太喜欢这命令 —— 我更喜欢 <code>fetch</code> 和 <code>merge</code> 分开来做。少点魔法,少点问题。不过,如果您喜欢这主意,您可以看一下 <code>git pull</code> 的 <a target="new" href="http://www.kernel.org/pub/software/scm/git/docs/git-pull.html">官方文档</a>。
156 + </p>
157 +
158 + <p>
159 + 假设您配置好了一个远端,并且您想要提取更新,您可以首先执行 <code>git fetch [alias]</code> 告诉 Git 去获取它有您没有的数据,然后您可以执行 <code>git merge [alias]/[branch]</code> 以将服务器上的任何更新(假设有人这时候推送到服务器了)合并到您的当前分支。那么,如果我是与两三个其他人合作 Hello World 项目,并且想要将我最近连接之后的所有改动拿过来,我可以这么做:
160 + </p>
161 +
162 +<pre>
163 +<b>$ git fetch github</b>
164 +remote: Counting objects: 4006, done.
165 +remote: Compressing objects: 100% (1322/1322), done.
166 +remote: Total 2783 (delta 1526), reused 2587 (delta 1387)
167 +Receiving objects: 100% (2783/2783), 1.23 MiB | 10 KiB/s, done.
168 +Resolving deltas: 100% (1526/1526), completed with 387 local objects.
169 +From github.com:schacon/hw
170 + 8e29b09..c7c5a10 master -> github/master
171 + 0709fdc..d4ccf73 c-langs -> github/c-langs
172 + 6684f82..ae06d2b java -> github/java
173 + * [new branch] ada -> github/ada
174 + * [new branch] lisp -> github/lisp
175 +</pre>
176 +
177 + <p>
178 + 可以看到自从上一次与远端仓库同步以后,又新赠或更新了五个分支。“ada”与“lisp”分支是新的,而“master”、“clang”与“java”分支则被更新了。在此例中,我的团队在合并入主分支之前,将提议的更新推送到远端分支以审核。
179 + </p>
180 +
181 + <p>您可以看到 Git 做的映射。远端仓库的主分支成为了本地的一个叫做“github/master”的分支。这样我就可以执行 <code>git merge github/master</code> 将远端的主分支和并入我的本地主分支。或者,我可以 <code>git log github/master ^master</code> 看看该分支上的新提交。如果您的远端仓库叫做“origin”,那远端主分支就会叫做 <code>origin/master</code>。几乎所有能在本地分支上执行的命令都可以在远端分支上用。
182 + </p>
183 +
184 + <p>
185 + 如果您有多个远端仓库,您可以执行 <code>git fetch [alias]</code> 提取特定的远端仓库,或者执行 <code>git fetch --all</code> 告诉 Git 同步所有的远端仓库。
186 + </p>
187 +
188 + <p class="nutshell">
189 + <b>一言以蔽之</b> 执行 <code>git fetch [alias]</code> 来将您的仓库与远端仓库同步,提取所有它独有的数据到本地分支以合并或者怎样。
190 + </p>
191 +
192 + </div>
193 +
194 +</div>
195 +
196 +<div class="box">
197 + <h2>
198 + <span class="docs">
199 + <a target="new" href="http://www.kernel.org/pub/software/scm/git/docs/git-push.html">文档</a> &nbsp;
200 + <a target="new" href="http://progit.org/book/ch2-5.html#pushing_to_your_remotes">书</a>
201 + </span>
202 + <a name="push">git push</a>
203 + <span class="desc">推送您的新分支与数据到某个远端仓库</span>
204 + </h2>
205 +
206 + <div class="block">
207 + <p>
208 + 想要与他人分享您牛鼻的提交,您需要将改动推送到远端仓库。执行 <code>git push [alias] [branch]</code>,就会将您的 [branch] 分支推送成为 [alias] 远端上的 [branch] 分支。让我们试试推送我们的主分支到先前添加的“github”远端仓库上去。
209 + </p>
210 +
211 +<pre>
212 +<b>$ git push github master</b>
213 +Counting objects: 25, done.
214 +Delta compression using up to 2 threads.
215 +Compressing objects: 100% (25/25), done.
216 +Writing objects: 100% (25/25), 2.43 KiB, done.
217 +Total 25 (delta 4), reused 0 (delta 0)
218 +To git@github.com:schacon/hw.git
219 + * [new branch] master -> master
220 +</pre>
221 +
222 + <p>
223 + 挺简单。现在如果有人从该仓库克隆,他会得到我提交的完完全全的一份历史记录了。
224 + </p>
225 +
226 + <p>
227 + 如果有个像之前创建的“erlang”分支那样的主题分支,想只分享这个,该怎么办呢?您可以相应的只推送该分支。
228 + </p>
229 +
230 +<pre>
231 +<b>$ git push github erlang</b>
232 +Counting objects: 7, done.
233 +Delta compression using up to 2 threads.
234 +Compressing objects: 100% (6/6), done.
235 +Writing objects: 100% (6/6), 652 bytes, done.
236 +Total 6 (delta 1), reused 0 (delta 0)
237 +To git@github.com:schacon/hw.git
238 + * [new branch] erlang -> erlang
239 +</pre>
240 +
241 + <p>
242 + 现在当人们从该仓库克隆时,他们就会得到一个“erlang”分支以查阅、合并。用这种方式,您可以推送任何分支到任何您有写权限的仓库。如果您的分支已经在该仓库中了,它会试着去更新,如果它不再,Git 会把它加上。
243 + </p>
244 +
245 + <p>
246 + 最后一个当您推送到远端分支时会碰到的主要问题是,其他人在此期间也推送了的情况。如果您和另一个开发者同时克隆了,又都有提交,那么当她推送后您也想推送时,默认情况下 Git 不会让您覆盖她的改动。相反的,它会在您试图推送的分支上执行 <code>git log</code>,确定它能够在您的推送分支的历史记录中看到服务器分支的当前进度。如果它在在您的历史记录中看不到,它就会下结论说您过时了,并打回您的推送。您需要正式提取、合并,然后再次推送 —— 以确定您把她的改动也考虑在内了。
247 + </p>
248 +
249 + <p>
250 + 当您试图推送到某个以被更新的远端分支时,会出现下面这种情况:
251 + </p>
252 +
253 +<pre>
254 +<b>$ git push github master</b>
255 +To git@github.com:schacon/hw.git
256 + ! [rejected] master -> master (non-fast-forward)
257 +error: failed to push some refs to 'git@github.com:schacon/hw.git'
258 +To prevent you from losing history, non-fast-forward updates were rejected
259 +Merge the remote changes before pushing again. See the 'Note about
260 +fast-forwards' section of 'git push --help' for details.
261 +</pre>
262 +
263 + <p>
264 + 您可以修正这个问题。执行 <code>git fetch github; git merge github/master</code>,然后再推送
265 + </p>
266 +
267 + <p class="nutshell">
268 + <b>一言以蔽之</b> 执行 <code>git push [alias] [branch]</code> 将您的本地改动推送到远端仓库。如果可以的话,它会依据您的 [branch] 的样子,推送到远端的 [branch] 去。如果在您上次提取、合并之后,另有人推送了,Git 服务器会拒绝您的推送,知道您是最新的为止。
269 + </p>
270 +
271 + </div>
272 +</div>
273 +
274 +<p><a href="/zh/inspect">到 检查与比较&#187;</a></p>