commit aecb09ba2735d118891fe1447e257c07ba9341f6 Author: admin Date: Tue Apr 29 14:12:56 2025 +0800 添加 README diff --git a/README.md b/README.md new file mode 100644 index 0000000..7a3fb27 --- /dev/null +++ b/README.md @@ -0,0 +1,81 @@ +# 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 \ No newline at end of file