> 技术文档 > 通过 VS Code 连接 GitLab 并上传项目_vscode gitlab

通过 VS Code 连接 GitLab 并上传项目_vscode gitlab

通过 VS Code 连接 GitLab 并上传项目,请按照以下步骤操作:

1. 安装必要工具

  • 确保已安装 Git 并配置用户名和邮箱:

git config --global user.name \"你的用户名\"

git config --global user.email \"你的邮箱\"

  • 在 VS Code 中安装官方 GitLens 扩展(可选但推荐)。

2. 在 GitLab 上创建新项目

  • 登录 GitLab,点击 \"New project\"

  • 选择 \"Create blank project\",填写项目名称和描述。

  • 记录项目 URL(如 https://gitlab.com/yourname/project.git)。

3. 初始化本地仓库

  • 在 VS Code 中打开项目文件夹。

  • 打开终端(Ctrl+`),执行:

git init git remote add origin 你的项目URL

4. 提交代码到本地仓库

  • 点击 VS Code 左侧的 源代码管理图标(或按 Ctrl+Shift+G)。

  • 暂存更改(点击文件旁的 + 或输入命令):

git add .

  • 提交更改(输入提交信息后点击 √):

git commit -m \"初始提交\"

5. 推送到 GitLab

  • 首次推送需指定上游分支

git push -u origin master # 或 main(根据你的分支名)

  • 后续推送可直接使用:

git push

6. 身份验证

  • 如果提示输入凭据:

    • HTTPS 方式:输入 GitLab 用户名和密码(推荐使用 Personal Access Token 替代密码)。

    • SSH 方式(推荐)

      1. 生成 SSH 密钥:

ssh-keygen -t ed25519 -C \"your_email@example.com\"

      1. 将公钥(~/.ssh/id_ed25519.pub)添加到 GitLab 的 SSH Keys(设置 → SSH Keys)。

      2. 将远程 URL 改为 SSH 格式:

        git remote set-url origin git@gitlab.com:yourname/project.git

7. 验证上传

  • 刷新 GitLab 项目页面,确认代码已出现。

常见问题

  • 权限错误:检查 SSH 密钥或 PAT 是否配置正确。

  • 分支冲突:首次推送前确保远程仓库无初始文件(或先执行 git pull --rebase)。

通过以上步骤,你的项目应该已成功同步到 GitLab。后续开发中只需重复 提交→推送 流程即可更新远程仓库。