Gitee是什么？快速入门指南 – wiki基地

作者： /

Gitee 是什么？最全面的解析与快速入门指南

在当今软件开发领域，版本控制系统的重要性不言而喻。而基于 Git 的代码托管平台，更是开发者们进行协作、管理项目、分享创意不可或缺的工具。提到这类平台，很多人首先想到的是 GitHub 或 GitLab。然而，在中国本土，一个同样强大且更贴近国内开发者需求的平台正在蓬勃发展，它就是 Gitee（码云）。

本文将带你深入了解 Gitee：它是什么，为何诞生，有哪些核心功能，以及如何快速上手使用它进行代码托管与协作。无论你是刚接触编程的新手，还是寻求更高效、更合规本土平台的资深开发者，这篇文章都将为你提供有价值的信息。

第一部分：Gitee 是什么？全面解析

1. Gitee 的定义与起源

Gitee，中文名称为码云，是由开源中国（OSCHINA）社区于 2013 年推出的基于 Git 的代码托管平台。简单来说，它是一个在线服务，提供代码仓库的创建、存储、管理和协作功能。开发者可以将本地使用 Git 进行版本控制的项目同步到 Gitee 上，实现代码的云端备份、多人协同开发、项目管理以及代码分享。

与国际知名的代码托管平台 GitHub、GitLab 等类似，Gitee 提供了核心的 Git 功能，包括仓库管理、分支管理、版本回溯等。但作为本土平台，Gitee 在服务中国开发者方面有着独特的优势和侧重点。

开源中国（OSCHINA）本身是中国一个大型的开发者社区，长期致力于推广和发展中国的开源事业。Gitee 作为其旗下的核心产品，自然也继承了这一使命，积极推动本土开源项目的托管和交流。

2. 为何需要 Gitee？Gitee 的价值与定位

在全球化背景下，为何还需要一个本土的代码托管平台？Gitee 的出现和发展，主要源于以下几个方面的需求和考量：

  • 本土化服务与用户体验： Gitee 提供全中文界面和文档，更符合中国开发者习惯。服务器部署在国内，访问速度更快，延迟更低，尤其对于企业用户，稳定高速的访问是生产力的重要保障。
  • 合规性与数据安全： 对于中国的企业和政府机构而言，将敏感或重要的代码托管在境外的平台上可能存在数据安全和合规性风险。Gitee 作为本土平台，能更好地满足国内法规要求，提供更可控的数据存储和管理方案。
  • 专注于中国开源生态： Gitee 积极扶持中国本土的开源项目，提供特色服务如“Gitee 开源项目”推荐、排行榜等，有助于提高中国开源项目的可见度和影响力，促进本土开源社区的繁荣。
  • 企业级解决方案： Gitee 不仅服务于个人开发者和开源项目，还提供了强大的企业版和私有化部署方案，满足企业在代码管理、项目协作、权限控制等方面的复杂需求。
  • 与国内生态系统的集成： Gitee 更容易与国内的云服务、CI/CD 工具、项目管理工具等进行集成，构建符合国情的开发工作流。

因此，Gitee 的定位是成为中国领先的、安全可靠的、专注于本土开发者和开源生态的代码托管与协作平台。

3. Gitee 的核心功能深度解析

Gitee 提供了丰富的功能集，覆盖了软件开发的整个生命周期。以下是其一些核心功能的详细介绍：

  • 代码仓库 (Repository)： 这是 Gitee 的基础。你可以创建公共或私有的 Git 仓库，存储项目的源代码、文档、配置文件等所有相关文件。Gitee 提供了直观的界面来浏览文件、查看提交历史、管理分支和标签。

    • 仓库主页： 展示项目代码、README 文件、最近提交、贡献者列表等。
    • 文件浏览： 在线查看代码文件，支持语法高亮。
    • 提交历史 (Commits)： 查看每一次代码提交的详细信息，包括修改内容、作者、时间、提交消息。
    • 分支管理 (Branches)： 查看、创建、删除不同的开发分支，方便并行开发和版本管理。
    • 标签管理 (Tags)： 为重要的版本节点（如发布版本）打标签。

  • 合并请求 (Pull Requests / Merge Requests)： 这是 Gitee 协作开发的核心机制。当你在一个分支上完成了新功能开发或 Bug 修复后，可以发起一个合并请求，请求将你的分支代码合并到主干分支（如 master 或 `dev）。

    • 代码审查 (Code Review)： 其他团队成员可以在合并请求页面查看代码修改内容，提出意见、建议或疑问。这是提高代码质量、分享知识的重要环节。
    • 持续集成/持续部署 (CI/CD) 集成： 可以配置 CI/CD 工具（如 Gitee Go、Jenkins、GitLab CI 等）在合并请求被创建时自动运行测试，检查代码质量，确保合入的代码是健康的。
    • 冲突检测与解决： 如果待合并的分支与目标分支存在代码冲突，Gitee 会提示，并提供冲突解决指引。

  • 问题管理 (Issues)： Gitee 的问题跟踪系统用于记录 Bug、功能需求、任务、待办事项等。它是一个强大的项目管理工具。

    • 创建与分配： 可以创建问题，详细描述内容，并分配给团队成员处理。
    • 标签 (Labels) 与里程碑 (Milestones)： 使用标签对问题进行分类（如 Bug、Feature、文档），使用里程碑将问题分组，代表项目的某个阶段或版本目标。
    • 评论与讨论： 团队成员可以在问题下方进行讨论，更新进展。
    • 与代码的关联： 可以通过提交消息或合并请求关联到特定的问题，实现代码改动与需求的追溯。

  • 维基 (Wiki)： Gitee 为每个仓库提供了一个内置的 Wiki，用于编写和维护项目的文档、开发指南、设计思路等。使用 Markdown 语法，方便快捷地创建结构化的文档。

  • 代码片段 (Snippets)： 有时你只想分享一小段代码或配置文件，而不是整个仓库。Gitee 的代码片段功能允许你方便地创建、存储和分享这些零散的代码段。

  • Gitee Pages： 一项免费的静态网页托管服务。你可以将仓库中的静态网页文件（如 HTML、CSS、JS、文档网站等）直接通过 Gitee 部署为网站，方便项目文档、个人简历或演示页面的托管。

  • Gitee Go (持续集成/持续部署)： Gitee 自带的 CI/CD 服务，可以自动化执行构建、测试、部署等任务。通过配置流水线，可以在代码提交、合并请求等事件触发时自动运行流程，提高开发效率和部署频率。

  • 企业版与私有化部署： Gitee 为企业提供了更高级的功能，如更精细的权限控制、组织管理、审计日志、企业级支持等。对于有更高安全和控制需求的企业，还提供私有化部署方案，将 Gitee 完整部署在企业内部网络。

  • 社区与社交功能： Gitee 内置了类微博的动态功能，可以关注其他用户、项目，查看动态，点赞、评论，促进开发者之间的交流和互动。

4. Gitee 的优势与特色

相较于其他国际平台，Gitee 在中国市场具有以下显著优势：

  • 访问速度快且稳定： 服务器位于中国，对于国内用户而言，无论访问速度还是稳定性都远超境外平台，尤其是在网络高峰期或面临国际网络波动时。
  • 全中文用户界面与文档： 降低了语言障碍，方便中国开发者使用和学习。
  • 符合中国法规要求： 对于企业和政府项目，使用 Gitee 更容易满足数据安全和合规性要求。
  • 强大的企业级支持： 提供贴近中国企业需求的定制化服务和技术支持。
  • 积极推动本土开源： 丰富的本土开源项目资源，有利于开发者参与国内开源贡献或寻找合适的项目。
  • 紧密结合开源中国社区： 与 OSCHINA 社区深度整合，获取更多技术资讯和交流机会。

第二部分：Gitee 快速入门指南

了解了 Gitee 是什么及其强大功能后，现在让我们一步步学习如何开始使用 Gitee。

准备工作

在开始之前，你需要确保你的电脑上已经安装了 Git。如果还没有安装，请访问 Git 官网（https://git-scm.com/downloads）下载并安装适合你操作系统的版本。安装完成后，可以通过在命令行输入 git --version 来验证是否安装成功。

第一步：注册与登录 Gitee 账号

  1. 访问 Gitee 官网： 打开浏览器，访问 Gitee 官网：https://gitee.com/
  2. 注册账号： 点击页面右上角的“注册”按钮。你可以选择使用手机号、邮箱或通过 GitHub/Gitee/微信等第三方账号快捷注册。按照页面提示填写必要信息（如用户名、密码等）。建议使用手机号注册，方便后续的身份验证和安全设置。
  3. 完成验证： 根据注册方式，可能需要进行手机短信或邮箱验证。
  4. 登录： 注册成功后，返回首页点击“登录”，输入你的用户名/手机号/邮箱和密码进行登录。

小贴士： 选择一个好的用户名很重要，它将作为你在 Gitee 上的身份标识。完成注册后，可以在“设置”->“个人资料”中完善你的信息，如头像、昵称等。

第二步：创建你的第一个仓库 (Repository)

仓库是存放项目代码的地方。

  1. 进入创建页面： 登录后，点击页面右上角的加号（+）图标，选择“新建仓库”。
  2. 填写仓库信息：
    • 仓库名称： 填写你的项目名称，建议使用英文字母、数字、下划线或短横线，简洁明了（例如：my-first-project）。
    • 仓库路径： 通常会自动生成，也可以自定义，它将成为仓库 URL 的一部分（例如：gitee.com/your_username/my-first-project）。
    • 开源/私有： 选择仓库的可见性。
      • 开源： 任何人都可以查看你的代码，适合开源项目。
      • 私有： 只有你和明确授权的协作者才能访问，适合个人项目或内部团队项目。
    • 是否初始化仓库：
      • 选择“使用 Readme 文件初始化仓库”： Gitee 会为你创建一个包含 README.md 文件的仓库。README.md 用于项目介绍，是一个好的开始。
      • 选择“.gitignore”： 可以选择一个适合你项目类型的 .gitignore 模板（如 Java, Python, Node.js 等），Git 会忽略这些文件中指定的临时文件或构建产物，保持仓库清洁。
      • 选择“License”： 为你的开源项目选择一个合适的许可证（如 MIT, Apache, GPL 等），明确代码的使用、分发、修改权限。
      • 不初始化： 如果你打算将本地已有的项目上传到 Gitee，可以选择不初始化，后续再关联。
    • 分支模型 (主分支名称)： 可以选择主分支的名称，如 master (传统) 或 main (更推荐)。
  3. 点击“创建”： 确认信息无误后，点击页面底部的“创建”按钮。

恭喜你！你的第一个 Gitee 仓库就创建好了。页面会自动跳转到新仓库的主页。

第三步：配置本地 Git 环境与关联远程仓库

在你本地电脑上，你需要告诉 Git 你是谁（用于提交记录）以及如何连接到你的 Gitee 仓库。

  1. 配置用户信息： 打开命令行终端（Windows 用户可以使用 Git Bash, PowerShell 或命令提示符），输入以下命令，将你的用户名和邮箱替换为你在 Gitee 上使用的信息：
    bash
    git config --global user.name "你的Gitee用户名"
    git config --global user.email "你的Gitee注册邮箱"
    --global 参数表示这些设置将应用于你本地所有的 Git 仓库。如果你想为特定项目设置不同的用户信息，可以在项目仓库目录下不加 --global 参数执行命令。

  2. 关联本地仓库与 Gitee 远程仓库：

    • 情景 A: 将本地已有项目上传到 Gitee (创建仓库时未初始化):

      • 进入你的本地项目目录：
        bash
        cd /path/to/your/local/project
      • 初始化 Git 仓库 (如果项目尚未初始化):
        bash
        git init
      • 添加所有文件到暂存区:
        bash
        git add .
      • 提交到本地仓库:
        bash
        git commit -m "Initial commit"
      • 关联远程仓库：在你的 Gitee 仓库主页，点击“克隆/下载”按钮，复制 HTTPS 或 SSH 地址。
        • 使用 HTTPS (推荐新手)： 地址格式通常是 https://gitee.com/your_username/your_repo_name.git
          bash
          git remote add origin https://gitee.com/your_username/your_repo_name.git
          （请将 URL 替换为你自己的仓库地址）
        • 使用 SSH (推荐熟练用户，需配置 SSH Key)： 地址格式通常是 [email protected]:your_username/your_repo_name.git
          bash
          git remote add origin [email protected]:your_username/your_repo_name.git
          （请将 URL 替换为你自己的仓库地址）
          注： 使用 SSH 需要先生成 SSH 密钥并将公钥添加到你的 Gitee 账户设置中（设置 -> 安全设置 -> SSH公钥）。这是一个重要的步骤，将在后续详细说明。
      • 将本地代码推送到 Gitee：
        bash
        git push -u origin master # 或者 main，取决于你的主分支名称
        -u origin master (或 main) 表示将本地的 master 分支推送到名为 origin 的远程仓库，并将其设置为本地 master 分支的上游 (upstream)，以后只需执行 git push 即可。

    • 情景 B: 克隆 Gitee 上的仓库到本地 (创建仓库时已初始化):

      • 在 Gitee 仓库主页，点击“克隆/下载”按钮，复制 HTTPS 或 SSH 地址。
      • 在命令行中，进入你想要存放项目的目录。
      • 执行克隆命令：
        • 使用 HTTPS：
          bash
          git clone https://gitee.com/your_username/your_repo_name.git
        • 使用 SSH：
          bash
          git clone [email protected]:your_username/your_repo_name.git
      • 克隆完成后，会在当前目录下生成一个与仓库同名的文件夹，里面就是你在 Gitee 上创建的仓库内容。进入该文件夹即可开始工作：
        bash
        cd your_repo_name

第四步：使用 SSH Key 进行连接 (推荐，更安全便捷)

虽然 HTTPS 连接对于新手友好，每次操作（如 push）可能需要输入用户名和密码，而 SSH 连接则通过密钥对进行身份验证，更加安全便捷。

  1. 检查本地是否已存在 SSH Key： 打开命令行，输入：
    bash
    ls -al ~/.ssh
    查看是否存在 id_rsa 和 id_rsa.pub (或者 id_ed25519 和 id_ed25519.pub) 这样的文件对。.pub 结尾的是公钥，另一个是私钥。如果存在，你可以选择使用现有的，或者生成新的。

  2. 生成新的 SSH Key (如果不存在或想生成新的)： 在命令行输入：
    bash
    ssh-keygen -t rsa -b 4096 -C "你的Gitee注册邮箱"

    • -t rsa 指定密钥类型为 RSA。
    • -b 4096 指定密钥长度为 4096 位（更安全）。
    • -C "你的Gitee注册邮箱" 添加一个注释，方便识别这个密钥的用途。
      系统会提示你选择密钥保存路径和输入 passphrase (密码)。直接按回车接受默认路径即可（通常是 ~/.ssh/id_rsa）。输入 passphrase 是可选的，但为了安全考虑建议设置，不过每次使用时都需要输入。如果想省事，可以直接按回车跳过 passphrase。

  3. 将公钥添加到 Gitee：

    • 找到并复制你的公钥内容：公钥文件通常在 ~/.ssh 目录下，以 .pub 结尾（如 id_rsa.pub）。使用文本编辑器打开它，复制里面的全部内容。或者在命令行中使用以下命令复制：
      • Windows (使用 Git Bash): cat ~/.ssh/id_rsa.pub | clip
      • macOS/Linux: cat ~/.ssh/id_rsa.pub | pbcopy (macOS) 或 cat ~/.ssh/id_rsa.pub 然后手动复制终端输出。
    • 登录 Gitee，点击右上角用户头像，选择“设置” -> “安全设置” -> “SSH公钥”。
    • 点击“添加公钥”按钮。
    • 标题： 给你的公钥起个名字，方便区分（如 “My Laptop Key”）。
    • 公钥： 将刚才复制的公钥内容粘贴到这里。
    • 点击“确定”按钮。你可能需要输入 Gitee 密码进行确认。

  4. 测试 SSH 连接： 在命令行输入：
    bash
    ssh -T [email protected]
    如果是首次连接，可能会提示你确认主机指纹，输入 yes 并回车。如果一切顺利，你应该会看到类似 Hi your_username! You've successfully authenticated, but GITEE.COM does not provide shell access. 的消息。这表示 SSH 连接配置成功。现在你就可以使用 SSH 地址进行 git clone, git pull, git push 等操作了。

第五步：基本的 Git 工作流程 (提交与推送)

这是日常开发中最常用的操作。

  1. 在本地修改文件： 使用你喜欢的编辑器打开项目文件，进行修改、添加或删除。

  2. 查看文件状态： 在项目目录下打开命令行，输入：
    bash
    git status
    这个命令会告诉你哪些文件被修改了（Changes not staged for commit），哪些是新添加的未跟踪文件（Untracked files），以及哪些文件已暂存（Changes to be committed）。

  3. 暂存文件： 将修改或新增的文件添加到暂存区（Staging Area）。

    • 暂存所有修改和新增的文件：
      bash
      git add .
    • 只暂存特定文件：
      bash
      git add path/to/your/file.txt

  4. 提交到本地仓库： 将暂存区的文件提交到本地仓库，形成一个新的版本。
    bash
    git commit -m "描述本次提交的简短消息"

    • -m 参数后面是本次提交的消息，应该简洁明了地概括本次修改的内容和目的。好的提交消息非常重要，方便日后查阅历史记录。

  5. 推送到 Gitee 远程仓库： 将本地仓库的新提交同步到 Gitee 上。
    bash
    git push origin your_branch_name # 通常是 master 或 main

    • origin 是远程仓库的别名，默认为克隆时的远程仓库。
    • your_branch_name 是你当前工作并提交了代码的分支名称。

至此，你就完成了在本地进行修改并将修改推送到 Gitee 的过程。刷新 Gitee 仓库页面，你就能看到新的提交和文件改动了。

第六步：更新本地代码 (拉取与合并)

当团队其他成员向 Gitee 仓库推送了新的代码时，你需要将这些更新同步到你的本地仓库。

  1. 拉取远程更新： 在本地项目目录下，执行：
    bash
    git pull origin your_branch_name # 通常是 master 或 main
    git pull 命令相当于 git fetch (获取远程仓库的最新状态) 和 git merge (将远程分支的最新内容合并到当前本地分支) 的组合。

  2. 解决合并冲突 (如果发生)： 如果你本地修改了某个文件，而远程仓库的最新提交也修改了同一个文件的同一部分，就会发生合并冲突。Git 会在冲突文件中用特殊标记（如 <<<<<<<, =======, >>>>>>>）标出冲突的部分。

    • 打开冲突文件，手动编辑，选择保留哪些代码，删除冲突标记。
    • 解决完所有冲突后，使用 git add . 暂存冲突已解决的文件。
    • 使用 git commit 命令完成合并提交（Git 会自动生成一个合并提交消息，你可以编辑它）。
    • 最后，git push 将解决冲突后的代码推送到 Gitee。

第七步：协作开发：分支与合并请求 (Pull Request)

协作是 Git 和 Gitee 的核心价值之一。通常的协作流程是基于分支和合并请求进行的。

  1. 创建并切换到新的开发分支： 为了避免直接在主分支上工作导致混乱，通常会为每一个新功能或 Bug 修复创建一个独立的分支。
    bash
    git branch feature/add-user-auth # 创建一个名为 feature/add-user-auth 的分支
    git checkout feature/add-user-auth # 切换到这个新分支
    # 或者使用一个命令完成创建并切换
    git checkout -b feature/add-user-auth

  2. 在新分支上进行开发、提交： 在这个新分支上按照第五步的流程进行代码修改、暂存和提交。你可以进行多次提交。

  3. 将新分支推送到 Gitee：
    bash
    git push origin feature/add-user-auth
    由于是第一次推送新分支，可能需要加上 -u 参数：git push -u origin feature/add-user-auth。

  4. 创建合并请求 (Pull Request)： 当你在新分支上的工作完成后，就可以向 Gitee 提交一个合并请求，请求将 feature/add-user-auth 分支的代码合并到目标分支（如 master 或 dev）。

    • 登录 Gitee，进入你的仓库页面。
    • Gitee 通常会自动检测到你刚刚推送的新分支，并在页面顶部或分支列表旁边提示你创建合并请求。点击相应的按钮（如 “创建合并请求”）。
    • 或者，点击左侧导航栏的“合并请求”，然后点击“新建合并请求”按钮。
    • 选择源分支和目标分支： 源分支选择你刚推送的 feature/add-user-auth，目标分支选择你希望合并到的分支（如 master 或 main）。
    • 填写合并请求信息： 填写标题和详细描述，说明本次合并的目的、内容、解决了哪些问题（可以关联到 Issue）。
    • 指定审查者 (可选)： 如果在团队中协作，可以指定团队成员进行代码审查。
    • 点击“创建”： 提交合并请求。

  5. 代码审查与讨论： 团队成员会收到通知，在合并请求页面查看代码改动、发表评论、提出修改建议。你也可以根据审查意见在本地修改代码，然后再次提交并推送到同一个分支 (feature/add-user-auth)，合并请求会自动更新。

  6. 合并分支： 当代码审查通过，且没有冲突时，拥有合并权限的人（通常是项目维护者）就可以点击“接受合并”按钮，将源分支的代码合并到目标分支。Gitee 提供了几种合并方式（如 Merge commit, Squash and merge, Rebase and merge）。合并完成后，可以选择删除源分支。

  7. 本地清理： 合并请求完成后，可以回到本地主分支，拉取最新的代码，然后删除已经合并的本地分支。
    bash
    git checkout master # 或 main
    git pull origin master # 或 main
    git branch -d feature/add-user-auth # 删除本地已合并的分支

第八步：探索更多 Gitee 功能 (Issues, Wiki, Pages 等)

一旦熟悉了基本的代码托管和协作流程，你可以开始探索 Gitee 的其他实用功能：

  • 问题 (Issues)： 利用 Issue 跟踪任务和 Bug。在仓库左侧导航栏点击“问题”，可以创建、查看、管理项目中的问题。在提交消息或合并请求中引用问题号（如 #123），可以将代码改动与问题关联起来。
  • 维基 (Wiki)： 在仓库左侧导航栏点击“维基”，可以创建和编辑项目文档。这是一个轻量级的文档管理工具。
  • Gitee Pages： 如果你的仓库中包含静态网站文件，可以通过“服务”->“Gitee Pages”功能将其免费部署为网站。选择部署的分支和目录（通常是 master/main 分支的根目录或 docs 目录），点击启动即可。生成的网站地址通常是 your_username.gitee.io/your_repo_name。
  • Gitee Go： 如果你需要自动化构建、测试和部署流程，可以探索“服务”->“Gitee Go”功能，配置 CI/CD 流水线。
  • 项目管理 (Kanban)： Gitee 也提供简单的看板功能，将 Issues 在看板上进行可视化管理。

通过不断实践和探索，你会发现 Gitee 更多强大的功能，它们将极大地提升你的个人开发效率和团队协作能力。

总结

Gitee 作为中国的本土代码托管平台，凭借其优秀的本土化服务、高速稳定的访问、对国内法规的友好支持以及对中国开源生态的积极推动，已经成为越来越多中国开发者和企业的首选。

本文详细介绍了 Gitee 的背景、核心功能及其独特优势，并提供了一个从注册、创建仓库到基本代码操作、协作流程的完整快速入门指南。掌握这些基础知识和操作，你就已经迈出了使用 Gitee 的第一步。

版本控制和协作是现代软件开发的基石。熟练使用 Gitee 这样的平台，将帮助你更好地管理个人项目，更高效地与团队成员协作，并有机会参与到蓬勃发展的中国开源社区中。

现在，就前往 Gitee 官网，注册你的账号，创建你的第一个仓库，开始你的 Gitee 之旅吧！祝你在代码世界里探索愉快，创造价值！

发表评论

您的邮箱地址不会被公开。 必填项已用 * 标注

滚动至顶部