forked from rogerdudler/git-guide
-
Notifications
You must be signed in to change notification settings - Fork 1
/
index.zh.html
237 lines (233 loc) · 12 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
<!DOCTYPE html>
<html lang="en">
<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="css/normalize.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> and <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.it.html">italiano</a>,
<a href="index.nl.html">nederlands</a>,
<a href="index.pt_BR.html">português</a>,
<a href="index.ru.html">русский</a>,
<br/>
<a href="index.my.html">မြန်မာ</a>,
<a href="index.ja.html">日本語</a>,
<a href="index.ko.html">한국어</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://code.google.com/p/git-osx-installer/downloads/list?can=3">下载 git OSX 版</a>
</p>
<p>
<a href="http://code.google.com/p/msysgit/downloads/list?can=3">下载 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="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, open source)</a></li>
<li><a href="http://www.git-tower.com/">Tower (OSX)</a></li>
<li><a href="http://www.sourcetreeapp.com/">Source Tree (OSX, free)</a></li>
<li><a href="http://mac.github.com/">GitHub for Mac (OSX, free)</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.com/visual-git-guide/index-en.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 = 'http://' + disqus_shortname + '.disqus.com/embed.js';
(document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(dsq);
})();
</script>
<noscript>Please enable JavaScript to view the <a href="http://disqus.com/?ref_noscript">comments powered by 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>