【Git】零基础入门实战教程（Windows 完整版，适配竞赛仓库）

Git 零基础入门实战教程（Windows 完整版，适配竞赛仓库）

0. 前置说明

适用人群：完全零基础、学生、竞赛参赛人员

适用系统：Windows1011

适配仓库：红枫2026仿真平台仓库（含 LFS 大文件）

学习目标：会下载代码、会更新代码、会保存自己的修改、会回滚错误

核心理念：Git 只干三件事：下载代码、保存改动、同步更新

1. 安装与环境配置（仅第一次需要）

1.1 安装 Git

备用靠谱下载地址（官网镜像，可直接复制打开）：

https:/npmmirror.com/mirrors/git-for-windows/

下载最新版 64-bit 安装包，安装全程默认下一步，无需修改任何配置。

1.2 首次全局配置（必须执行）

电脑任意空白位置右键 → Git Bash Here，复制以下命令，替换为自己的用户名和邮箱：

bash 复制代码

git config --global user.name "你的用户名"
git config --global user.email "你的邮箱@qq.com"

作用：注册本地Git身份，所有代码提交必须依赖该配置。

查看配置是否成功：

bash 复制代码

git config --global --list

2. 核心概念（看懂永不操作出错）

远程仓库：服务器云端代码（本次使用的 osredm 竞赛仓库）
本地仓库：电脑本地存放的代码文件夹
工作区：正在编辑、修改的代码文件
暂存区：临时存放待提交的代码改动
本地版本库：保存每一次代码修改的版本记录，支持回退

标准开发流程：修改文件 → 暂存改动 → 本地提交 → 拉取远程更新/推送代码

3. 五大核心常用命令（日常99%场景够用）

3.1 克隆下载完整远程仓库（首次拉代码）

通用命令：

bash 复制代码

git clone 仓库地址

本次竞赛专属仓库命令（直接复制使用）：

bash 复制代码

git clone https://osredm.com/hf2026/hf2026-sim-windows.git

3.2 查看代码改动状态

bash 复制代码

git status

标识说明：红色=未暂存改动，绿色=已暂存改动

3.3 暂存所有文件改动

bash 复制代码

git add .

「.」代表当前目录下所有文件、所有改动，一键暂存

3.4 本地提交版本（保存修改）

bash 复制代码

git commit -m "本次修改说明"

示例：git commit -m "优化无人机协同算法参数"

3.5 拉取远程最新代码（同步更新）

bash 复制代码

git pull

作用：拉取服务器最新更新，同步本地代码，避免版本落后

4. 竞赛仓库专属操作（适配 LFS 2.5G大文件）

该仓库包含 2.5G dataset.zip 超大文件，采用 Git LFS 存储，首次克隆后若文件空白、缺失、大小异常，执行以下命令修复：

bash 复制代码

# 初始化LFS大文件支持（仅首次需要执行）
git lfs install
# 完整拉取所有远程大文件
git lfs pull

5. 竞赛通用完整工作流（每日固定操作）

每次开发调试前先更新代码，结束后保存版本，杜绝冲突：

bash 复制代码

# 1. 拉取远程最新代码
git pull
# 2. 自行修改、调试算法代码

# 3. 查看所有改动
git status
# 4. 暂存全部修改
git add .
# 5. 提交本地版本（备注修改内容）
git commit -m "优化无人集群协同算法"

6. 高频报错解决方案（新手必看）

6.1 代码版本冲突（merge conflict）

报错原因：本地修改了文件，远程仓库同步更新了同一文件，版本重叠

新手稳妥解决方式：备份本地修改文件，删除旧仓库文件夹，重新克隆完整仓库

6.2 克隆/拉取代码超时、速度极慢

bash 复制代码

git config --global http.lowSpeedLimit 0
git config --global http.lowSpeedTime 99999

6.3 文件中文乱码、路径识别异常

bash 复制代码

git config --global core.quotepath false

7. 常备备用命令（应急使用）

bash 复制代码

# 查看所有历史提交记录
git log

# 放弃所有本地修改，恢复仓库原始状态
git checkout .

# 查看当前绑定的远程仓库地址
git remote -v

8. 新手避坑使用习惯

每次打开项目先执行 git pull，最大程度避免版本冲突
禁止手动删除仓库内的 .git 隐藏文件夹，会损坏仓库版本记录
每完成一项功能修改就执行一次 commit，方便后续版本回退
大文件缺失、加载异常，优先执行 git lfs pull 修复