GitLab 入门指南

本教程涵盖如何安装 VS Code 或 VSCodium,以及通过 VS Code 完成 Git 操作,包括导入仓库、提交和推送代码。所有 Git 操作都将通过 VS Code 内置的 Git 功能完成,尽量简化操作步骤。

目录

  1. 前置条件
  2. 安装 VS Code 或 VSCodium
  3. 通过 VS Code 进行 Git 操作
  4. 项目协作流程
  5. 常见问题和解决方案

前置条件

  • 基础工具:请确保安装了 VS CodeVSCodium
  • 浏览器:建议使用 Chrome 或 Firefox 浏览器,便于开发调试。
  • Git 账号:注册 GitLab 账号,并加入团队项目。
  • Netlify 账号:注册 Netlify 账号。

安装 VS Code 或 VSCodium

1. 下载 VS Code

  • 访问 VS Code 官方网站,根据操作系统(Windows、macOS、Linux)下载合适的安装包。
  • 下载完成后,双击安装包,按照提示进行安装。

2. 下载 VSCodium(可选)

  • 如果偏好使用开源版本,可以选择 VSCodium。访问 VSCodium 官方网站,选择适合的操作系统版本下载。
  • 下载完成后,双击安装包,按照提示进行安装。

3. 安装 GitLab 插件

  • 打开 VS Code 或 VSCodium,进入左侧的扩展市场(或使用快捷键 Ctrl + Shift + X)。
  • 搜索并安装 GitLab Workflow 插件,以便与 GitLab 进行更方便的集成。

通过 VS Code 进行 Git 操作

1. 配置 Git 用户信息

  • 打开 VS Code,按 Ctrl + Shift + P(macOS 上是 Cmd + Shift + P)调出命令面板,输入 Git: Configure User Name 设置 Git 用户名,输入你的名字。
  • 输入 Git: Configure User Email 设置 Git 用户邮箱。

2. 克隆 GitLab 仓库到本地

  • 复制 GitLab 项目页面中的仓库 HTTPS 地址。
  • 在 VS Code 中,按 Ctrl + Shift + P(macOS 上是 Cmd + Shift + P),输入并选择 Git: Clone
  • 粘贴仓库地址并选择本地保存的位置。VS Code 会自动下载仓库并打开项目。

3. 提交代码更改

  • 修改项目文件后,点击左侧活动栏中的 源代码管理 图标(即 Git 图标)。
  • 你将看到已修改的文件列表,点击每个文件旁边的 + 图标将其添加到暂存区,或者点击 + 旁边的按钮添加所有更改。
  • 在输入框中填写提交信息(如 “修复登录页面错误”),然后点击 提交更改。

4. 推送代码到远程仓库

  • 提交后,点击右上角的 按钮,选择 Push 或点击下方状态栏中的 Push
  • VS Code 将自动将本地提交推送到 GitLab 上的远程仓库。

5. 从远程仓库拉取代码

  • 如果需要同步远程仓库的最新更改,可以点击 Pull 按钮,VS Code 将自动拉取并更新本地代码。

6. 创建和切换分支

  • 在 VS Code 下方的状态栏中,点击当前分支名称,选择 Create new branch 来创建新分支,或者选择现有分支进行切换。
  • 提交和推送时,会自动提交到当前分支。

项目协作流程

  1. 拉取最新代码:每次开发前,通过 VS Code 同步最新代码,点击 Pull
  2. 创建功能分支:为每个新功能或修复创建单独的分支,保持主分支的稳定。
    • 在状态栏点击当前分支名,选择 Create new branch
  3. 开发和提交代码:在功能分支上进行开发,确保每次提交信息简洁明了。
  4. 发起合并请求(MR):功能开发完成后,进入 GitLab,创建合并请求 (Merge Request),请求将代码合并到主分支。
  5. 代码审查和合并:代码通过审核后,合并到主分支。
  6. Netlify 部署:合并完成后,Netlify 会自动进行部署。关于Netlify的更多内容,请参考Netlify 基础部分。

常见问题和解决方案

  1. 代码冲突:如果拉取时出现冲突,VS Code 会在文件中标记冲突部分,选择保留的内容后保存并提交。
  2. 无法推送代码:如果推送失败,通常是因为没有拉取最新代码,点击 Pull 更新本地代码后再尝试推送。