实用指南：通过 VS Code 连接 GitLab 并上传项目

通过 VS Code连接 GitLab 并上传方案，请按照以下步骤处理：

1. 安装必要工具

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

gitconfig --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 中打开任务文件夹。

• 打开终端（<kbd>Ctrl</kbd>+<kbd>`</kbd>），执行：

git init git remote add origin 你的项目URL

4. 提交代码到本地仓库

• 点击 VS Code 左侧的 源代码管理图标（或按 <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>G</kbd>）。

• 暂存更改（点击文件旁的 + 或输入命令）：

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。后续研发中只需重复 提交→推送 流程即可更新远程仓库。