Git/GitHub基本教学

edgewalker

一、安装 Git & 基本配置
1. 安装 Git
（1）Windows：到官网下载安装包：https://git-scm.com/
（2）macOS：1）可以用 brew install git（如果你装了 Homebrew）
                        2）或者同样去官网安装。
（3）Linux：常见发行版直接用包管理器，例如：

1. sudo apt-get install git
   

复制代码

安装完成后，打开终端 / 命令行，输入：

1. git --version
   

复制代码

能看到版本号，就说明安装成功。
2. 配置用户信息
Git 会在每一次提交中记录“是谁提交的”，所以我们要先配置用户名和邮箱：

1. git config --global user.name "你的名字"
   
2. git config --global user.email "你的邮箱@example.com"
   

复制代码

查看当前配置：

1. git config --list
   

复制代码

二、关键概念
1. Repository（仓库）：存放代码和版本记录的地方。
（1）本地仓库：在你电脑上的 Git 仓库
（2）远程仓库：在 GitHub 上的仓库
2. Commit（提交）：一次版本记录，相当于给当前改动拍了个“快照”。
3. Branch（分支）：在同一个项目里开出不同的开发线，比如 main 分支、dev 分支。
4. Remote（远程）：远程仓库的别名，GitHub 的默认远程名字一般叫 origin。
三、本地 Git 基本操作
1. 初始化一个本地仓库
在项目文件夹里打开终端，然后执行：

1. git init
   

复制代码

这个命令会在当前目录生成一个隐藏的 .git 文件夹，说明这里已经是一个 Git 仓库了。
2. 查看当前状态

1. git status
   

复制代码

3. 把文件加入暂存区（stage）
例如你新建了 main.py：

1. git add main.py
   

复制代码

如果你想把所有改动都加入：

1. git add .

复制代码

4. 执行一次提交

1. git commit -m "第一次提交：初始化项目"
   

复制代码

-m 后面是这次提交的说明，建议写清楚一点，方便以后回看。
5. 查看提交历史

1. git log
   

复制代码

简化显示：

1. git log --oneline
   

复制代码

四、认识 GitHub
GitHub 是一个托管代码的平台，你可以把本地 Git 仓库“推”上去：
（1）作为备份
（2）作为开源项目
（3）用来和别人协作开发
1. 注册 GitHub 账号到 https://github.com 注册一个账号，登录后就可以创建仓库了。2. 创建一个新仓库

• 登录后，右上角点击 “+” → New repository
• 填写：
  
  
  • Repository name：仓库名字，例如 git-tutorial-demo
  • Description：可填可不填
  • Public / Private：公开还是私有
    
    
• 点击 Create repository
  
  

创建成功后，你会看到类似这样的页面，上面有一段提示代码，比如：

git remote add origin https://github.com/你的用户名/git-tutorial-demo.git
git branch -M main
git push -u origin main

这几行是等下要用来“关联并推送”的。

五、从 GitHub 克隆（clone） 到本地

1. 复制仓库地址

在 GitHub 仓库页面：

（1）点击绿色的 Code 按钮

（2）下方选择 HTTPS

（3）复制那个类似这样的地址：https://github.com/你的用户名/仓库名.git

2. 在本地执行 clone
选择一个你想放项目的目录，比如 ~/Projects，在该目录打开终端：

git clone https://github.com/你的用户名/仓库名.git

执行完成后，本地会多一个同名文件夹：

cd 仓库名

现在你就已经把 GitHub 上的代码完整下载到本地了，这个本地仓库已经自动和远程 origin 关联好了。
六、从本地同步到 GitHub（push & pull）
场景 A：本地新建项目，然后推到 GitHub
（1）在本地新建一个项目目录，并初始化：

mkdir my-project
cd my-project
git init

（2）新建一些代码文件，比如 main.py，然后：

git add .
git commit -m "初始化项目"

（3）在 GitHub 上 先创建一个空仓库（不要勾选初始化 README、.gitignore、license 会更干净一点）。
（4）在 GitHub 仓库页面复制仓库地址，然后在本地执行：

git remote add origin https://github.com/你的用户名/my-project.git
git branch -M main      # 把当前分支改名为 main（如果不是的话）
git push -u origin main

remote add origin：添加一个名为 origin 的远程仓库
push -u origin main：把本地 main 分支推到 origin，以后可以直接 git push 不写那么长
（5）以后每次修改，只需要走这三步：

git add .
git commit -m "描述这次修改"
git push

场景 B：已经 clone 下来，日常同步流程
你之前已经 git clone 过，那么日常流程就是：
（1）先拉取远程最新代码（防止别人已经改过）：

git pull

（2）修改代码，完成后：

git add .
git commit -m "说明本次改动"
git push

七、常用同步命令

（1）查看远程仓库：

git remote -v

（2）从远程拉取最新代码并合并到当前分支：

git pull

（3）把当前分支推送到远程（首次使用 -u 绑定）：

git push -u origin main

（4）绑定后就可以简化为：

git push

（5）只拉取但不合并：

1. git fetch
   

复制代码