Gitea 是一个轻量级的 DevOps 平台，覆盖从开发计划到产品成型的整个软件生命周期。它提供 Git 托管、代码审查、团队协作、软件包注册和 CI/CD 等功能，非常适合团队高效协作。
一、下载安装包
前往 Gitea 官方下载页面获取安装包：https://dl.gitea.com/gitea/。
二、安装步骤
-
准备环境 将下载好的安装包（例如
gitea-1.25.3-windows-4.0-amd64.exe）放置到指定目录，如D:\gitea。双击运行安装程序。 -
初始化配置 在浏览器中访问
http://localhost:3000，进入安装向导界面。- 数据库选择：默认使用 SQLite3 即可，无需额外配置。如果团队已有 MySQL 或 PostgreSQL，也可在此处切换。
- 管理员账户：建议创建一个管理员账号，后续用于创建仓库和管理权限。
填写完信息后点击'立即安装'，安装完成后会在目录下生成必要的配置文件。
三、配置开机自启动
直接通过快捷方式启动每次开机都会弹出窗口，体验不佳且容易误关。更稳妥的方式是将其注册为后台服务。
1. 注册服务
以管理员身份打开 CMD，执行以下命令（路径需根据实际安装位置调整）：
sc create gitea binPath= "D:\gitea\gitea.exe web" start= auto
注意：确保路径中的空格已用双引号包裹，否则服务可能无法识别。
2. 验证服务
按下 Win + R，输入 services.msc，在服务列表中找到 gitea，确认状态为'正在运行'。
3. 手动启动脚本（可选）
为了方便首次启动，可以在启动文件夹中创建一个批处理文件 gitea.bat，内容如下：
@echo off
net start gitea
这样每次开机只需双击该脚本即可启动服务，无需手动操作。
四、基础使用流程
1. 创建仓库
登录管理员账户后，点击右上角的'新建'按钮创建仓库。初次创建时建议保持公开，方便团队成员快速上手。
2. Fork 与合并
普通用户登录后，可以 Fork 管理员的测试仓库到自己的名下进行开发。修改完成后，发起 Pull Request（合并请求），经管理员审核通过后，代码才会合并到主干分支。这是保证代码质量的标准流程。
五、Git 常用命令速查
掌握 Git 命令是日常开发的基础，以下是高频场景的用法整理：
1. 克隆与拉取
# 克隆整个仓库
git clone [url]
# 克隆指定分支
git clone [url] -b branch_name
# 每天工作前同步最新代码（推荐变基模式）
git checkout main
git pull --rebase
2. 提交与暂存
# 查看状态
git status
# 添加单个文件或全部修改
git add filename
git add .
# 提交到版本库
git commit -m 'fix: 本次修复的 bug'
提交规范：建议使用语义化提交类型，如
feat（新功能）、fix（修复）、docs（文档）、style（格式）、refactor（重构）、test（测试）、chore（构建）。
3. 推送与远程管理
# 推送到远程分支
git push origin branch-name
# 强制推送（慎用）
git push -f origin branch-name
# 建立本地与远程关联（首次推送）
git push -u origin branch-name
4. 分支管理
# 创建新分支
git branch new_branch_name
# 基于某分支创建
git branch new_branch_name reference_branch_name
# 切换分支
git checkout feature/xxx
# 删除本地分支
git branch -d feature/xxx
# 删除远程分支
git push origin -d branch_name
分支命名建议：功能开发用
feature/功能名，Bug 修复用fix/问题描述，发布版本用release/版本号。
5. 合并与回滚
# 合并分支并保留历史
git merge --no-ff feature/功能名 -m '本次添加的注释信息'
# 撤销 commit 但保留文件
git reset --soft HEAD^
# 撤销 commit 并丢弃修改
git reset --hard HEAD^
# 撤销 add
git reset filename
# 回滚到特定版本
git reset --hard commit_id
6. 打标签发布
# 创建带注解的标签
git tag -a v1.2.1 -m '本次发布的版本说明'
# 推送标签
git push --tags
7. 解决换行符问题
如果在 Windows 下出现 ^M 换行符错误，可执行以下配置：
git config --global core.whitespace cr-at-eol
通过以上配置和命令，你可以快速搭建私有代码托管平台，并规范团队的代码协作流程。