这里以springboot后台项目为例
1. 创建 GitLab 仓库
- 登录 GitLab，点击右上角 New project。
- 填写项目名称和描述，选择公开或私有访问权限。
- 勾选 Initialize repository with a README（可选），点击 Create project。
2. 本地项目初始化 Git
如果项目尚未使用 Git 管理：
# 进入项目根目录（包含 pom.xml 或 build.gradle 的目录）
cd /path/to/your/spring-boot-project
# 初始化本地仓库
git init
# 添加所有文件到暂存区
git add .
# 提交初始版本
git commit -m "Initial commit"
3. 关联远程仓库
在 GitLab 项目页面复制仓库 URL（如 https://gitlab.com/your-username/your-project.git），然后执行：
# 添加远程仓库
git remote add origin https://gitlab.com/your-username/your-project.git
# 推送本地代码到远程仓库（第一次推送需指定上游分支）
git push -u origin main # 若使用 master 分支，则为 git push -u origin master
4. 配置 .gitignore
避免提交不必要的文件（如 IDE 配置、构建产物）。在项目根目录创建 .gitignore 文件，内容如下：
# Maven 项目
target/
# Gradle 项目
.gradle/
build/
# IDE 配置
.idea/
*.iml
*.ipr
*.iws
# 日志文件
*.log
# 环境配置
.env
5. 后续提交流程
# 添加修改的文件
git pull
# 提交代码
git commit -m "Add feature X"
# 推送到远程仓库
git push
6. 使用 SSH 认证（可选但推荐）
为避免每次推送都输入密码，可配置 SSH 密钥：
- 生成 SSH 密钥（如果没有）：
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
- 复制公钥：
cat ~/.ssh/id_rsa.pub
添加到 GitLab：
进入 GitLab → Settings → SSH Keys，粘贴公钥内容。修改远程仓库 URL：
git remote set-url origin git@gitlab.com:your-username/your-project.git
7. 检查项目结构
确保项目根目录包含以下文件：
- pom.xml 或 build.gradle（构建文件）
- src/main/java（源代码）
- src/main/resources（配置文件，如 application.properties）
- .gitignore（可选但推荐）
8. 常见问题
- 权限问题：确保有访问远程仓库的权限。
- 分支冲突：若远程仓库已存在文件，先执行 git pull --rebase origin master。
- 推送失败：检查网络连接和仓库 URL 是否正确。
完成以上步骤后，你的 Spring Boot 项目将成功发布到 GitLab 仓库，可通过 GitLab CI/CD 进一步实现自动化部署。
