本文详细介绍如何将一个包含多个子项目的 .NET 解决方案完整推送到 GitLab 私有仓库涵盖远程仓库配置、凭据认证、受保护分支处理等实战技巧。## 一、项目背景最近接手了一个 .NET 游戏管理后台项目WHQJAdmin需要将本地所有工程代码推送到公司内部的 GitLab 私有仓库。项目结构如下WHQJAdmin/├── Services/│ ├── Game.Data/│ ├── Game.Entity/│ ├── Game.Facade/│ └── Game.IData/├── WebProjects/│ └── Game.Web/└── WHQJAdmin.sln远程仓库地址http://192.168.1.19/dev_group/game_admin_vue_net10.git## 二、添加远程仓库首先检查当前的 Git 状态和远程仓库配置bashgit statusgit remote -v添加新的远程仓库命名为 devbashgit remote add dev http://192.168.1.19/dev_group/game_admin_vue_net10.git验证远程仓库是否添加成功bashgit remote -v输出应显示dev http://192.168.1.19/dev_group/game_admin_vue_net10.git (fetch)dev http://192.168.1.19/dev_group/game_admin_vue_net10.git (push)origin https://github.com/tonyimax/whdlm.git (fetch)origin https://github.com/tonyimax/whdlm.git (push)## 三、配置认证凭据### 3.1 使用 Access Token 认证GitLab 私有仓库推送需要认证。推荐使用 **Personal Access Token** 而非密码1. 登录 GitLab进入 Settings → Access Tokens2. 创建具有 write_repository 权限的 Token3. 将 Token 嵌入远程仓库 URLbashgit remote set-url dev http://tonyimax:glpat-xxxxxxxxxxx192.168.1.19/dev_group/game_admin_vue_net10.git ⚠️ **安全提示**Token 相当于密码请勿泄露或提交到代码仓库### 3.2 可选配置 Git 凭据缓存bashgit config credential.helper store## 四、提交本地代码### 4.1 添加所有文件bashgit add -A### 4.2 提交变更bashgit commit -m Add WHQJAdmin projects提交结果示例[main c77986d] Add WHQJAdmin projects20333 files changed, 2095978 insertions(), 145114 deletions(-)create mode 100644 Services/Game.Data/Game.Data.csprojcreate mode 100644 WebProjects/Game.Web/Program.cs...## 五、处理受保护分支### 5.1 常见问题直接推送时可能遇到以下错误**错误 1强制推送被拒绝**remote: GitLab: You are not allowed to force push code to a protected branch on this project.! [remote rejected] main - main (pre-receive hook declined)**错误 2远程仓库已有内容**! [rejected] main - main (fetch first)**错误 3受保护分支无法推送**remote: GitLab: You are not allowed to push code to protected branches on this project.! [remote rejected] main - main (pre-receive hook declined)### 5.2 解决方案GitLab 的 main 分支通常设置为**受保护分支**防止意外推送。有两种解决方案#### 方案一先拉取再推送需要推送权限bashgit pull dev main --allow-unrelated-histories --no-editgit push -u dev main#### 方案二推送到新分支推荐bashgit push -u dev main:dev_branch推送成功后输出分支 main 设置为使用变基来跟踪 dev/dev_branch。To http://192.168.1.19/dev_group/game_admin_vue_net10.git* [new branch] main - dev_branch## 六、创建合并请求Merge Request推送到 dev_branch 分支后在 GitLab 上创建 Merge Request1. 访问 GitLab 项目页面2. 点击 Merge requests → New merge request3. 源分支选择 dev_branch目标分支选择 main4. 填写合并请求说明提交审核或直接访问http://gitlab.example.com/dev_group/game_admin_vue_net10/-/merge_requests/new?merge_request%5Bsource_branch%5Ddev_branch## 七、完整命令汇总bash# 1. 添加远程仓库git remote add dev http://192.168.1.19/dev_group/game_admin_vue_net10.git# 2. 配置 Token 认证git remote set-url dev http://tonyimax:glpat-xxxxxxxxxxx192.168.1.19/dev_group/game_admin_vue_net10.git# 3. 提交所有代码git add -Agit commit -m Add WHQJAdmin projects# 4. 推送到新分支避开受保护分支限制git push -u dev main:dev_branch## 八、常见问题排查| 问题 | 原因 | 解决方案 ||------|------|----------|| Access denied | Token 错误或权限不足 | 检查 Token 是否有效确认有 write_repository 权限 || protected branch | 分支受保护 | 推送到新分支然后创建 Merge Request || fetch first | 远程有本地没有的提交 | 先 git pull 合并再推送 || could not read Username | HTTP 认证失败 | 将 Token 嵌入 URL 或配置凭据助手 |## 九、总结本文介绍了将 .NET 项目推送到 GitLab 私有仓库的完整流程重点解决了以下问题1. ✅ 多远程仓库配置2. ✅ Access Token 认证配置3. ✅ 受保护分支的正确处理方式4. ✅ Merge Request 创建流程对于企业级开发建议使用受保护分支 Merge Request 的工作流确保代码质量和权限管控。---**参考资料**- [GitLab Protected Branches](https://docs.gitlab.com/ee/user/project/protected_branches.html)- [GitLab Personal Access Tokens](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html)- [Git Remote 命令详解](https://git-scm.com/docs/git-remote) 欢迎关注我获取更多实战技术文章