/
index.zh.html
260 lines (256 loc) · 13.3 KB
/
index.zh.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
<title>git - the simple guide - no deep shit!</title>
<link href='http://fonts.googleapis.com/css?family=Chelsea+Market' rel='stylesheet' type='text/css'>
<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/normalize/0/normalize.min.css" type="text/css">
<link rel="stylesheet" href="css/style.css" type="text/css">
<script type="text/javascript">
var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-652147-13']);
_gaq.push(['_trackPageview']);
(function() {
var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
})();
function recordOutboundLink(link, category, action) {
_gat._getTrackerByName()._trackEvent(category, action);
setTimeout('document.location = "' + link.href + '"', 100);
}
</script>
</head>
<body>
<div class="scrollblock block-title">
<h1>git - 简明指南</h1>
<p>助你入门 git 的简明指南，木有高深内容 ;)</p>
<a href="https://twitter.com/share" class="twitter-share-button" data-via="rogerdudler" data-size="large" data-url="http://rogerdudler.github.com/git-guide" data-related="rogerdudler" data-hashtags="git">Tweet</a>
<script>!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src="//platform.twitter.com/widgets.js";fjs.parentNode.insertBefore(js,fjs);}}(document,"script","twitter-wjs");</script>
<p class="meta">
作者：<a href="http://www.twitter.com/rogerdudler">罗杰·杜德勒</a>
<br />感谢：<a href="http://www.twitter.com/tfnico">@tfnico</a>, <a href="http://www.twitter.com/fhd">@fhd</a> 和 <a href="http://www.namics.com">Namics</a><br />
其他语言
<a href="index.html">english</a>,
<a href="index.de.html">deutsch</a>,
<a href="index.es.html">español</a>,
<a href="index.fr.html">français</a>,
<a href="index.id.html">indonesian</a>,
<a href="index.it.html">italiano</a>,
<a href="index.nl.html">nederlands</a>,
<a href="index.pl.html">polski</a>,
<a href="index.pt_BR.html">português</a>,
<a href="index.ru.html">русский</a>,
<a href="index.tr.html">türkçe</a>,
<br/>
<a href="index.my.html">မြန်မာ</a>,
<a href="index.ja.html">日本語</a>,
<a href="index.ko.html">한국어</a>
<a href="index.vi.html">Vietnamese</a>
<br />
如有纰漏，请在 <a href="https://github.com/rogerdudler/git-guide/issues">github</a> 提报问题
</p>
<img src="img/arrow.png" alt="" />
</div>
<!-- setup -->
<a name="setup"></a>
<div class="scrollblock block-setup">
<h2>安装</h2>
<p>
<a href="http://git-scm.com/download/mac">下载 git OSX 版</a>
</p>
<p>
<a href="http://git-for-windows.github.io/">下载 git Windows 版</a>
</p>
<p>
<a href="http://book.git-scm.com/2_installing_git.html">下载 git Linux 版</a>
</p>
</div>
<a name="create"></a>
<div class="scrollblock block-create">
<h2>创建新仓库</h2>
<p>
创建新文件夹，打开，然后执行 <br />
<code>git init</code><br />
以创建新的 git 仓库。
</p>
</div>
<a name="checkout"></a>
<div class="scrollblock block-checkout">
<h2>检出仓库</h2>
<p>
执行如下命令以创建一个本地仓库的克隆版本：<br />
<code>git clone /path/to/repository</code> <br />
如果是远端服务器上的仓库，你的命令会是这个样子：<br />
<code>git clone username@host:/path/to/repository</code>
</p>
</div>
<a name="trees"></a>
<div class="scrollblock block-trees">
<h2>工作流</h2>
<p>
你的本地仓库由 git 维护的三棵“树”组成。第一个是你的 <code>工作目录</code>，它持有实际文件；第二个是 <code>暂存区（Index）</code>，它像个缓存区域，临时保存你的改动；最后是 <code>HEAD</code>，它指向你最后一次提交的结果。
</p>
<img src="img/trees.png" alt="" />
</div>
<a name="add"></a>
<div class="scrollblock block-add">
<h2>添加和提交</h2>
<p>
你可以提出更改（把它们添加到暂存区），使用如下命令：<br />
<code>git add <filename></code><br />
<code>git add *</code><br />
这是 git 基本工作流程的第一步；使用如下命令以实际提交改动：<br />
<code>git commit -m "代码提交信息"</code><br />
现在，你的改动已经提交到了 <b>HEAD</b>，但是还没到你的远端仓库。
</p>
</div>
<a name="push"></a>
<div class="scrollblock block-remote">
<h2>推送改动</h2>
<p>
你的改动现在已经在本地仓库的 <b>HEAD</b> 中了。执行如下命令以将这些改动提交到远端仓库：<br />
<code>git push origin master</code><br />
可以把 <i>master</i> 换成你想要推送的任何分支。
<br /><br />
如果你还没有克隆现有仓库，并欲将你的仓库连接到某个远程服务器，你可以使用如下命令添加：<br />
<code>git remote add origin <server></code><br />
如此你就能够将你的改动推送到所添加的服务器上去了。<br />
</p>
</div>
<a name="branching"></a>
<div class="scrollblock block-branching">
<h2>分支</h2>
<p>
分支是用来将特性开发绝缘开来的。在你创建仓库的时候，<i>master</i> 是“默认的”分支。在其他分支上进行开发，完成后再将它们合并到主分支上。
</p>
<img src="img/branches.png" alt="" />
<p>
创建一个叫做“feature_x”的分支，并切换过去：<br />
<code>git checkout -b feature_x</code><br />
切换回主分支：<br />
<code>git checkout master</code><br />
再把新建的分支删掉：<br />
<code>git branch -d feature_x</code><br />
除非你将分支推送到远端仓库，不然该分支就是 <i>不为他人所见的</i>：<br />
<code>git push origin <branch></code>
</p>
</div>
<a name="update"></a>
<div class="scrollblock block-merging">
<h2>更新与合并</h2>
<p>
要更新你的本地仓库至最新改动，执行：<br />
<code>git pull</code><br />
以在你的工作目录中 <i>获取（fetch）</i> 并 <i>合并（merge）</i> 远端的改动。<br />
要合并其他分支到你的当前分支（例如 master），执行：<br />
<code>git merge <branch></code><br />
在这两种情况下，git 都会尝试去自动合并改动。遗憾的是，这可能并非每次都成功，并可能出现<i>冲突（conflicts）</i>。
这时候就需要你修改这些文件来手动合并这些<i>冲突（conflicts）</i>。改完之后，你需要执行如下命令以将它们标记为合并成功：<br />
<code>git add <filename></code><br />
在合并改动之前，你可以使用如下命令预览差异：<br />
<code>git diff <source_branch> <target_branch></code>
</p>
</div>
<a name="tagging"></a>
<div class="scrollblock block-tagging">
<h2>标签</h2>
<p>
为软件发布创建标签是推荐的。这个概念早已存在，在 SVN 中也有。你可以执行如下命令创建一个叫做 <i>1.0.0</i> 的标签：<br />
<code>git tag 1.0.0 1b2e1d63ff</code><br />
<i>1b2e1d63ff</i> 是你想要标记的提交 ID 的前 10 位字符。可以使用下列命令获取提交 ID：<br />
<code>git log</code><br />
你也可以使用少一点的提交 ID 前几位，只要它的指向具有唯一性。
</p>
</div>
<a name="log"></a>
<div class="scrollblock block-log">
<h2>log</h2>
<p>
如果你想了解本地仓库的历史记录，最简单的命令就是使用: <br />
<code>git log</code><br />
你可以添加一些参数来修改他的输出，从而得到自己想要的结果。 只看某一个人的提交记录:<br />
<code>git log --author=bob</code><br />
一个压缩后的每一条提交记录只占一行的输出:<br />
<code>git log --pretty=oneline</code><br />
或者你想通过 ASCII 艺术的树形结构来展示所有的分支, 每个分支都标示了他的名字和标签: <br />
<code>git log --graph --oneline --decorate --all</code><br />
看看哪些文件改变了: <br />
<code>git log --name-status</code><br />
这些只是你可以使用的参数中很小的一部分。更多的信息，参考：<br />
<code>git log --help</code><br />
</p>
</div>
<a name="checkout-replace"></a>
<div class="scrollblock block-checkout-replace">
<h2>替换本地改动</h2>
<p>
假如你操作失误（当然，这最好永远不要发生），你可以使用如下命令替换掉本地改动：<br />
<code>git checkout -- <filename></code><br />
此命令会使用 HEAD 中的最新内容替换掉你的工作目录中的文件。已添加到暂存区的改动以及新文件都不会受到影响。
</p>
<p>
假如你想丢弃你在本地的所有改动与提交，可以到服务器上获取最新的版本历史，并将你本地主分支指向它：<br />
<code>git fetch origin</code><br />
<code>git reset --hard origin/master</code>
</p>
</div>
<a name="hints"></a>
<div class="scrollblock block-hints">
<h2>实用小贴士</h2>
<p>
内建的图形化 git：<br />
<code>gitk</code><br />
彩色的 git 输出：<br />
<code>git config color.ui true</code><br />
显示历史记录时，每个提交的信息只显示一行：<br />
<code>git config format.pretty oneline</code><br />
交互式添加文件到暂存区：<br />
<code>git add -i</code>
</p>
</div>
<a name="resources"></a>
<div class="scrollblock block-resources">
<h2>链接与资源</h2>
<h3>图形化客户端</h3>
<p>
<ul>
<li><a href="http://gitx.laullon.com/">GitX (L) (OSX, 开源软件)</a></li>
<li><a href="http://www.git-tower.com/">Tower (OSX)</a></li>
<li><a href="http://www.sourcetreeapp.com/">Source Tree (OSX, 免费)</a></li>
<li><a href="http://mac.github.com/">GitHub for Mac (OSX, 免费)</a></li>
<li><a href="https://itunes.apple.com/gb/app/gitbox/id403388357?mt=12">GitBox (OSX, App Store)</a></li>
</ul>
</p>
<h3>指南和手册</h3>
<p>
<ul>
<li><a href="http://book.git-scm.com/">Git 社区参考书</a></li>
<li><a href="http://progit.org/book/">专业 Git</a></li>
<li><a href="http://think-like-a-git.net/">像 git 那样思考</a></li>
<li><a href="http://help.github.com/">GitHub 帮助</a></li>
<li><a href="http://marklodato.github.io/visual-git-guide/index-zh-cn.html">图解 Git</a></li>
</ul>
</p>
</div>
<a name="comments"></a>
<div class="scrollblock block-comments">
<h2>评论</h2>
<div id="disqus_thread"></div>
<script type="text/javascript">
/* * * CONFIGURATION VARIABLES: EDIT BEFORE PASTING INTO YOUR WEBPAGE * * */
var disqus_shortname = 'git-the-simple-guide'; // required: replace example with your forum shortname
/* * * DON'T EDIT BELOW THIS LINE * * */
(function() {
var dsq = document.createElement('script'); dsq.type = 'text/javascript'; dsq.async = true;
dsq.src = '//' + disqus_shortname + '.disqus.com/embed.js';
(document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(dsq);
})();
</script>
<noscript>启用 JavaScript 才能查看 <a href="http://disqus.com/?ref_noscript">Disqus 提供的评论。</a></noscript>
</div>
<a href="http://www.git-tower.com/?source=rd" onClick="recordOutboundLink(this, 'Outbound Links', 'git-tower.com');return false;" class="tower"></a>
<a href="files/git_cheat_sheet.pdf" onClick="recordOutboundLink(this, 'Cheat Sheet', 'git-guide');return false;" class="cheatsheet"></a>
</body>
</html>