GitNewbie - 团队 Git 入门指南

Note

文档由 AI 生成

欢迎来到 GitNewbie 仓库！

本仓库是专为我们团队的 Git 初学者打造的入门资源。我们的目标是让你快速理解 Git 的核心概念、掌握基本操作，并能够顺畅地使用我们内部的 内部代码托管平台 进行代码管理和团队协作。

无需担心你之前没有接触过版本控制系统，我们将从最基础的内容开始讲解。

什么是 Git？为什么我们要用它？

Git 是一个 分布式版本控制系统 (Distributed Version Control System, DVCS)。听起来可能有点复杂，但简单来说，它是一个强大的工具，可以帮助我们：

记录所有文件变更历史： Git 会像一个时间机器一样，记录你的项目文件的每一次重要变动。你可以随时查看、对比、甚至回到之前的任何一个版本。这让你可以大胆尝试新想法，因为总能回到一个稳定的状态。
方便团队协作： Git 允许多个人在同一个项目上并行工作。每个人都有一个完整的项目副本，可以独立地开发自己的部分，然后轻松地将大家的修改合并到一起。
轻松管理项目分支 (Branch)： 你可以创建独立的分支来进行新功能开发或 Bug 修复，而不會影响项目的主干。完成工作后，再将分支合併回来。这使得并行开发和版本管理变得非常灵活。
备份与安全： 你的整个项目历史都保存在本地和远程（我们的 Gitea 平台）仓库中，大大降低了数据丢失的风险。

总之，使用 Git 是现代软件开发和其他项目管理中不可或缺的一部分，它能极大地提高我们的效率和协作质量。

在开始使用 Git 之前，你需要完成以下准备工作：

安装 Git：
- 访问 Git 官方网站下载并安装适合你操作系统的 Git 版本。安装过程通常比较简单，按照默认选项进行即可。
- 安装完成后，打开终端或命令行工具，输入 git --version 检查是否安装成功并显示版本号。
配置 Git：
- 安装完成后，你需要设置你的用户名和邮箱，这将作为你在进行提交 (commit) 时的身份标识。在终端输入以下命令（将你的名字和你的邮箱替换为你自己的信息）：
```
git config --global user.name "admin"
git config --global user.email "admin@admin.me"
```
- --global 参数表示这是全局配置，今后你在本机上的所有 Git 仓库都会使用这个身份。

我们团队使用了 内部代码托管平台，其网址是：

我们的所有项目仓库，包括你即将使用的其他项目仓库，都托管在这个平台上。

对于本 GitNewbie 仓库，你可以通过以下方式获取它：

克隆 (Clone) 本仓库到你的本地电脑： 打开终端或命令行工具，切换到你想要存放仓库的目录，然后执行克隆命令：
```
git clone https://gitea.245353.xyz/admin/GitNewbie.git
```

克隆完成后，你将在本地目录中看到一个名为 GitNewbie 的文件夹，这就是克隆到本地的仓库副本。

浏览本仓库内容： 查看本地 GitNewbie 文件夹中的文件。后续可能会在此添加更多的示例文件或练习指引。
学习基本命令： 在你本地克隆的 GitNewbie 仓库目录中，尝试执行一些基本的 Git 命令，比如：
- git status: 查看当前仓库的状态。
- git add <文件名>: 将文件添加到暂存区。
- git commit -m "提交说明": 提交暂存区的变更到本地仓库。
- git log: 查看提交历史。
参考更多学习资源： 除了本仓库，我们鼓励你查阅前面提到的 Git 官方文档、《Pro Git》书籍，或者其他优秀的 Git 教程（如廖雪峰的 Git 教程、菜鸟教程等），它们会更详细地介绍 Git 的各种功能和命令。
多加实践： 在自己的小项目或者专门的练习目录中反复练习 Git 命令，比如尝试创建分支、合并分支、处理冲突等。

如果你在学习过程中遇到任何问题，或者在使用 Gitea 平台时遇到困难，请不要犹豫：

祝你在 Git 的学习之旅中一切顺利！

创建日期: 2025-04-29