入门指南：利用GitHub Desktop进行文档版本管理_github文档管理系统

最近有小伙伴问到，她想搭建一个Github，做文档开发项目，但是自己不懂代码，不知道如何下手。借此机会，我们给出一份全面的新手指南，利用GitHub Desktop界面来帮助大家使用GitHub搭建一个自己的文档版本管理的仓库。

Git和GitHub

在使用之前，让我们应该先区分一下Git和Github。

• Git 是一个免费的开源分布式版本控制系统，采用了分布式的方式来支持数据的版本控制和管理。

• Github 是一个用Git做版本控制的项目托管平台。提供了远程仓库和协作工具，让你能够与他人分享和协作你的项目。既然它是一个托管平台，那同样就会存在其它的托管平台，比如中国的码云（Gitee）等很多平台。

这两者大致上分清楚了之后我们就来正式地配置一下Git的环境。

创建GitHub账户

1. 打开浏览器，访问 GitHub。

注意:

因为GitHub服务器在国外，所以会出现访问速度慢或连接不太稳定的情况，可以尝试多试几次。

2. 点击右上角的 “Sign up” 按钮，并按照提示创建一个新的账户。

新建仓库Repository

为了便于没有计算机背景的小伙伴理解和操作，我们不选择使用Git命令行工具，而是使用GitHub官方推出的GUI工具GitHub Desktop来进行演示，https://desktop.github.com。

1. 下载完成并登录后，点击左上角的绿色按钮 「Files」-> 「New repository」来新建一个仓库。

2. 在跳出的页面中，填写以下条目：

其中：

• 「Repository name」是必填项，我们这里填上Rayhe-consult。

• 「Git ignore」主要用于忽略不需要上传到 GitHub 仓库的文件或文件夹，这里我们可以暂时不管。

• 「License」是指GitHub提供了多种常见的许可证供您选择，每个许可证都有自己的规则和限制，许可证定义了您的代码如何被使用和分发。我们这里先选择None.

3. 以上都填写完毕后，点击「Create Repository」新建仓库。

到这里，我们的一个私有仓库Rayhe-consult就算建立完成了。

写入新内容

在这个新建的仓库里，我们试着新建文件，并填入一些内容。这里的文件内容一般默认是Markdown格式。

1. 在GitHub Desktop里，选中当前的仓库，直接用VS  Code来编辑。

2. 在打开VS code的页面中的RAYHE-CONSULTGH下面, 点击右面新文档图标，创建一个新文件，取名NewFile。

3. 在新文件NewFile里，输入一些内容，如右图红框所示。然后点击保存。

4. 回到GitHub Desktop界面，新增内容会自动显示出来，点击左下方Commit to main.

5. 推送内容到远程仓库 (origin)， 如下图的两个箭头指的方向，点击哪一个都可以实现推送。

Clone仓库

Clone操作可以将文件从远程仓库下载到本地，从而形成一个本地仓库。

1. 打开GitHub Desktop。

2. 在「Files」里点击选择「Clone Repository」。

3. 这里会列出你的在线仓库列表，选择一个你要Clone到本地的仓库，这里我们选”Github-hardworking”仓库：

4. 选默认的本地路径就行了，然后点击「Clone」。

完成之后，本地就下载了一份GitHub/hardworking上的仓库内容了。

修改并提交文件

我们还以刚刚新建的NewFile文件为例来展示，展示如何修改并提交文件。

1. 打开GitHub Desktop。

2. 选中当前仓库“Rayhe-consult”, 右边点击“Open in Visiual Studio Code”。

3. 在VS Code中，选到对应仓库下面文件NewFile。

4. 用VS Code打开，做好修改。然后保存。

• 新加第6行。

• 删除第10，11行。

5. 回到GitHub Desktop，你会看到文件的变化已经自动显示出来了。

• 红色为删除的部分。

• 绿色是新加的部分。

• 左侧的「Changes」栏，可以看到gitattributes文件的右侧有一个黄色的小点，这代表这个文件是发生了修改，在git里颜色的标识如下：

6. 填写相关信息，其中：

• Summary是必填项，一般会自动生成。

• Description是选填的，它是对你所做修改的详细描述。

7. 点击Commit to main。

一旦你提交了之后，就会回到仓库的主界面。注意这里的Commit只是提交了修改的内容，并没有将这些提交推送 (push) 到远程仓库 (origin)。

8. 推送内容到远程仓库 (origin)， 如下图的两个箭头指的方向，点击哪一个都可以。

这样，你最新修改的一版就提交到远程仓库 (origin)上了。

做完这一步，相信你对Git上面新建文件和修改文件的操作已经有了最基础的了解了，对GitHub的认识有没有感觉慢慢清晰起来？接下来我们将会在后面几期的文章里，陆续推出一些其他操作介绍，欢迎大家持续关注小锐大佳【锐合佳一，专注技术文档开发】！