编程马·菜鸟教程

Appearance

第6章：远程仓库基础 ​

6.1 远程仓库认知 ​

什么是远程仓库 ​

远程仓库是存储在网络或其他位置的 Git 仓库，用于团队协作和代码备份。它是 Git 分布式版本控制系统的重要组成部分。

核心作用：

  • 代码共享：让团队成员共享代码
  • 备份：作为代码的远程备份
  • 协作：支持多人同时开发
  • 代码审查：通过 Pull Request 进行代码审查
  • 版本发布：管理不同版本的发布

常用远程仓库平台 ​

平台特点适用场景
GitHub全球最大的代码托管平台，开源项目多开源项目、个人项目
Gitee国内代码托管平台，访问速度快国内项目、企业内部项目
GitLab可私有化部署，功能丰富企业内部项目、需要私有部署的场景
Bitbucket与 Jira、Confluence 集成与 Atlassian 工具链集成的项目

6.2 主流远程仓库平台使用 ​

GitHub 使用指南 ​

账号注册与登录 ​

  1. 访问 GitHub 官网
  2. 点击 "Sign up" 注册账号
  3. 填写邮箱、密码、用户名等信息
  4. 完成邮箱验证
  5. 登录 GitHub 账号

新建远程仓库 ​

  1. 登录 GitHub 账号
  2. 点击右上角的 "+" 按钮，选择 "New repository"
  3. 填写仓库信息：
    • Repository name：仓库名称
    • Description：仓库描述（可选）
    • Public/Private：选择仓库 visibility
    • Initialize this repository with a README：是否初始化 README 文件
    • Add .gitignore：选择适合项目的 .gitignore 模板
    • Choose a license：选择开源许可证
  4. 点击 "Create repository" 按钮

远程仓库基本操作 ​

查看仓库：

  • 登录 GitHub 账号
  • 在 "Your repositories" 中找到并点击仓库名称

编辑仓库：

  • 进入仓库页面
  • 点击 "Settings" 标签
  • 可以修改仓库名称、描述、visibility 等设置

删除仓库：

  • 进入仓库页面
  • 点击 "Settings" 标签
  • 滚动到底部，点击 "Delete this repository"
  • 输入仓库名称确认删除

Gitee 使用指南 ​

账号注册与登录 ​

  1. 访问 Gitee 官网
  2. 点击 "注册" 按钮
  3. 填写用户名、邮箱、密码等信息
  4. 完成邮箱验证
  5. 登录 Gitee 账号

新建远程仓库 ​

  1. 登录 Gitee 账号
  2. 点击右上角的 "+" 按钮，选择 "新建仓库"
  3. 填写仓库信息：
    • 仓库名称：仓库名称
    • 路径：仓库访问路径
    • 描述：仓库描述（可选）
    • 是否开源：选择仓库 visibility
    • 初始化仓库：选择是否初始化 README、.gitignore、license
  4. 点击 "创建"

远程仓库基本操作 ​

查看仓库：

  • 登录 Gitee 账号
  • 在 "我的仓库" 中找到并点击仓库名称

编辑仓库：

  • 进入仓库页面
  • 点击 "管理" 标签
  • 可以修改仓库名称、描述、visibility 等设置

删除仓库：

  • 进入仓库页面
  • 点击 "管理" 标签
  • 点击 "删除仓库"
  • 输入 Gitee 密码确认删除

6.3 本地仓库与远程仓库关联 ​

git remote 命令 ​

功能：管理远程仓库连接

用法：

bash
# 查看远程仓库配置
git remote -v

# 添加远程仓库
git remote add <远程仓库名称> <远程仓库地址>

# 修改远程仓库地址
git remote set-url <远程仓库名称> <新的远程仓库地址>

# 删除远程仓库
git remote remove <远程仓库名称>

# 重命名远程仓库
git remote rename <旧名称> <新名称>

示例：

bash
# 添加远程仓库
git remote add origin https://github.com/username/repository.git

# 查看远程仓库配置
git remote -v

# 修改远程仓库地址
git remote set-url origin https://github.com/username/new-repository.git

关联步骤 ​

  1. 创建本地仓库（如果还没有）

    bash
    mkdir my-project
cd my-project
git init
echo "# My Project" > README.md
git add README.md
git commit -m "Initial commit"

  2. 在 GitHub/Gitee 上创建远程仓库

    • 按照前面的步骤创建远程仓库

  3. 关联本地仓库与远程仓库

    bash
    # 添加远程仓库
git remote add origin <远程仓库地址>

  4. 验证关联

    bash
    git remote -v

6.4 远程仓库核心命令 ​

git push：将本地代码推送到远程仓库 ​

功能：将本地分支的提交推送到远程仓库

用法：

bash
# 推送当前分支到远程仓库
git push <远程仓库名称> <本地分支名>:<远程分支名>

# 推送当前分支到远程仓库（简写）
git push

# 推送所有分支到远程仓库
git push --all

# 推送标签到远程仓库
git push --tags

# 强制推送（谨慎使用）
git push -f

示例：

bash
# 推送 main 分支到 origin 远程仓库
git push origin main

# 推送当前分支到远程仓库
git push

# 推送所有分支到远程仓库
git push --all

git pull：将远程代码拉取到本地 ​

功能：从远程仓库拉取代码并合并到本地分支

用法：

bash
# 从远程仓库拉取并合并到当前分支
git pull <远程仓库名称> <远程分支名>:<本地分支名>

# 从远程仓库拉取并合并到当前分支（简写）
git pull

# 从远程仓库拉取但不合并
git pull --no-commit

示例：

bash
# 从 origin 远程仓库拉取 main 分支并合并到当前分支
git pull origin main

# 从远程仓库拉取并合并到当前分支
git pull

git fetch：查看远程仓库更新 ​

功能：从远程仓库获取最新代码，但不自动合并

用法：

bash
# 获取所有远程仓库的更新
git fetch

# 获取指定远程仓库的更新
git fetch <远程仓库名称>

# 获取指定远程分支的更新
git fetch <远程仓库名称> <远程分支名>

示例：

bash
# 获取所有远程仓库的更新
git fetch

# 获取 origin 远程仓库的更新
git fetch origin

# 查看远程分支与本地分支的差异
git diff main origin/main

# 合并远程分支到本地分支
git merge origin/main

6.5 远程仓库实操案例 ​

本地代码推送 ​

操作步骤：

  1. 创建本地仓库

    bash
    mkdir git-demo
cd git-demo
git init
echo "# Git Demo" > README.md
git add README.md
git commit -m "Initial commit"

  2. 在 GitHub 上创建远程仓库

    • 登录 GitHub
    • 创建一个名为 "git-demo" 的仓库

  3. 关联本地仓库与远程仓库

    bash
    git remote add origin https://github.com/username/git-demo.git

  4. 推送本地代码到远程仓库

    bash
    git push -u origin main

  5. 验证推送结果

    • 登录 GitHub，查看仓库页面，确认代码已推送

远程代码拉取 ​

操作步骤：

  1. 克隆远程仓库

    bash
    git clone https://github.com/username/git-demo.git
cd git-demo

  2. 修改远程仓库代码

    • 登录 GitHub，编辑 README.md 文件，添加一些内容
    • 提交修改

  3. 拉取远程代码到本地

    bash
    git pull

  4. 验证拉取结果

    bash
    cat README.md

6.6 远程仓库访问权限设置 ​

个人仓库权限 ​

GitHub：

  1. 进入仓库页面
  2. 点击 "Settings" 标签
  3. 点击 "Manage access"
  4. 点击 "Invite a collaborator"
  5. 输入 collaborator 的 GitHub 用户名或邮箱
  6. 选择权限级别（Read、Write、Admin）
  7. 点击 "Add < username> to this repository"

Gitee：

  1. 进入仓库页面
  2. 点击 "管理" 标签
  3. 点击 "仓库成员管理"
  4. 点击 "添加成员"
  5. 输入成员的 Gitee 用户名
  6. 选择权限级别（Owner、Maintainer、Developer、Reporter、Guest）
  7. 点击 "添加"

团队仓库权限 ​

GitHub：

  1. 创建一个团队
  2. 进入仓库页面
  3. 点击 "Settings" 标签
  4. 点击 "Manage access"
  5. 点击 "Teams"
  6. 点击 "Add teams"
  7. 选择团队并设置权限级别

Gitee：

  1. 创建一个组织
  2. 将仓库转移到组织
  3. 进入组织页面
  4. 点击 "成员管理"
  5. 添加成员并设置角色
  6. 进入仓库页面
  7. 点击 "管理" 标签
  8. 点击 "仓库成员管理"
  9. 为组织成员设置仓库权限

通过本章的学习，你已经掌握了远程仓库的基本操作。远程仓库是团队协作的重要工具，它使得多人开发成为可能。接下来，我们将学习团队协作的具体流程。

© 2026 编程马·菜鸟教程 版权所有

基于 VitePress 构建