在使用 GitLab 进行版本管理时，经常需要将本地已经开发好的项目代码同步到远程仓库。本文将详细介绍如何通过 Git 命令行完成这一操作。

准备工作
确保本地已安装 Git。
已经在 GitLab 上创建了一个空的 Project（仓库），并获取到了仓库地址，例如： http://gitlab.mak.com:10080/hmk/player.git
核心步骤

1. 初始化本地仓库
   进入你的项目根目录，打开终端或命令行，执行初始化命令：

bash
git init
这会在当前目录下生成一个隐藏的 .git 文件夹，用于版本追踪。

2. 关联远程仓库地址
   将本地仓库与远程 GitLab 仓库进行绑定：

bash
git remote add origin http://gitlab.mak.com:10080/hmk/player.git
注：origin 是习惯上的远程仓库别名。

3. 添加文件到暂存区
   将所有待提交的文件添加到 Git 的追踪范围：

bash
git add .
建议：确保根目录下有 .gitignore 文件，以排除不需要上传的临时文件（如 build/、.dart_tool/ 等）。

4. 提交到本地仓库
   给这次上传打上标签或说明：

bash
git commit -m “initial commit: 首次提交项目代码”
5. 推送到远程仓库
最后一步，将本地代码推送至远程 GitLab 仓库的主分支：

bash
git push -u origin master
提示：如果是第一次推送，加上 -u 参数可以建立本地分支与远程分支的追踪关系。如果你的默认分支是 main，请将 master 改为 main。

常见问题排查
Q1: 提示认证失败 (Authentication failed)
原因：GitLab 需要验证你的身份。 解决：在弹出框中输入正确的 GitLab 用户名和密码。如果使用了 SSH 地址，请确保已在 GitLab 中配置了 SSH Key。

Q2: 提示远程仓库已存在 (remote origin already exists)
解决：如果之前关联过错误的地址，可以先删除旧的关联再重新添加：

bash
git remote rm origin
Q3: 远程分支冲突 (rejected)
原因：远程仓库可能不是空的（比如有 README 文件）。 解决：先同步远程代码到本地，再推送：

bash
git pull origin master --allow-unrelated-histories
总结
通过简单的 init、remote add、add、commit、push 五步走，我们就能快速建立起本地与远程的连接。GitLab 是极佳的项目协作平台，掌握基础命令是每个开发者的必备技能。

如果本文对你有帮助，欢迎点赞、收藏并关注！