Gitea 本地部署指南：安装配置与常用 Git 命令实战

Gitea 是一个轻量级的 DevOps 平台，能够覆盖从开发计划到产品成型的整个软件生命周期。它支持 Git 托管、代码审查、团队协作、软件包注册和 CI/CD，非常适合团队或个人搭建私有代码仓库。

一、下载安装包

前往 Gitea 官方下载页面获取对应系统的安装包：Gitea | gitea。

二、安装步骤

1. 准备环境 将下载好的安装包（例如 gitea-1.25.3-windows-4.0-amd64.exe）放置到指定目录，如 D:\gitea。双击运行安装程序。

![安装向导界面]

2. 初始化配置 安装完成后，在浏览器访问 http://localhost:3000。

![Web 初始化界面]

首次启动会进入配置向导。这里默认选择 SQLite3 即可，无需额外配置数据库。如果已有 MySQL 或 PostgreSQL，也可以在此处切换。

![数据库选择界面]

3. 创建管理员账户 填写管理员账号信息，建议设置强密码。点击'立即安装'，系统会在安装目录下生成必要的配置文件和数据文件。

![安装完成界面]

至此，基础服务已就绪。

三、配置开机自启动

直接通过启动文件夹运行会导致每次开机弹出窗口，体验不佳。推荐将其注册为 Windows 服务，实现后台静默运行。

1. 以管理员身份打开 CMD 可以通过任务管理器或搜索'命令提示符'并右键选择'以管理员身份运行'。

![任务管理器界面]

2. 注册服务 使用 sc 命令将 Gitea 注册为系统服务。假设安装路径为 D:\gitea\gitea.exe：

sc create gitea binPath= "D:\gitea\gitea.exe" start= auto DisplayName= "Gitea"

注意：binPath= 后面必须有空格。

![服务注册命令]

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

![服务列表界面]

四、基本使用流程

1. 创建仓库

登录管理员账户后，点击右上角的'新建'按钮创建仓库。初次创建时建议不勾选'私有'，方便后续测试协作流程。

![创建仓库界面]

2. Fork 与合并工作流

普通用户可注册个人账户，通过 Fork 功能复制管理员的仓库进行开发。

![Fork 操作界面]

克隆到自己的远程仓库后，可以在本地修改代码。开发完成后，发起 Pull Request（合并请求），由管理员审核通过后合并至主干分支。这种机制能有效保障代码质量。

![合并请求界面]

五、常用 Git 命令实战

掌握以下命令能显著提升日常开发效率。

1. 仓库克隆与提交

# 克隆远程仓库到本地
git clone <url>

# 指定分支克隆
git clone <url> -b branch_name

# 查看暂存区状态
git status

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

# 提交到版本库
git commit -m 'fix: 本次添加的注释信息'

提交类型说明：

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

2. 推送与分支管理

# 推送到远程仓库
git push origin branch-name

# 强制推送（慎用）
git push -f origin branch-name

# 建立本地与远程关联
git push -u origin branch-name

# 创建新分支
git branch new_branch_name

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

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

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

分支命名规范建议：

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

3. 合并与回滚

# 切换到主分支
git checkout main

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

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

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

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

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

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

# 强制推送回滚后的版本
git push origin branch_name --force

4. 紧急修复与标签

# 创建分支并切换
git checkout -b feature/xxx master

# 提交并同步
git add .
git commit -m "feat: 本次添加的注释信息"
git push origin feature/xxx

# 合并到主分支
git checkout master
git merge feature/xxx
git push origin master

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

5. 日常同步与冲突处理

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

# 功能开发中途同步
git fetch origin
git rebase origin master

# 解决 git diff 去除 ^M 的方法
git config --global core.whitespace cr-at-eol

通过以上配置与命令，你可以快速搭建并维护一个稳定的私有代码托管环境。