Git安装到本地仓库创建：从零搭建完整开发环境

很多人在学习Git的时候，第一步就卡在了环境安装上。“git不是内部或外部命令”、装完以后怎么点都没反应、好不容易装好了却不知道该怎么建本地仓库，这些问题我在带新人的时候几乎每周都能遇到。所以今天这篇内容，我就把Git安装、环境配置、本地仓库创建这一整条链路完整地捋一遍，从下载安装到敲下第一行git init，再到完成第一次提交，每一步都给出可以直接照着做的流程和参数，同时会把我在实际使用中踩过的坑、总结出的经验一起放进来，给正在入门Git的朋友和需要给团队做环境准备的开发同学做一个参考。

1. 工具选型与安装前准备

1.1 不同操作系统下的Git版本选择

先说结论：官网下载地址是git-scm.com，这是Git官方维护的下载站点，无论你用的是Windows、macOS还是Linux，都建议优先从这里获取安装包，而不是去第三方下载站碰运气。第三方站点的问题不在下载速度，而是你拿到的安装包可能被重新打包过，里面夹带了什么你根本不知道。我确实见过有人从某下载站装完Git之后，浏览器主页被改、多了几个来路不明的插件，这属于典型的安装源污染问题，一旦发生，排查起来非常麻烦。

再说版本选择。Git的版本迭代比较快，但对普通开发者来说，没有必要追求最新版。我的建议是：选当前大版本下的小版本号比较高的稳定版，比如2.4x.x这种。新版本上线初期可能存在一些兼容性问题，而太老的版本又会缺一些新命令参数。以Windows平台为例，下载页面里通常会出现“64-bit Git for Windows Setup”和“32-bit Git for Windows Setup”两个选项，现在绝大多数电脑都是64位系统，直接选64位版本即可。如果你不确定自己的系统位数，可以在Windows设置里查看系统信息，或者按住Win+R键输入“dxdiag”查看。

macOS用户分两种情况：如果你电脑上装了Homebrew，一条命令就能装完：brew install git。这种方式的好处是后续升级方便，brew upgrade git就能搞定。如果没装Homebrew，就直接从官网下载macOS版本的安装包，双击安装，和装普通软件没有区别。

Linux用户直接用包管理器就好。Ubuntu/Debian系用sudo apt install git，CentOS/RHEL系用sudo yum install git，Fedora用sudo dnf install git。需要注意的一点是，系统自带的软件源里Git版本可能偏旧，如果对版本有特殊要求，可以通过添加官方源或源码编译的方式安装，但这对绝大多数场景来说没必要，包管理器给的版本足够日常开发使用。

1.2 安装前需要确认的三件事

在动手安装之前，我建议你先确认三件事，因为这三件事会直接影响后面的体验。

第一，系统架构。Windows用户在下载安装包前，先确认自己是64位还是32位系统。虽然现在32位系统基本绝迹了，但万一你手上是一台老旧的测试机，装错版本就会在安装过程中报错，或者装完以后运行不了。第二，权限问题。安装软件需要管理员权限，Windows下请右键安装包选择“以管理员身份运行”，macOS下如果是通过安装包安装，需要在“系统偏好设置 - 安全性与隐私”中允许从App Store和被认可的开发者那里下载的应用程序。第三，已有的开发环境。如果你电脑上已经装了IDE（比如VS Code、IntelliJ IDEA）或者其他版本控制工具，安装Git时要注意版本冲突和PATH环境变量的问题。之前遇到过一位同事装了TortoiseGit（就是大家俗称的“小乌龟”）之后又装Git for Windows，结果两个工具里的Git命令互相干扰，命令行里输入git help的时候弹出的文档位置都不对。这种情况在使用中虽然不致命，但排查起来确实会让人抓狂。

一个小提醒：如果你日常使用主要依靠IDE内置的Git功能，比如VS Code的源代码管理面板，那系统里装一份标准Git环境仍然是必要的，因为IDE内置插件底层调用的还是系统PATH里的git程序。如果没有独立Git环境，很多IDE插件会直接提示找不到Git。

2. 安装步骤与核心配置

2.1 Windows平台安装：每一步选什么

Windows下Git安装向导的步骤比较多，大概有十几个页面。这里我不把所有页面都列一遍，只挑几个容易选错、但影响很大的选项重点讲。

第一个是“Select Components”（选择组件）这一步。默认情况下，“Git Bash Here”和“Git GUI Here”是勾选状态，建议保留。Git Bash是Windows下最常用的Git命令行终端，它提供了一个类Linux的shell环境，很多在CMD里跑不了或很难跑的命令在Git Bash里就是一条命令的事。额外建议勾选“Add a Git Bash Profile to Windows Terminal”，这样你可以在Windows Terminal里直接打开Git Bash，体验会好很多。

第二个是“Choosing the default editor”（选择默认编辑器）。Git在某些场景下（比如写commit message、处理合并冲突）会调用一个编辑器。默认选的是Vim，但对不熟悉Vim的人来说，进去以后连怎么保存退出都搞不明白，现场非常尴尬。我见过不止一个新手在Vim里写完提交说明，然后发现不知道怎么关闭，最后直接把命令行窗口关了，结果提交没成，还留下了lock文件。所以这里建议直接选择你平时用的编辑器，比如VS Code、Notepad++，选VS Code的话后面写提交消息会很顺手。如果列表里没有，就选最下面的“Select editor manually”，后续自己配置。

第三个是“Adjusting your PATH environment”（调整PATH环境变量）。这里有三个选项，第一个是“Git from the command line and also from 3rd-party software”，第二个是“Git from the command line only”，第三个是“Use Git