Windows 上配置 Git

GitHub 是什么

• GitHub 是怎样一个网站：一个程序托管网站，一个社会化编程平台（Social Coding）
• GitHub 使用 Git 版本控制，Git 作为一个版本控制工具有什么特点：
  • Git 是目前世界上最先进的分布式版本控制系统（没有之一）。
  • 特点是高端大气上档次！（廖雪峰语）
• GitHub 对于程序员的意义：
  • 你要知道 GitHub 被中国的防火长城封锁过几次，在多人联名抗议下才解锁。李开复也发博声援：
  

  GitHub is blocked by GFW

• GitHub 的竞争对手：
  • 国外的 BitBucket，以及
  • 中国的 GitHub 克隆版 GitCafe（已经合并到了 ）

• 现在请注册一个 GitHub 账户（必须的），有账户的请登录

Git 常用流程

• 详细戳 Git 教程：廖雪峰 Git 教程，或者 我的 ProGIT 笔记
• 简单地说 Git 记录了文档的状态和状态间的变动，所有记录项分为三个状态：
  • Modified（修改了）
  • Staged（提交了）
  • Committed（提交确认了）。
• Git 命令分为三个部分：git + 命令 + 参数 等，比如：
  • git clone url 从 url（需要合法的 git repo 才行） 克隆一个副本到本地当前目录
  • git commit -m "message" 把修改提交并记录
• 一个通常的 Git 流程是：
  • git clone git@github.com:district10/new-repo.git
    • 把一个云端 Repo 复制下来
    • 复制别人的 Repo 用 HTTPS 协议，复制自己的 Repo 用 GIT 协议，直接在本地创建一个 Git Repo 则使用 git init
    • 一个 Git Repo 有一些文档来记录变化，他们是隐藏的。
  • git add -A
    • 在每次修改后，修改的文档的状态就从 Clean（Committed） 变成 Modified
    • 使用这个命令把所有内容提交，状态变成 Staged
  • git commit -m "提交记录"
    • 把修改 commit，比如：”修正了一个拼写错误“（Fixed Typo），但这时候只是本地修改好了，云端（GitHub 端）没有同步。
  • git push
    • 把修改同步到云端，最简单地方式就是 git push
    • 多人合作的时候，每次先把本地修改 Commit，再 Push 到 云端。再把别人的修改 git pull 下来。

使用 GitHub 的前提以及一些常识

• 联网的电脑
• 网页登入（在网页上也可以很方便的查看别人代码，克隆别人的 Repo）
• 控制台 SSH 连接（用 SSH 登入方便地同步代码，版本控制）
• 最好学习一下 Markdown 的使用
  • GitHub 上的 README 文档很多都是用 Markdown 写成（以 .md 结尾的文件）
  • 学习 Markdown 可参考我的博客：Markdown 简明教程

• 文档保存时编码请使用 【UTF-8 无 BOM 格式编码】而不是 Windows 默认的 【ANSI 格式编码】，在 Notepad++ 里如下设置：

  

  Notepad++ & UTF-8 encoding

GitHub 教程：Step by Step

Linux 用户，直接敲命令，一行搞定：apt-get install git

Windows 的话……

下载 Git for Windows

Git 需要安装使用，到 Git Scm 下载 Windows 版本：Git for Windows。因下载需要翻墙，这里提供一个备份：Git-2.7.2。

安装 Git for Windows

【1】 双击如下图标（【右键 - 以管理员身份运行】响应更快），开始安装

git for windows

【2】 下一步，同意 GNU General Public License

【3】 选择组件，把 Git Bash Here 和 Git GUI Here 注册到注册表

git bash

【4】 选择 Git Bash，Bash 是一种命令行

git bash

【5】 选择 Git 换行符工作方式（Windows，Unix/Linux，Mac OS 的换行符各不相同）

newline

【6】 安装完成，在资源管理器里右键出现了 Git Bash 和 Git GUI 选项

git bash & git gui

使用 Git Bash

【1】 打开 Git Bash

在某一文件夹下右键单击打开 Git Bash，这是一个命令行环境，就像 Windows 下的 CMD， PowerShell 或者 Linux 下的 Bash，Zsh

【2】 Hello Git Bash

试着输入，echo Hello Git Bash，回车，就有：

hello world

顺便把自己的用户名和邮箱配置一下：（把用户名和邮箱改成自己 GitHub 账号对应的用户名邮箱）

git config --global user.name "<NAME>"
git config --global user.email "<EMAIL>"
git config --global credential.helper "cache --timeout=3600"
# git config --global push.default simple

【3】 克隆一个 GitHub Repository

克隆（Clone）就是把代码复制到本地，到 GitHub 上找个 Repo，比如：https://github.com/alols/xcape

在 Git Bash 里输入 git clone https://github.com/alols/xcape，回车，就有：

git clone

【4】 配置 SSH

首先打开 Git Bash（不论在哪个文件夹都行），然后输入 cd ~/.ssh 把目录跳转到自己用户的 .ssh 目录下；（如果失败，则输入 cd ~ && mkdir .ssh && cd .ssh）

输入 ls （打印目录）应该输出为空；

输入 ssh-keygen.exe -t rsa -C "your-email" （换成你的邮箱），回车，有：

ssh-keygen

等待你输入目录，直接使用默认的，回车即可；

等待你输入密码，可以不设置（方便自己），回车两次即可；

然后 SSH 密钥公钥就生成好了，用 ls 看一下（输入 ls)，查看 生成的公钥，并拷贝到剪贴板：

到 GitHub 里设置 SSH，如下：

【Step 1】

【Step 2】

保存好就可以了。

编辑器选择

Geek 的编辑器有 Emacs，Vim，但是推荐大家使用 Notepad++（尤其是在 Windows 上），这个编辑器简单好用。而且有便携版，解压即可使用。

这里提供一个 Portable 版本下载： http://download.tuxfamily.org/notepadplus/6.6.8/npp.6.6.8.bin.7z

在 GitHub 上新建一个 Repo

【1】

首先去 GitHub 主页 https://github.com ，在右上角点击 New Repository

new repository

【2】

然后输入新 Repo 的名称，输入 Repo 说明，选择 Public（Private 要收费），勾选生成 README 文档，选择一个 .gitignore 文件（也可不选），选择一个协议，这里我选了 GPL v3，整个如下：

这样，就在 GitHub 上新建了一个 Repo，如下：

【3】

然后把这个 Repo 用 Git 克隆下来，先到如上图右下角，复制 SSH 链接：

git@github.com:district10/new-repo.git（复制自己的 Repo 用 SSH，别人的用 HTTPS）

然后到本地目录，比如这个 github 文件夹下，右键打开 Git Bash，输入

git clone git@github.com:district10/new-repo.git

如图：

右键打开 Git Bash

git clone git@github.com:district10/new-repo.git

克隆好后当前文件夹下就有了 new-repo 文件夹，如图：

【4】

进入文件夹，用 Notepad++ 打开 README.md 文件：

open README.md

简单地修改，添加一行 “【这是新入的一行。来自 Notepad++】”：

edit README.md

然后在 new-repo 文件夹打开 Git Bash 提交修改并 Push 到 GitHub：

再到自己的 GitHub 上，查看，发现修改已经提交上去了：

save & add && commit && push

【完】

这就是在 GitHub 上新建一个 Repo 的过程。以后修改之后，再

git add -A # 与 git add README.md 不同的是，这个命令一次添加所有修改了的文档
git commit -m "Msg"
git push

即可把代码同步到 GitHub。Git 在编写代码时可以很好的控制版本，深入的学习，可以参考 最好的 Git 进阶材料。

附录

为什么要学习 Git

• XDite 的博文：有效提升大學生競爭力 – 用 Git Pull Request 收作業
• 合作（哪怕最开始是打打杂）：added an empty line before quotation by district10 · Pull Request #20 · sparanoid/chinese-copywriting-guidelines

文档撰写与 Coding 规范

• 写博客，撰写文档通用规范
• Coding 规范

如有疑问

如有疑问请到 Issue 提问：

一些笔记

展示 GitHub Pages 怎么用 by district10

教你如何在 GitHub 上用弄一个简单的展示页面。

如何在 GitHub 上 Contributing（贡献），一个简单流程：

1. Fork it!
2. Create your feature branch: git checkout -b my-new-feature
3. Commit your changes: git commit -am 'Add some feature'
4. Push to the branch: git push origin my-new-feature
5. Submit a pull request and enjoy! :D

一个更加详细的流程：

webogram/CONTRIBUTING.md at master · zhukov/webogram

Refs

1. whudoc/github-guide

• git
• github
• windows