目录
前置条件
- 基础工具:请确保安装了 VS Code 或 VSCodium。
- 浏览器:建议使用 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 来创建新分支,或者选择现有分支进行切换。
- 提交和推送时,会自动提交到当前分支。
项目协作流程
- 拉取最新代码:每次开发前,通过 VS Code 同步最新代码,点击 Pull。
- 创建功能分支:为每个新功能或修复创建单独的分支,保持主分支的稳定。
- 在状态栏点击当前分支名,选择 Create new branch。
- 开发和提交代码:在功能分支上进行开发,确保每次提交信息简洁明了。
- 发起合并请求(MR):功能开发完成后,进入 GitLab,创建合并请求 (Merge Request),请求将代码合并到主分支。
- 代码审查和合并:代码通过审核后,合并到主分支。
- Netlify 部署:合并完成后,Netlify 会自动进行部署。关于Netlify的更多内容,请参考Netlify 基础部分。
常见问题和解决方案
- 代码冲突:如果拉取时出现冲突,VS Code 会在文件中标记冲突部分,选择保留的内容后保存并提交。
- 无法推送代码:如果推送失败,通常是因为没有拉取最新代码,点击 Pull 更新本地代码后再尝试推送。