九月之秋写这篇东西的起因特别简单：那天有个刚转行的朋友问我，公司让他用IDEA拉一个Git项目下来，他从装Git到配IDEA折腾了一整天，最后卡在“无法将‘git’项识别为 cmdlet”这行报错上，截图发过来时我能感受到那种绝望。后来我远程带他走了一遍完整的安装、配置、导入流程，他才意识到原来不是自己笨，是网上教程实在太碎了——有人只讲命令不讲环境，有人只讲安装不讲配置，真正把“从零到能在IDEA里提交代码”这一整条链路串起来的文章很少。
所以这篇就是来干这个事的。不管你是刚入职的新人、从SVN转过来的老开发，还是纯粹想把Git弄明白的初学者，这篇文章会把Windows环境下Git安装、IDEA导入Git项目、日常高频命令和典型的报错排查一次讲全，每一步都告诉你为什么这么选、踩坑点在哪。
1. 为什么Git环境配置对新手来说是道隐形的坎
先聊一个很多人没意识到的问题：Git本身其实是一个社区味特别重的工具，它的安装包、命令行交互方式、概念命名都默认使用者“已经懂了一些东西”。这就导致新手遇到的困难往往不是Git命令记不住，而是环境层面的问题——路径没配好、编辑器选错、换行符处理不对、认证方式没整明白，任何一个环节卡住，后面的步骤全都白搭。
还有一个容易被忽略的点是，Git和代码托管平台（GitHub、Gitee、GitLab）是两码事。Git是一套版本控制系统，跑在本地；托管平台是放代码的地方，负责帮你存仓库、管权限。新手如果没分清这一层，就会产生“我明明注册了GitHub，为什么push的时候还要我输用户名密码”之类的困惑。实际上你本地写代码用的Git命令，和你在网页上看到的提交记录之间，是通过本地仓库的远程地址和认证信息串起来的。
我个人在教学过程中发现，对新手最友好的理解方式是这样一条链路：
- 本地代码目录通过
git init变成一个仓库，Git开始跟踪里面文件的变化 - 每次修改后通过
git add把文件放入暂存区，再通过git commit生成一个版本记录 - 需要和同事协作时，通过
git push把本地的提交推到托管平台上的远程仓库 - 同事通过
git pull把最新代码拉到自己本地，两边以远程仓库为中间点同步
整条链路里，除了第一条命令是本地操作之外，其他环节都可能涉及认证、分支、冲突处理。这也是为什么我坚持先讲环境，再讲命令，最后讲报错——顺序反了，十个有九个会被卡住。
另外一个常见的认知误区是把IDEA的Git功能和命令行对立起来。其实IDEA里的提交、推送、拉取、分支切换，底层调用的就是Git命令行，只是给你包了一层图形界面。所以你完全可以从IDEA开始学，但理解底层命令会让你在出问题时多一条排查路径，这也是后面我讲命令时希望你记住的点。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. Windows下Git安装的全流程，以及安装向导里那些被忽略的选项
2.1 先从哪下载、选什么版本
Git的官方网站是git-scm.com，下载页会自动检测操作系统。Windows用户直接选64-bit版本就行，除非你还在用远古32位系统。官网下载如果速度不理想，可以用国内的镜像站下载，比如阿里的镜像、清华的镜像，或者华为云的镜像，版本号保持一致就好。
版本选择上，我的建议是不要追最新，也不要停留在太旧的版本。Git官方迭代速度不算快，半年到一年左右一个大版本是常态，稳定版一般都没有太大问题。唯一需要注意的是，你本地用的Git版本最好和同事、和CI服务器不要差太远，否则可能出现某个分支策略或命令选项在别人机器上能用、在你机器上报错的情况。比如老版本Git默认分支名是master，2020年之后的版本默认分支名变成main，这种差异会让新手一头雾水。
2.2 安装向导里真正影响后续体验的几个选项
Git的Windows安装包是一个标准的向导式安装，一路Next也不是不行，但中间有几个页面选错了，后续会很麻烦。
Select Components页面
默认选项其实够用。但有一个容易被忽略的选项叫“Git LFS（Large File Support）”，如果你的项目里涉及二进制大文件（比如设计稿、打包产物、模型文件），建议把这个勾上。大文件直接进Git仓库会把仓库体积撑爆，LFS是官方推荐的替代方案，后面说到的命令 git lfs track 就靠它支持。
还有一个“Add a Git Bash Profile to Windows Terminal”之类的选项，新版安装包可能会和Windows Terminal集成，建议勾上，这样你在Windows Terminal里就能直接开Git Bash，不用单独开一个黑窗口。
Default editor used by Git
这个页面会问你Git默认用哪个编辑器来写提交信息。默认是Vim，但对绝大多数不熟悉Vim的人来说，进到那个界面之后连退出都费劲——按了ESC再输 :wq，结果一脸懵。我强烈建议在这里选择你熟悉的编辑器，比如Notepad++、VS Code，甚至Sublime Text。选VS Code的人挺多，操作顺手且安装量大。装完之后这个设置也可以通过 git config --global core.editor "code --wait" 改回来。
Adjusting your PATH environment
这是全流程中最关键的选项，没有之一。它有三个选项：
- 第一个是“仅从Git Bash使用Git”，选这个的话你在CMD或PowerShell里输入git会直接报“不是内部或外部命令”
- 第二个是“从命令行以及第三方软件使用Git”，会帮你的系统PATH加上Git路径，推荐选这个
- 第三个是“从命令提示符使用Git和可选的Unix工具”，不太建议，它会覆盖Windows自带的一些同名命令
有很多人装完之后在PowerShell里敲 git 提示识别不了，十有八九是这里选了第一项，或者完全没有注意这个选项。如果已经装完才发现，最简单的办法是改系统环境变量，把 C:\Program Files\Git\cmd 这个路径加到PATH里，或者重新跑一遍安装包，Modify之后改这个选项。
Checkout style / Line endings
Git默认安装界面会问你“Checkout Wind