Git 远程协作实战：仓库关联、推送与标签管理详解

克隆/下载远端仓库到本地，使用 git clone 命令，后面跟上远端仓库链接。链接可在仓库页面选择'克隆/下载'获取。克隆后会自动关联远程仓库（默认为 origin）。

SSH 协议和 HTTPS 协议是 Git 最常用的两种数据传输方式。SSH 使用了公钥加密，安全性高，但需将公钥上传至服务器；HTTPS 则直接可用，无需额外配置。

• 使用 HTTPS 方式：

$ git clone https://gitee.com/huang-qiruiqq/git_studying.git
Cloning into 'git_studying'...
remote: Enumerating objects: 7, done.
remote: Counting objects: 100% (7/7), done.
remote: Compressing objects: 100% (7/7), done.
remote: Total 7(delta 0), reused 0(delta 0), pack-reused 0(from 0)
Unpacking objects: 100% (7/7), done.

• 使用 SSH 方式：

$ git clone [email protected]:huang-qiruiqq/git_studying.git
Cloning into 'git_studying'...
The authenticity of host'gitee.com (180.76.198.77)' can't be established.
ECDSA key fingerprint is SHA256:FQGC9Kn/eye1W8icdBgrQp+KkGYoFgbVr17bmjey0Wc.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added 'gitee.com,180.76.198.77' (ECDSA) to the list of known hosts.
Permission denied (publickey).
fatal: Could not read from remote repository.
Please make sure you have the correct access rights and the repository exists.

若使用 SSH 方式克隆失败，提示权限拒绝，说明未添加公钥。需要按以下步骤配置：

第一步：创建 SSH Key。 检查用户主目录下是否有 .ssh 目录及 id_rsa 和 id_rsa.pub 文件。若无，执行以下命令生成：

# 注意输入自己的邮箱，一路回车使用默认值即可
$ 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): 
Your identification has been saved in /home/user/.ssh/id_rsa.
Your public key has been saved in /home/user/.ssh/id_rsa.pub.

生成的 id_rsa 是私钥，切勿泄露；id_rsa.pub 是公钥，可放心提供。

第二步：添加公钥到远端仓库。 查看并复制公钥内容：

$ cat .ssh/id_rsa.pub
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDezcher5w+wG77fpWiuGWo8Mofpl3yDe3vUcCWBRG71WxCKrvCmJt4c5pbH+y+1eG4nvhwG9n/WGZOH5/8rVMrKQfksENGKg5GLbEwx+8CQqgdHDHC0CyHZevRRBx7qHQwlj0TjuyId1IK18cuGPV4F4hOCCS+hkey2Wd+5A/4kLyf6U5JCnEqcbtOvdZXxK3JlnoUI2RZ5nqRJ6l1pFn6m3ZxsILLdCVbMut4MLgD1UB/Y1O6Vu+lcsgRsf3HoDAxkh3j86foJLg7Xr7Mg6XdUotWxQ98VlKxbNASE5fKYJFlMPOmNmtFz0zl+zMLyUVg0+iztkBKgRH5oGlgtQXb [email protected]

将上述内容粘贴到 Gitee/GitHub 的 SSH Key 设置中保存。再次尝试克隆即可成功。

克隆完成后，Git 自动将本地 master 分支与远程 master 分支对应，远程仓库默认名称为 origin。可使用 git remote 查看远程库信息：

$ cd ./git_studying
$ git remote origin
# 或使用 -v 显示更详细信息
$ git remote -v
origin [email protected]:huang-qiruiqq/git_studying.git (fetch)
origin [email protected]:huang-qiruiqq/git_studying.git (push)

三、向远程仓库推送和拉取远程仓库的操作

3.1 向远程仓库推送

本地 clone 成功后，可向仓库提交内容。例如新增一个 file.txt 文件：

# 新建文件
$ nano file.txt
hello git
# 提交文件
$ git add .
$ git commit -m "create file.txt"
[master db072d6] create file.txt 1 file changed, 1 insertion(+)

提交时需注意，全局配置的 name 和 email 需与远程平台一致，否则可能报错。若未配置过，首次提交会提示，需重新配置。

将本地内容推送至远程，使用 git push 命令。该命令用于将本地分支版本上传到远程并合并。

# 格式：git push <远程主机名><本地分支名>:<远程分支名>
# 如果本地与远程分支名相同，可省略冒号
$ git push origin master:master
Counting objects: 4, done.
Delta compression using up to 2 threads.
Writing objects: 100% (3/3), 274 bytes | 0 bytes/s, done.
Total 3(delta 1), reused 0(delta 0)
remote: Powered by GITEE.COM [1.1.5]
To [email protected]:huang-qiruiqq/git_studying.git
59ec3c5..db072d6 master -> master

推送成功！使用 SSH 协议无需每次输入密码，比 HTTPS 更方便。此时查看远程仓库，代码已同步更新。

3.2 拉取远程仓库

从远程获取最新代码并合并到本地，避免本地落后导致冲突。常用命令有 git fetch（仅获取不合并）和 git pull（获取并合并）。这里主要讲解 git pull。

注意：实际使用中不要在远程仓库上直接修改内容，应通过拉取合并来保持同步。

假设在 Gitee 上修改了 file.txt 并提交了新版本。此时远程领先本地，需拉取代码：

# 拉取远程分支，并与当前分支进行合并
$ git pull origin master
remote: Enumerating objects: 5, done.
remote: Counting objects: 100% (5/5), done.
remote: Compressing objects: 100% (2/2), done.
remote: Total 3(delta 1), reused 0(delta 0), pack-reused 0(from 0)
Unpacking objects: 100% (3/3), done.
From gitee.com:huang-qiruiqq/git_studying
 * branch master -> FETCH_HEAD
Updating db072d6..0d64ce5 Fast-forward
file.txt | 1 + 1 file changed, 1 insertion(+)

拉取成功后，本地文件内容与远程保持一致。

四、忽略特殊文件以及给命令配置别名

4.1 忽略特殊文件：.gitignore 配置

日常开发中，有些文件不应提交到远端，如包含数据库密码的配置文件。在工作区根目录下创建 .gitignore 文件，填入要忽略的文件名，Git 便会自动忽略。

创建仓库时也可勾选模板自动生成，或在后续手动创建。例如忽略所有 .so 和 .ini 结尾的文件：

# My configurations:
*.ini
*.so

最后将 .gitignore 提交到远端：

$ nano .gitignore
$ git add .
$ git commit -m "add .gitignore"
$ git push origin master

验证 .gitignore 是否生效，可在工作区新建被忽略的文件（如 a.so, b.ini），运行 git status 应显示 working tree clean。

若需强制添加被忽略的文件，可使用 -f 参数：

$ git add -f [filename]

若规则有误，可用 git check-ignore 检查：

$ git check-ignore -v a.so
.gitignore:5:*.so
a.so

Git 会告知哪行规则忽略了该文件。此外，若规则排除了隐藏文件（如 .*），可将 .gitignore 本身排除在外：

# 排除所有.开头的隐藏文件
.*
# 不排除.gitignore
!.gitignore

4.2 给命令配置别名

Git 支持对长命令配置别名，简化操作。例如将 git status 简化为 git st：

$ git config --global alias.st 'status'
$ git st
# On branch master nothing to commit, working directory clean

再配置一个 git lpa 实现简洁的日志查看：

$ git log --pretty=oneline --abbrev-commit
97a0741 add .gitignore
0d64ce5 update file.txt
...
$ git config --global alias.lpa 'log --pretty=oneline --abbrev-commit'
$ git lpa
97a0741 add .gitignore
0d64ce5 update file.txt
...

建议初期尽量手动完成命令，熟悉后再使用别名优化工作流。

五、标签管理：给重要版本'打标记'

标签（tag）是对某次提交的别名（如 v1.0），比复杂的 commit ID 更易记忆，适合标记发布版本。

5.1 创建标签

切换到目标分支，使用 git tag [name] 打新标签，并用 git tag 查看所有标签：

$ git branch
* master
$ git tag v1.0
$ git tag
v1.0

默认标签打在最新提交上。若需在指定 commit 上打标签，找到历史提交的 commit ID：

# 历史记录
$ git log --pretty=oneline --abbrev-commit
97a0741 add .gitignore
0d64ce5 update file.txt
59ec3c5 Initial commit

# 对 update file.txt 这次提交打标签
$ git tag v0.9 0d64ce5
$ git tag
v0.9
v1.0

标签按字母排序。可用 git show [tagname] 查看标签详情：

$ git show v1.0
commit 97a07417c4ad9b4d94001dfce01b954dfec4c4a2
Author: User <[email protected]>
Date:   Wed Nov 5 16:39:08 2025 +0800
    add .gitignore

创建带说明的标签：

$ git tag -a v1.0 -m "Release version 1.0"

5.2 操作标签

标签默认存储在本地，不会自动推送到远程。打错的标签可在本地安全删除：

$ git tag -d v0.9
Deleted tag 'v0.9'(was 0d64ce5)

推送单个标签到远程：

$ git push origin v1.0
remote: Powered by GITEE.COM [1.1.5]
To [email protected]:huang-qiruiqq/git_studying.git
 * [new tag] v1.0 -> v1.0

一次推送所有标签：

$ git push origin --tags

若标签已推送到远程，删除时需先从本地删，再从远程删：

# 本地删除
$ git tag -d v1.0
# 远程删除
$ git push origin :refs/tags/v1.0
remote: [deleted] v1.0

结语

Git 远程操作的核心是'数据同步'——通过 push 和 pull 实现本地与远程的双向流转，通过 .gitignore 和标签管理保证代码整洁与版本清晰。掌握这些操作，不仅能实现单人跨设备开发和代码备份，更能为后续多人协作打下坚实基础。