通过 VS Code 连接 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 中打开项目文件夹。
-
打开终端(<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 方式(推荐)
-
-
-
-
生成 SSH 密钥:
-
-
ssh-keygen -t ed25519 -C "your_email@example.com"
-
-
-
将公钥(
~/.ssh/id_ed25519.pub
)添加到 GitLab 的 SSH Keys(设置 → SSH Keys)。 -
将远程 URL 改为 SSH 格式:
git remote set-url origin git@gitlab.com:yourname/project.git
-
-
7. 验证上传
-
刷新 GitLab 项目页面,确认代码已出现。
常见问题
-
权限错误:检查 SSH 密钥或 PAT 是否配置正确。
-
分支冲突:首次推送前确保远程仓库无初始文件(或先执行
git pull --rebase
)。
通过以上步骤,你的项目应该已成功同步到 GitLab。后续开发中只需重复 提交→推送 流程即可更新远程仓库。