# GitNewbie - 团队 Git 入门指南


> [!NOTE]
> 文档由 AI 生成

欢迎来到 **GitNewbie** 仓库！

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

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

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

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

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

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

## 零基础入门准备

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

1.  **安装 Git：**
    *   访问 [Git 官方网站](https://git-scm.com/downloads) 下载并安装适合你操作系统的 Git 版本。安装过程通常比较简单，按照默认选项进行即可。
    *   安装完成后，打开终端或命令行工具，输入 `git --version` 检查是否安装成功并显示版本号。

2.  **配置 Git：**
    *   安装完成后，你需要设置你的用户名和邮箱，这将作为你在进行提交 (commit) 时的身份标识。在终端输入以下命令（将`你的名字`和`你的邮箱`替换为你自己的信息）：
        ```bash
        git config --global user.name "admin"
        git config --global user.email "admin@admin.me"
        ```
    *   `--global` 参数表示这是全局配置，今后你在本机上的所有 Git 仓库都会使用这个身份。

## 本仓库与我们的 Gitea 平台

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

[**点此访问我们的 Gitea 平台：`https://gitea.245353.xyz`**](https://gitea.245353.xyz)

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

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

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

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

## 接下来的学习步骤

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

## 提问与帮助

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

*   向你的团队成员寻求帮助。
*   查阅 Gitea 平台的帮助文档（如果平台管理者提供了文档链接）。
*   在本仓库或相关项目仓库的 Issues 中提出你的问题（一旦你熟悉了如何在 Gitea 上使用 Issues 功能）。

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

---

**创建日期:** 2025-04-29