Git 安装流程与基础使用步骤

点击 Next 进入下一步；

个人使用选 Use the OpenSSL library，点击 Next 进入下一步；

点击 Next 进入下一步；

点击 Next 进入下一步；

Adjusting the name of the initial branch (调整初始分支名): 推荐选择 Override the default branch name for new repositories，并在文本框中填入 main。这是目前的行业通用标准，能减少推送到远端时的命名冲突。

默认的是 vim 编辑器，一般使用默认的即可；点击 Next 进入下一步，后续可以手动修改。

点击 Next；

这一步按照默认即可，点击 Next；

选择安装目录，点击 Browse…按钮，这里建议安装除 C 盘外其他盘，选择完成后，点击按钮 Next；

下载完成后，双击下载的 exe 程序，如图所示，之后点击 Next；

二、环境配置

安装完成后，在桌面空白处右键，选择 Open Git Bash here（或者在终端中打开 Git Bash），进行基础信息的全局配置。

1. 配置用户名和邮箱

每次提交代码都会记录这些信息，这是必须执行的一步。

git config --global user.name "你的英文昵称或姓名"
git config --global user.email "你的常用邮箱@example.com"

2. 生成 SSH 密钥 (免密登录 GitHub/Gitee 必备)

不配置 SSH，每次推送代码都需要频繁输入账号密码。目前推荐使用更安全的 ed25519 算法。

ssh-keygen -t ed25519 -C "你的常用邮箱@example.com"

连续按三次回车（不设置额外密码）。生成后，输入以下命令查看并复制你的公钥内容，将其粘贴到 GitHub 或 Gitee 的 SSH Keys 设置中：

cat ~/.ssh/id_ed25519.pub

Notepad++ 是一个非常经典的轻量级选择，打开速度极快，用来写 Git 的提交信息再合适不过了。 不过，配置 Notepad++ 会比配置系统自带的记事本稍微复杂一点点。你需要指定它的绝对路径，并且加上几个特定的启动参数，这样才能确保 Git 会乖乖等待你写完并关闭窗口后再继续执行，而不是瞬间闪退报错。

配置 Notepad++ 为默认编辑器

打开 Git Bash 或终端，输入以下命令，更换成你自己的 notepad++.exe 路径：

git config --global core.editor "'E:/1-ProgramFiles/Notepad++/notepad++.exe' -multiInst -notabbar -nosession -noPlugin"

• -multiInst: 强制打开一个新的 Notepad++ 独立窗口。
• -nosession: 启动时不加载你上次没关掉的历史文件，保持输入界面绝对清爽。
• -notabbar: 隐藏顶部的标签栏，让它看起来就是一个纯粹的文本输入框。
• -noPlugin: 禁用插件加载，实现'秒开'，写完就关，绝不拖泥带水。

配置完成后，以后每次遇到需要写复杂提交说明的情况（比如直接敲了 git commit），系统就会秒开一个干净的 Notepad++。需要写好内容，按下 Ctrl + S 保存，然后关掉这个窗口，Git 就会自动读取并完成提交了。

三、Git 基础工作流

理解 Git 的四个区域是掌握它的关键：工作区（你写代码的地方）、暂存区（计划提交的改动）、本地仓库（保存历史记录）和远程仓库（云端代码）。

1. 初始化本地仓库

进入你的项目文件夹，右键打开 Git Bash，输入：

git init

这会在当前目录下生成一个隐藏的 .git 文件夹，你的本地仓库就建立好了。

2. 将文件添加到暂存区

告诉 Git 你想保存哪些文件的改动。

git add .

(注意：add 后面的 . 代表添加当前目录下所有改动的文件。)

3. 提交到本地仓库

给这次改动写一个简短的说明，将其永久记录在本地。

git commit -m "feat: 初始化项目架构"

4. 关联远程仓库并推送代码

在云端（如 GitHub/Gitee）新建一个空仓库后，复制其 SSH 地址，执行以下命令：

git remote add origin <你的远程仓库 SSH 地址>
git push -u origin main

四、常见问题与解决方案

• 灾难 1：没有配置 .gitignore 文件
  • 坑点： 直接 git add . 会把本地的编译文件、虚拟环境或依赖包全部传到云端。比如 Python 的 pycache 和 venv，或者前端 Vue 项目中动辄几百兆的 node_modules。这不仅会导致推送极慢，还会让仓库迅速膨胀。
  • 解决： 在执行第一次 git add . 之前，务必在项目根目录创建一个名为 .gitignore 的文件，将不需要版本控制的目录名写进去。
• 灾难 2：大文件导致推送失败
  • 坑点： Git 不适合管理超大文件。如果你把动辄几百 MB 的模型权重文件（比如 YOLO 的 .pt 文件）或者庞大的数据集直接 commit，git push 时大概率会报错并拒绝接收。
  • 解决： 将数据集目录和权重文件加入 .gitignore。如果确实需要管理大文件，需要额外安装配置 Git LFS (Large File Storage)。
• 灾难 3：换行符警告 (LF will be replaced by CRLF)
  • 坑点： 在 Windows 上经常会遇到这个警告，虽然不影响核心代码，但满屏的警告非常干扰视线。
  • 解决： 运行命令 git config --global core.autocrlf true 让 Git 自动处理换行符转换即可放心忽略。