将本地项目上传到 GitLab/GitHub

以下是将本地项目上传到 GitLab 的完备步骤，从创建仓库到推送代码的具体流程：

---

1. 在 GitLab 上创建新项目

• 登录 GitLab，点击 New project。
  
• 选择 Create blank project。
  
• 填写项目信息：
  
  
  
  • Project name: 项目名称（如 my-project）。
    
  • Visibility Level: 选择仓库可见性（公开/私有/内部）。
    
  • Initialize repository with a README: 不要勾选（避免推送冲突）。
    
  
  
• 点击 Create project，天生一个空仓库。
  

---

2. 准备本地项目

假如项目未初始化 Git

1. # 进入项目目录
2. cd /path/to/your/project
4. # 初始化 Git 仓库
5. git init
7. # 添加所有文件到暂存区
8. git add .
10. # 提交初始版本
11. git commit -m "Initial commit"

复制代码

假如项目已是 Git 仓库

确保暂存区干净：

1. git status  # 确认无未提交的修改

复制代码

---

3. 关联远程仓库

获取 GitLab 仓库的 URL（HTTPS 或 SSH）：

• HTTPS：适合临时利用，需每次输入账号密码。
  
• SSH：推荐恒久利用，需提前配置 SSH 密钥。
  

添加远程仓库地点

1. git remote add origin git@gitlab.com:your-username/your-project.git

复制代码

或利用 HTTPS：

1. git remote add origin https://gitlab.com/your-username/your-project.git

复制代码

验证远程仓库

1. git remote -v

复制代码

应体现：

1. origin  git@gitlab.com:your-username/your-project.git (fetch)
2. origin  git@gitlab.com:your-username/your-project.git (push)

复制代码

---

4. 推送代码到 GitLab

首次推送（逼迫关联分支）

1. git push
2. -u origin main
3. # 若本地分支名为 master，则改为：
4. # git push
5. -u origin master

复制代码

后续推送

1. git push

复制代码

---

5. 处理处罚常见问题

问题 1：远程仓库非空（如误勾选 README）

报错示例：

1. ! [rejected] main -> main (non-fast-forward)

复制代码

办理方案：

• 拉取远程仓库并合并：
  1. git pull origin main --allow-unrelated-histories

  复制代码
• 办理冲突后重新推送：
  1. git push
  2. -u origin main

  复制代码

问题 2：权限不足（SSH 配置）

报错示例：

1. Permission denied (publickey).

复制代码

办理方案：

• 天生 SSH 密钥：
  1. ssh-keygen -t ed25519 -C "your-email@example.com"

  复制代码
• 将公钥 ~/.ssh/id_ed25519.pub 添加到 GitLab：
  
  
  
  • 进入 GitLab → Settings → SSH Keys → 粘贴公钥。
    
  
  

---

完备操作示例

1. # 初始化项目cd my-projectgit initgit add .git commit -m "Initial commit"# 关联远程仓库git remote add origin git@gitlab.com:your-username/my-project.git# 推送代码git push
2. -u origin main

复制代码

---

增补说明

• 分支管理：默认分支可能是 main 或 master，根据 GitLab 仓库设置调解。
  
• 忽略文件：建议创建 .gitignore 文件排除临时文件（如 node_modules/, .env 等）。
  
• 协作权限：私有项目需在 GitLab 中添加协作者（Settings → Members）。
  

---

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。