Gitea 本地部署与常用 Git 命令实战指南

2. 批处理辅助启动

为了方便首次启动，可以在启动文件夹创建一个批处理脚本。

按下 Win + R，输入 shell:startup 打开启动项目录，新建 gitea.bat，内容如下：

@echo off
net start gitea

这样每次开机后点击该脚本即可启动服务，无需手动干预。

3. 验证服务状态

按下 Win + R，输入 services.msc，在服务列表中找到 gitea 服务，确认其状态为'正在运行'。

三、基础使用流程

1. 创建仓库

登录管理员账户，点击'创建仓库'。

填写仓库名称，根据需求决定是否勾选'私有'。通常公共项目建议公开，内部项目设为私有。

2. 分支协作模式

团队成员可以通过 Fork 机制进行开发，避免直接修改主干代码。

注册个人账户

非管理员用户需先注册账号。

Fork 与合并

1. 在目标仓库（如 admin/test）点击右上角的'派生'（Fork）。
2. 将 Fork 后的远程仓库 Clone 到本地。
3. 开发完成后，发起 Pull Request 请求合并到主干，经过代码走读审核后再合并。

四、常用 Git 命令速查

日常开发中，以下命令覆盖了大部分场景。建议保存为本地笔记随时查阅。

1. 克隆与拉取

# 克隆完整仓库
git clone [url]

# 克隆指定分支
git clone [url] -b branch_name

# 每日工作前拉取最新代码（推荐变基）
git checkout main
git pull --rebase

# 功能中途同步远程更新
git fetch origin
git rebase origin master

2. 提交与暂存

# 查看状态
git status

# 添加文件到暂存区
git add filename
git add . # 添加所有修改

# 提交到版本库
git commit -m 'fix: 本次修复的 bug'

Commit Message 规范：

• feat: 新功能
• fix: 修改 bug
• docs: 文档变更
• style: 风格变动
• refactor: 代码重构
• perf: 性能优化
• test: 测试代码
• chore: 构建配置相关
• revert: 回滚

3. 分支管理

# 创建新分支
git branch new_branch_name

# 基于某分支创建新分支
git branch new_branch_name reference_branch_name

# 切换到分支
git checkout feature/xxx

# 删除本地分支
git branch -d branch_name

# 删除远程分支
git push origin -d branch_name

# 合并分支（保留历史）
git checkout main
git merge --no-ff feature/功能名 -m '本次添加的注释信息'

分支命名规则参考：

• 功能开发：feature/功能名
• Bug 修改：fix/问题描述
• 发布版本：release/版本号
• 个人开发：dev/姓名/功能

4. 撤销与回滚

# 撤销 commit，保留已 add 的文件
git reset --soft HEAD^

# 撤销 commit 及已 add 的文件
git reset --hard HEAD^

# 撤销单个文件的 add
git reset filename

# 撤销全部已 add 的文件
git reset

# 回滚到特定版本
git reset --hard commit_id

# 强制推送（慎用）
git push origin branch_name --force

5. 标签与紧急修复

# 打标签发布
git tag -a v1.2.1 -m "本次添加的注释信息"
git push --tags

# 紧急修复流程
# 1. 创建并切换分支
git checkout -b feature/bugfix master
# 2. 提交修改
git add .
git commit -m "feat: 紧急修复"
git push origin feature/bugfix
# 3. 合并回主分支
git checkout master
git merge feature/bugfix
git push origin master

6. 常见问题

解决 Git diff 出现 ^M 换行符问题：

git config --global core.whitespace cr-at-eol

以上步骤涵盖了 Gitea 的基础搭建与日常 Git 协作的核心命令。实际使用中，建议结合团队规范灵活调整。