前言
Git 是管理代码的工具，无论是在搭建前后端分离的复杂架构，还是在调试庞大的深度学习模型，一个清晰、规范的版本控制系统能帮你避开无数次'代码重构'带来的崩溃。Git 工具在大学期间实训时和工作中都会用到，那么今天在新电脑上手把手安装 Git 工具。
一、Git 下载与保姆级安装步骤
前往 Git 官方网站（https://git-scm.com/），点击 Download Git for Windows 按钮。
下载最新的 64-bit Git for Windows Setup。
运行安装程序，点击 Next 进入下一步。
点击 Install 开始安装。
点击 Next 进入下一步。
点击 Next 进入下一步。
点击 Next 进入下一步。
点击 Next 进入下一步。
个人使用选 Use the OpenSSL library，点击 Next 进入下一步。
点击 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 自动处理换行符转换即可放心忽略。
