81 lines
4.8 KiB
Markdown
81 lines
4.8 KiB
Markdown
# 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 |