Git+Gitea完整使用教程

这份教程专为新手设计，全程结合 Gitea 服务器，从「安装配置」到「日常开发」「团队协作」，步骤清晰、无专业黑话，跟着做就能上手！

一、前期准备：安装 Git + 配置身份（必做）

1. 安装 Git（不同系统对应步骤）

Git 是本地操作工具，必须先安装才能和 Gitea 服务器交互：

• Windows：
  1. 下载安装包：https://git-scm.com/download/win（默认下载 64 位）
  2. 双击安装，全程「下一步」即可（默认选项已适配新手，无需修改）
  3. 验证是否安装成功：打开「命令提示符」（Win+R 输入 cmd），输入 git --version，能显示版本号（如 git version 2.45.1）就是成功了。
• Mac：
  1. 打开「终端」（Launchpad→其他→终端）
  2. 输入 xcode-select --install，按提示安装 Xcode 命令行工具（包含 Git）
  3. 验证：输入 git --version，显示版本号即成功。
• Linux（如 Ubuntu/Deepin）：
  1. 打开终端，输入命令：sudo apt update && sudo apt install git -y
  2. 验证：git --version，显示版本号即成功。

2. 配置 Git 身份（告诉 Git「你是谁」）

Git 需要知道你的身份，才能把提交记录和你关联（和 Gitea 账号一致即可）：

1. 打开终端 / 命令提示符，执行以下 2 条命令（替换成你在 Gitea 的「用户名」和「邮箱」）：
   bash

   # 替换成你Gitea的用户名（比如gitea上注册的账号名）
   git config --global user.name "你的Gitea用户名"
   # 替换成你Gitea绑定的邮箱（比如注册时填的邮箱）
   git config --global user.email "你的Gitea绑定邮箱"
   

2. 验证配置：输入 git config --global --list，能看到刚才设置的用户名和邮箱，就是配置成功了。

小贴士：--global 表示「全局配置」，设置一次后，所有本地 Git 仓库都会用这个身份，不用重复设置。

二、核心概念：3 分钟搞懂 Git 的「文件流转逻辑」

新手不用死记硬背，记住这 4 个区域，操作就不会乱：

• 工作区：你电脑上实际操作的文件夹（比如你写代码的文件夹）
• 暂存区：临时存放要提交的文件（相当于「待上传文件清单」）
• 本地仓库：电脑本地的「版本数据库」，保存所有提交记录（相当于你本地的「备份」）
• 远程仓库：Gitea 服务器上的仓库（https://gitea.uavv.cn 上的仓库，相当于「云端备份 + 团队共享」）

核心流程：工作区写文件 → 暂存区选文件 → 本地仓库存版本 → 远程仓库推同步

三、常用场景：从 Gitea 克隆仓库到本地（最常用）

适合：别人在 Gitea 上已经创建了仓库，你需要下载到本地修改 / 开发。

步骤 1：在 Gitea 上获取仓库地址

1. 打开浏览器，登录你的 Gitea 账号（https://gitea.uavv.cn）
2. 找到要克隆的仓库（比如别人分享给你的，或自己创建的）
3. 点击仓库页面右上角的「克隆」按钮，选择「HTTPS」协议，复制仓库地址（比如：https://gitea.uavv.cn/你的用户名 / 项目名.git）

步骤 2：本地克隆仓库（下载到电脑）

1. 打开终端 / 命令提示符，先切换到你想存放项目的文件夹（比如 Windows 想存到「桌面 / 代码」文件夹）：
   bash

   # Windows示例：切换到桌面的「代码」文件夹（没有就先创建）
   cd C:\Users\你的电脑用户名\Desktop\代码
   # Mac/Linux示例：切换到用户目录的「code」文件夹
   cd ~/code
   

2. 执行克隆命令（粘贴刚才复制的 Gitea 仓库地址）：
   bash

   git clone https://gitea.uavv.cn/你的用户名/项目名.git
   

3. 按提示输入「Gitea 用户名」和「密码」（如果 Gitea 开了两步验证，密码要填「个人访问令牌」，获取方法看下方小贴士）

4. 等待下载完成，本地就会出现一个和仓库名同名的文件夹，里面就是项目文件。

小贴士：如果 Gitea 开启了两步验证，克隆时输密码会失败，需要用「个人访问令牌」代替密码：

1. 登录 Gitea→点击右上角头像→「设置」→「应用」→「创建访问令牌」
2. 令牌名称随便填（比如「本地 Git」），权限勾选「repo」（仓库相关），点击「创建」
3. 复制生成的令牌（只显示一次，一定要保存好），克隆时密码处粘贴这个令牌即可。

四、常用场景：本地修改文件后，推送到 Gitea（核心操作）

适合：你在本地修改了代码 / 文件，想把修改同步到 Gitea 服务器（备份或给团队看）。

完整步骤（按顺序执行）

假设你已经克隆了仓库，并且在本地修改了文件（比如新增了一个 test.txt，或修改了 app.py）：

1. 进入仓库目录（终端 / 命令提示符中执行，切换到你的项目文件夹）：
   bash

   cd 项目名  # 比如 cd my-project
   

2. 查看文件修改状态（确认哪些文件变了）：
   bash

   git status
   

   • 红色文件：已修改但未加入暂存区（需要下一步添加）
   • 绿色文件：已加入暂存区（等待提交）

3. 将修改的文件加入暂存区（相当于「勾选要上传的文件」）：

   • 单个文件添加：git add 文件名（比如 git add test.txt）
   • 所有修改文件添加：git add .（最常用，「.」表示当前目录下所有修改）

4. 提交到本地仓库（相当于「本地存档」，必须写提交说明，方便后续查看修改记录）：
   bash

   git commit -m "这里写修改说明，比如：新增测试文件test.txt / 修复登录功能bug"
   

   • 说明要简洁明了，比如「修改首页样式」「新增用户模块接口」，不要写空话。

5. 拉取远程最新代码（避免和 Gitea 上别人的修改冲突，必做！）：
   bash

   git pull
   

   • 如果拉取时提示「冲突」，先看下方「冲突解决」部分，解决后再继续。

6. 推送到 Gitea 服务器（将本地提交同步到云端）：
   bash

   git push origin main
   

   • 这里的「main」是分支名（默认主分支，Gitea 仓库默认分支可能是「main」或「master」，如果提示分支不存在，换成 git push origin master）
   • 按提示输入 Gitea 用户名和密码 / 令牌，推送成功后，刷新 Gitea 仓库页面，就能看到你的修改了！

简化记忆：核心 6 字口诀

add（加暂存）→ commit（本地存）→ pull（拉最新）→ push（推云端）

五、常用场景：本地创建新项目，推送到 Gitea（从零开始）

适合：你本地有一个新项目（还没上传到 Gitea），想在 Gitea 创建仓库并同步。

步骤 1：在 Gitea 上创建空仓库

1. 登录 Gitea（https://gitea.uavv.cn）→ 点击右上角「+」号 →「新建仓库」
2. 填写仓库信息：
   • 仓库名称：和本地项目文件夹同名（比如 my-new-project）
   • 描述：随便填（比如「我的第一个 Git 项目」）
   • 可见性：选「私有」（仅自己 / 指定人可见）或「公开」（所有人可见）
   • 其他选项：默认（不要勾选「初始化仓库」，保持空仓库）
3. 点击「创建仓库」，之后会看到仓库地址（比如 https://gitea.uavv.cn/你的用户名 /my-new-project.git），复制这个地址。

步骤 2：本地项目关联 Gitea 仓库并推送

1. 打开终端 / 命令提示符，进入本地新项目文件夹：
   bash

   cd 本地项目文件夹路径  # 比如 cd C:\Desktop\my-new-project
   

2. 初始化本地 Git 仓库（让这个文件夹变成 Git 可管理的仓库）：
   bash

   git init
   

3. 执行「添加暂存→提交本地→关联远程仓库→推送」：
   bash

   # 1. 添加所有文件到暂存区
   git add .
   # 2. 提交到本地仓库
   git commit -m "初始化项目：提交所有基础文件"
   # 3. 关联Gitea空仓库（粘贴刚才复制的Gitea仓库地址）
   git remote add origin https://gitea.uavv.cn/你的用户名/my-new-project.git
   # 4. 推送到Gitea（第一次推送需要加 -u 参数，绑定分支）
   git push -u origin main
   

4. 输入 Gitea 用户名和密码 / 令牌，推送成功后，Gitea 仓库就会显示本地的所有文件了！

六、进阶操作：分支管理（团队协作必备）

分支相当于「项目的平行副本」，比如你想开发新功能，又不想影响主分支的稳定代码，就可以创建分支，开发完成后再合并到主分支。

常用分支命令（按场景使用）

1. 查看所有分支：
   bash

   git branch  # 本地分支（前面带*的是当前所在分支）
   git branch -r  # 远程分支（Gitea上的分支）
   

2. 创建并切换到新分支（比如开发新功能，分支名建议清晰，如「feature - 登录功能」）：
   bash

   git checkout -b feature-login  # 等价于：先创建分支git branch feature-login，再切换git checkout feature-login
   

3. 切换回主分支：
   bash

   git checkout main  # 或 master，看你的主分支名
   

4. 分支开发完成，合并到主分支（比如新功能开发好，要合并到 main）：
   bash

   # 1. 先切换到主分支
   git checkout main
   # 2. 拉取远程主分支最新代码（避免冲突）
   git pull
   # 3. 合并功能分支到主分支（feature-login是你开发的分支名）
   git merge feature-login
   # 4. 推送合并后的主分支到Gitea
   git push origin main
   

5. 删除无用分支（功能合并后，分支没用了）：
   bash

   git branch -d feature-login  # 本地删除
   git push origin --delete feature-login  # 远程删除（Gitea上的分支）
   

七、常见问题：冲突解决（新手不用怕）

冲突是 Git 中最常见的问题，比如：你和同事都修改了同一个文件的同一行代码，你拉取（git pull）时就会提示冲突。

冲突表现

终端提示「Automatic merge failed; fix conflicts and then commit the result.」，同时 git status会显示「both modified」（双方都修改了）。

解决步骤（超简单）

1. 打开冲突的文件，会看到类似这样的内容：
   plaintext

   <<<<<<< HEAD  # 你的本地修改
   这是你写的代码
   =======
   这是同事写的代码（或Gitea上的最新代码）
   >>>>>>> 分支名（或提交ID）
   

2. 编辑文件：删除「<<<<<<<HEAD」「=======」「>>>>>>> 分支名」这些标记，然后保留正确的代码（可以和同事沟通确定，或自己判断）。

3. 保存文件后，执行以下命令：
   bash

   git add 冲突的文件名  # 标记冲突已解决
   git commit -m "解决冲突：保留双方正确代码"
   git push origin main  # 推送解决后的代码
   

搞定！冲突就解决了。

Git算法不匹配

修改 Git 客户端算法为 SHA256，核心是配置 Git 的「仓库哈希算法」（从默认 SHA1 切换到 SHA256），需注意 Git 2.29.0 及以上版本才支持 SHA256 仓库（低版本需先升级）。以下是分场景的完整操作步骤，覆盖「全局生效」「单个仓库生效」「新建仓库」「现有仓库迁移」：

一、先检查 Git 版本（必须 ≥2.29.0）

首先确认你的 Git 版本支持 SHA256，打开终端 / 命令行执行：

bash

git --version

• 若版本 ≥2.29.0：直接进入下一步；
• 若版本 <2.29.0：需先升级 Git（官网下载最新版：https://git-scm.com/downloads，或通过包管理器 brew upgrade git/sudo apt update && sudo apt install git 升级）。

二、核心配置：切换 SHA256 算法

Git 的 SHA256 配置分「全局（所有仓库）」和「局部（单个仓库）」，按需选择：

1. 全局配置（所有新建 / 现有仓库生效，推荐）

执行以下命令，设置全局默认哈希算法为 SHA256：

bash

# 1. 启用 SHA256 仓库格式（核心配置）
git config --global extensions.objectFormat sha256

# 2. 可选：强制 Git 通信时（push/fetch）优先使用 SHA256（适配 Gitea 等要求 SHA256 的服务）
git config --global protocol.version 2

2. 局部配置（仅当前仓库生效，适合单独指定）

进入目标仓库的根目录，执行：

bash

# 进入仓库目录（替换为你的仓库路径）
cd /path/to/your/repo

# 配置当前仓库使用 SHA256
git config extensions.objectFormat sha256

# 可选：通信时优先 SHA256
git config protocol.version 2

八、常用 Git 命令速查（新手必备）

九、Gitea 相关补充操作

1. 查看提交记录：登录 Gitea 仓库→「提交」标签页，能看到所有推送的提交记录（谁改的、改了什么、时间）。
2. 邀请别人协作：Gitea 仓库→「设置」→「协作者」→「添加协作者」，输入对方 Gitea 用户名，设置权限（写权限 / 读权限），对方接受后就能一起开发。
3. 下载仓库文件：Gitea 仓库→「代码」标签页→右上角「下载 ZIP」，可直接下载仓库所有文件（无需 Git）。

总结

新手不用一开始学所有命令，先掌握「克隆→修改→add→commit→pull→push」这一套核心流程，就能满足日常开发需求。遇到问题时，先执行 git status看状态，再根据提示排查（比如红色文件要 add，冲突要编辑文件）。