Git 远程仓库管理指南

1. Merge（普通合并，保留提交历史）。
2. Squash and Merge（压缩为一个提交，适合多个小提交）。
3. Rebase and Merge（变基合并，保持线性历史）。

（4）创建 Pull Requests 合并请求

2 克隆远程仓库

SSH 协议和 HTTPS 协议是 Git 最常用的两种数据传输协议：SSH 协议使用了公钥加密和公钥登陆机制，体现了其实用性和安全性，使用此协议需要将我们的公钥放上服务器，由 Git 服务器进行管理。使用 HTTPS 方式时，没有要求，可以直接克隆下来。

2.1 git clone

（1）基本语法

// git clone 是 Git 中最基础的命令之一，用于将远程仓库完整地复制到本地。

（2）核心功能

1. 复制远程仓库到本地
2. 自动创建远程跟踪分支 (origin/master 等)
3. 自动设置默认检出分支 (通常是 master/main)
4. 自动配置远程仓库别名为 origin

（3）常用选项

2.2 常用用法

（1）基本克隆

git clone https://github.com/user/repo.git

（2）克隆到指定目录

git clone https://github.com/user/repo.git myproject

（3）克隆特定分支

git clone --branch develop https://github.com/user/repo.git

（4）浅克隆 (节省时间/空间)

git clone --depth 1 https://github.com/user/repo.git

（5）克隆并初始化子模块

git clone --recurse-submodules https://github.com/user/repo.git

（6）仅克隆最新代码 (无历史)

git clone --depth 1 --single-branch https://github.com/user/repo.git

2.3 HTTPS 方式

user@host:~/warehouse$ git clone https://gitee.com/username/repo.git
Cloning into 'repo'...
remote: Enumerating objects: 4, done.
remote: Counting objects: 100% (4/4), done.
remote: Compressing objects: 100% (4/4), done.
remote: Total 4 (delta 0), reused 0 (delta 0), pack-reused 0 (from 0)
Receiving objects: 100% (4/4), done.
user@host:~/warehouse$ ls repo

2.4 SSH 方式

user@host:~/warehouse$ git clone [email protected]:username/repo.git
Cloning into 'repo'...
The authenticity of host 'gitee.com (180.76.198.225)' can't be established.
ED25519 key fingerprint is SHA256:+ULzij2u99B9eWYFTw1Q4ErYG/aepHLbu96PAUCoV88.
This key is not known by any other names.
Are you sure you want to continue connecting (yes/no/[fingerprint])?
yes
Warning: Permanently added 'gitee.com' (ED25519) to the list of known hosts.
remote: Enumerating objects: 4, done.
remote: Counting objects: 100% (4/4), done.
remote: Compressing objects: 100% (4/4), done.
remote: Total 4 (delta 0), reused 0 (delta 0), pack-reused 0 (from 0)
Receiving objects: 100% (4/4), done.
user@host:~/warehouse$ ls repo

使用 SSH 方式克隆仓库，由于我们没有添加公钥到远端库中，服务器拒绝了我们的 clone 链接。需要我们设置一下

2.4.1 创建 SSH Key

在用户主目录下（家目录，如：root/），看看有没有.ssh 目录，如果有，再看看这个目录下有没有 id_rsa 和 id_rsa.pub 这两个文件，如果已经有了，可直接跳到下一步

如果没有，需要创建 SSH Key：

# 注意要输入自己的邮箱，然后一路回车，使用默认值即可
ssh-keygen -t rsa -C "[email protected]"
Generating public/private rsa key pair.
Enter file in which to save the key (/home/user/.ssh/id_rsa): Enter passphrase (empty for no passphrase): Enter same passphrase again:
Your identification has been saved in /home/user/.ssh/id_rsa
Your public key has been saved in /home/user/.ssh/id_rsa.pub
The key fingerprint is: SHA256:sepKZUwKIXjJxYcot49tvOW+Aa+pEhdsRqVDFSmgQZo [email protected]
The key's randomart image is: ...

顺利的话，可以在用户主目录里找到 .ssh 目录，里面有 id_rsa 和 id_rsa.pub 两个文件，这两个就是 SSH Key 的秘钥对，id_rsa 是私钥，不能泄露出去，id_rsa.pub 是公钥，可以放心地告诉任何人。

user@host:~/.ssh$ ll
-rw------- 1 user user 2602 Jul 9 16:23 id_rsa
-rw-r--r-- 1 user user 571 Jul 9 16:23 id_rsa.pub
-rw-r--r-- 1 user user 142 Jun 5 10:34 known_hosts

2.4.2 添加公钥

（1）查看自己的公钥

user@host:~/.ssh$ cat id_rsa.pub
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQChaJTTo0+c1x2Bblr1ckpTk/CMNWo3MxrjZhTEzcEu1SFOX+aJNRdq5f/6JWeDaQRSYeniHlja//gIbv8O+nkMur85WKumJ7dsMcSiqwlwtOXCKNlZ49joxEvmLIIk9ND0TecOTzVwpTKj7xkTKX83tuGm05vAJe7AW+P5FHew+o/8wX/4jU82gum3vgvhNAvblTP6Id2pg5HeStidAp0+MWSGgAipR7XQUxqHci/rRcwXu73TR82xvpGyRzedlfomDpeJPO5dZa1gFlJgPjEoDG+e2LGNjEtRzhmb1+nQkDuMRice+6Zebmnyvtm/sIfqknzuJJTGSvZ91gS9xATsXmGd2bPyGJFr6FxXIZoW6jno7j+Pvg85WkBVaJ4cIl+QAOr+XkY6JL7dtgsWtbs6f1mq8aogIuE/cQIkA0DrjnVzJmHQSS6Dx1oTNz4+xy7dtG8jFS+oY8Z+5gujrjAtyMlSyGZpI85MwddujSIvo3pkoA1fpHrdw7zw5DFbTl0= user@host

（2）添加自己的公钥到远程仓库

当我们从远程仓库克隆后，实际上 Git 会自动把本地的 master 分支和远程的 master 分支对应起来，并且，远程仓库的默认名称是 origin。在本地我们可以使用 git remote 命令，来查看远程库的信息

user@host:~/warehouse/repo$ git remote origin

用 git remote -v 显示更详细的信息

user@host:~/warehouse/repo$ git remote -v
origin [email protected]:username/repo.git (fetch)
origin [email protected]:username/repo.git (push)

• fetch：表示当前拥有向远程仓库进行拉取的权限
• push：表示当前拥有向远程仓库进行推送的权限

3 向远程仓库进行推送

3.1 git push

git push 是 Git 中用于将本地分支的提交推送到远程仓库的关键命令

注意事项： 提交时要注意，如果我们之前设置过全局的 name 和 e-mail，这两项配置需要和远程仓库上配置的用户名和邮箱一致，否则会出错。或者从来没有设置过全局的 name 和 e-mail，那么我们第一次提交时也会报错。这就需要我们重新配置下了，同样要注意需要和远程仓库上配置的用户名和邮箱一致。

（1）基本语法

git push [选项] [远程名称] [本地分支名]:[远程分支名]

（2）常用选项

3.2 常用用法

（1）推送当前分支到远程同名分支

git push origin HEAD #或简写 git push

（2）推送特定分支

git push origin 本地分支名：远程分支名

（3）设置上游分支并推送（首次推送推荐）

git push -u origin 分支名 # 之后可以简写为 git push

（4）删除远程分支

git push origin --delete 分支名 # 或 git push origin :分支名

（5）强制推送（谨慎使用）

git push --force origin 分支名 # 更安全的替代方案 git push --force-with-lease origin 分支名

（6）推送标签

git push origin 标签名 # 推送单个标签
git push origin --tags # 推送所有标签

3.3 HTTPS 推送

（1）设置身份信息

git config --global user.name 'username'
git config --global user.email '[email protected]'

（2）推送

在使用 git push 推送到远程仓库时，需要我们输入在远程仓库的 邮箱和密码 确认身份（一定要是克隆仓库所属下的账号和密码）

user@host:~/as-cnet/Git Note$ git push origin master
Username for 'https://gitee.com': [email protected]
Password for 'https://[email protected]@gitee.com':

3.4 SSH 推送

SSH 方式 推送的主要问题在于需要正确的配置 SSH 密钥

（1）设置身份信息

git config --global user.name 'username'
git config --global user.email '[email protected]'

（2）生成密钥

根据提示信息输入内容，密码不需要设置

user@host:~/warehouse$ ssh-keygen -t rsa
Generating public/private rsa key pair.
Enter file in which to save the key (/home/user/.ssh/id_rsa): /home/user/.ssh/id_rsa already exists. Overwrite (y/n)? y
Enter passphrase (empty for no passphrase): Enter same passphrase again:
Your identification has been saved in /home/user/.ssh/id_rsa
Your public key has been saved in /home/user/.ssh/id_rsa.pub
The key fingerprint is: SHA256:umGEFdHZF+/63LHSkHvxHqO7Ay1RFEBrq0tNBvUyPzM user@host
The key's randomart image is: ...

（3）查看密钥

user@host:~/warehouse$ cat ~/.ssh/id_rsa.pub
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQDn4vIafFE+O2vqw6WxuRh+dMNWBiMGtIs4A/WN0Ujdr+neRnxUU6+jXI43yNS3xx0C4V/Tfk7rlvd9ttYe6IsxqcAV6mLijknmMMcXo3CM3uARi+e+CCZv3a8h5qFbz2JmYWHof2oGflIdkSTEcY3zQHaWN4hK4z8Tyto6LZaaTAYiaaLL7UPoWt++FcbXIHkdQs/TeDQuX0uHSPKehv+lrqgERM3DWSc/YhFatwwbBWAQejGTCjl8KacBuP4zrBKQsgdnwgPYnMj61nCAoDA7lPC8UOPO8xiSnmcRcGwwf/0skxc+4sAEODW0vbXILsLejjhK+CgMs7r89LnPOWDD+EDS7pz6s9TQAZ+Qyk46SZBcj94jziWqTyKRfOoZNEmAj+S5j8WS/FkvZR+ksk4BPyZ3gdwOXgUnrdI+QoyTaQs64pGL1yQV5U3JRWknfCsNQF6k4Q8aipAvgyxZBSv4RVz98rJDgYERMy59giH5gZb2/zq+LSXmJVN2JT2+Wyc= user@host

4 向远程仓库进行拉取

4.1 git pull

git pull 是 Git 中用于从远程仓库获取更新并合并到本地分支的重要命令，它实际上是 git fetch 和 git merge 两个命令的组合。

（1）基本语法

git pull [选项] [远程名称] [远程分支名]:[本地分支名]

（2）常用选项

4.2 常用用法

（1）从默认远程仓库拉取当前分支的更新

git pull

（2）从特定远程仓库拉取特定分支

git pull origin 远程分支名

（3）使用变基 (rebase) 方式拉取

git pull --rebase

（4）拉取并自动处理本地未提交的修改

git pull --autostash

（5）拉取特定远程分支到特定本地分支

git pull origin 远程分支名：本地分支名

5 .gitignore

.gitignore 是 Git 版本控制系统中一个特殊的配置文件，用于指定哪些文件或目录应该被 Git 忽略，不纳入版本控制。

5.1 基本语法规则

• 空行：被忽略，可用于分隔
• # 开头：注释
• 标准 glob 模式：
  1. • 匹配任意字符（除了路径分隔符 /）
  2. ? 匹配单个字符
  3. [abc] 匹配括号内的任意一个字符
  4. [0-9] 匹配范围内的字符
• / 开头：防止递归（只忽略当前目录下的文件）
• / 结尾：指定目录
• ! 开头：取反（不忽略）

5.2 常见忽略模式

（1）操作系统生成文件

# macOS .DS_Store ._*
# Windows Thumbs.db Desktop.ini

（2）开发环境文件

# IDE .idea/ .vscode/ *.suo *.ntvs* *.njsproj *.sln *.sw?
# 编辑器 *.swp *.swo *~

（3）语言相关

# Node.js node_modules/ npm-debug.log* yarn-debug.log* yarn-error.log* .pnpm-store/
# Python __pycache__/ *.py[cod] *.so .Python env/ venv/
# Java *.class *.jar *.war *.ear

（4）构建输出

# 通用 dist/ build/ out/ *.exe *.dll *.lib
# Web *.min.js *.min.css

（5）日志文件

*.log logs/