跳转至

Git 与项目协作基础配置指南

本项目使用 Git 进行版本控制。本指南将引导您完成 Git 的安装与基础配置，以便参与项目协作。

1. 安装 Git 客户端

如果您尚未安装 Git，请前往 Git 官方网站 下载并安装适用于您操作系统的客户端。

2. 注册 Coding 账号

如果您还没有 Coding.net 的账号，请前往官网注册。

3. 申请协作权限

请发送邮件至 zbx1425@126.com 申请加入项目，邮件中请注明您在 Coding.net 的用户名。审核通过后，您将收到协作邀请。

4. 本地配置

a. 设置用户信息

在开始使用 Git 之前，您需要配置您的用户信息（用户名和邮箱）。这些信息将被记录在您提交的每一次更改中。

  1. 在您打算存放项目的文件夹中，通过鼠标右键菜单选择并打开 Git Bash。 打开 Git Bash

  2. 在弹出的命令行窗口中，依次输入并执行以下三条指令。请将指令中的占位符替换为您自己的信息。

    bash git config --global user.name "您在 Coding.net 注册的用户名" git config --global user.email "您注册时使用的邮箱地址" git config --global credential.helper wincred

b. 克隆项目仓库

配置完成后，您需要将远程的项目代码克隆（下载）到您的本地计算机。

执行以下指令：

git clone https://git.coding.net/zbx1425/zbx1425.coding.me.git

c. 检查远程连接

代码克隆完成后，执行 git remote -v 指令，检查是否已正确设置远程仓库地址。您应该能看到如下输出：

origin  https://git.coding.net/zbx1425/zbx1425.coding.me.git (fetch)
origin  https://git.coding.net/zbx1425/zbx1425.coding.me.git (push)

如果输出为空，请执行 git remote add origin https://git.coding.net/zbx1425/zbx1425.coding.me.git 手动添加。

5. 日常协作流程

a. 保持同步 (Pull)

在开始每天的工作之前，建议先执行 pull 操作，从远程仓库拉取最新的更改，以确保您的本地版本与团队保持同步。

git pull origin master

b. 提交更改 (Commit & Push)

当您完成一部分工作后，可以通过以下步骤将您的更改提交到远程仓库：

  1. 打开 Git GUI: 在项目文件夹中，通过右键菜单打开 Git GUI。 打开 Git GUI

  2. 配置 Git GUI (首次使用):

    • 通过菜单 Edit -> Options，将 Default File Contents Encoding 和 Default Commit Message Encoding 两项均设置为 utf-8，以避免中文乱码。 配置编码

  3. 暂存更改: 点击 "Rescan" 按钮扫描文件改动，然后在左上角的窗格中选中您想提交的文件，点击 "Stage Changed" 将其暂存。

  4. 提交更改: 在右下角的文本框中输入本次提交的摘要信息（例如：“修复 XX bug”或“完成 XX 功能”），然后点击 "Commit"。

  5. 推送至远程仓库: 点击 "Push" 按钮，将您本地的提交上传到远程服务器。 Git GUI 提交界面

c. 解决冲突 (Conflict)

在团队协作中，如果您和他人在同一时间修改了同一个文件的同一部分，当您尝试 push 或 pull 时，Git 可能会提示“冲突 (Conflict)”。

Fast-forward 错误提示

此时，您需要手动解决冲突：

  1. Git 会在冲突的文件中用特殊的标记符（如 <<<<<<<, =======, >>>>>>>）标出不同版本的内容。
  2. 打开这些文件，根据团队的需要，决定保留哪个版本的内容，或将它们合并。
  3. 解决所有冲突后，重新执行 commit 和 push 操作。

手动解决冲突示例