Gitea 安装配置及常用 Git 命令指南
Gitea 是一个轻量级的 DevOps 平台软件,涵盖 Git 托管、代码审查、团队协作、软件包注册和 CI/CD。以下介绍在 Windows 环境下的安装、服务配置及基础使用方法。
一、下载安装包
- 下载地址:Gitea Releases
二、安装步骤
2.1 安装 Gitea
- 将下载的安装包(如
gitea-1.25.3-windows-4.0-amd64.exe)放置于指定目录(例如D:\gitea)。 - 双击安装包运行。

- 在浏览器访问
http://localhost:3000。

- 选择数据库类型。默认推荐 SQLite3,若使用其他数据库需提前安装配置。

- 创建管理员账户,填写信息后点击安装。安装完成后会在目录下生成相关配置文件。

至此 Gitea 安装完成。
三、配置开机自启动
为避免每次开机弹出窗口,建议将 Gitea 注册为系统服务后台运行。
3.1 通过 CMD 注册服务
- 以管理员权限打开 CMD。
- 使用
sc命令注册服务。

3.2 启动脚本配置
按下 Win + R,输入 shell:startup 打开启动文件夹,新建批处理文件 gitea.bat,写入以下内容:
@echo off
net start gitea
首次运行该脚本即可启动服务,后续开机自动生效。
3.3 查看服务状态
按下 Win + R,输入 services.msc,在服务列表中找到 Gitea 服务确认运行状态。

四、基本使用
4.1 管理员创建仓库
登录管理员账户,点击'创建仓库',设置名称并选择公开或私有,确认后即可完成创建。



4.2 用户协作流程
4.2.1 个人账户注册
普通用户需先注册个人账号。


4.2.2 Fork 与合并
- 进入目标仓库(如
admin/test),点击右上角'Fork'按钮。

- 从管理员仓库派生出个人远程仓库。

- 获取个人远程仓库的 Clone URL。

- 本地开发完成后,发起 Pull Request 将代码合并至主干,便于代码审查(Code Review),审核通过后方可合并。

五、常用 Git 命令
# 1. 克隆远程仓库到本地
git clone [url]
git clone [url] -b branch_name # 克隆指定分支
# 2. 提交文件到暂存区
git status # 查看暂存区和工作区状态
git add filename # 添加单个文件
git add . # 添加所有修改文件
# 3. 提交到版本库
git commit -m 'fix: 本次添加的注释信息'
# 提交类型说明:
# feat: 新功能
# fix: 修改 bug
# docs: 文档描述变更
# style: 风格变动
# refactor: 代码重构
# perf: 性能优化
# test: 测试代码
# chore: 构建配置相关
# revert: 回滚
# 4. 推送到远程仓库
git push origin branch-name # 推送分支
git push -f origin branch-name # 强制推送
git push -u origin branch-name # 建立关联并推送
# 5. 分支管理
git branch new_branch_name # 创建新分支
git branch new_branch_name ref_branch # 基于某分支创建
git push origin -d branch_name # 删除远程分支
git branch -D branch_name # 删除本地分支
# 分支命名规则:
# feature/功能名 # 功能开发
# fix/问题描述 # Bug 修复
# release/版本号 # 发布版本
# dev/姓名/功能 # 个人开发
# 合并到主分支
git checkout main
git merge --no-ff feature/功能名 -m '本次添加的注释信息' # 保留历史
git branch -d feature/功能名 # 删除本地分支
# 6. 撤销 commit
git reset --soft HEAD~ # 撤销 commit,保留已 add 的文件
git reset --hard HEAD~ # 撤销 commit 和已 add 的文件
# 7. 撤销 add
git reset filename # 撤销单个文件
git reset
git reset --hard commit_id
git push origin branch_name --force
git checkout -b feature/xxx master
git add .
git commit -m
git push origin feature/xxx
git checkout master
git merge feature/xxx
git push origin master
git checkout dev
git merge feature/xxx
git push origin dev
git tag -a v1.2.1 -m
git push --tags
git checkout main
git pull --rebase
git fetch origin
git rebase origin master
git config --global core.whitespace cr-at-eol

