Windows下Git安装配置与Gitee远程仓库连接完整指南

我见过太多人卡在Git安装这一步：下载链接找不到、装完右键没有Git Bash、刚push就报错、换个电脑又不会配了。这篇文章就针对Windows环境，从零开始把Git装好、配好，再连上Gitee远程仓库，把代码完整推上去。整个过程覆盖下载安装、SSH免密配置、仓库推送、VS Code可视化操作和常见报错排查，适合刚接触版本控制的同学，也适合已经在用但总被奇怪问题卡住的人。

1. 开始之前的准备：Windows下安装Git的正确姿势

1.1 下载版本怎么选

Git的Windows发行版叫Git for Windows，官网地址是git-scm.com/download/win，打开后页面会自动识别当前操作系统的位数，一般直接点“64-bit Git for Windows Setup”就行。

有一点要注意：如果你用的是比较老的32位系统，需要去页面下方的“Older releases”或者“Windows 32-bit”入口找对应版本。现在绝大多数Windows 10/11都是64位，直接下载最新版即可。国内网络访问官网速度不稳定的话，可以用阿里云镜像、淘宝npm镜像等地方下载，搜索“git for windows 镜像”能找到带完整安装包的地址，版本号对得上就行。

1.2 安装过程里最容易选错的几个选项

安装包下载完双击运行，大部分步骤一路Next不会出大问题，但有四个选项会影响后续使用体验，我逐个说下。

第一是安装路径。默认在C:\Program Files\Git，路径带空格其实现代工具都能处理，但我建议改成不带空格不带中文的路径，比如C:\Git。这不是玄学，以前遇到过某些脚本和工具解析带空格的路径时莫名报错，改成纯英文路径后问题消失，属于“没坏处、能避坑”的习惯。

第二是“Select Components”这一步。默认勾选了“Git Bash Here”和“Git GUI Here”，这两个右键菜单一定要保留。日常开发里你随便打开一个文件夹，右键就能进Git Bash，比每次手动切目录方便太多。其他的组件按默认即可。

第三是默认编辑器。如果你装了VS Code，这一步可以直接选“Use Visual Studio Code as Git's default editor”。没有的话选“Use Nano”或者“Use Vim”都行，后面也可以在命令行里改，不影响核心功能。

第四是最关键的“Adjusting your PATH environment”。这个选项有三个单选：

• “Use Git from Git Bash only”：只把Git集成到Git Bash里，cmd和PowerShell里用不了。
• “Git from the command line and also from 3rd-party software”：推荐选这个。
• “Use Git and optional Unix tools from the Command Prompt”：不推荐，会把一堆Unix命令混进Windows命令行环境，容易出乱子。

我见过有人选第一个，结果在VS Code的终端里敲git提示“不是内部或外部命令”，其实就是这一步选错了。选第二个之后，cmd、PowerShell、VS Code自带终端里都能直接用git命令，最省心。

1.3 继续安装时要注意的细节

继续往下，到“Choosing the SSH executable”这一步，默认“Use OpenSSH”就行，除非你电脑系统特别旧导致OpenSSH组件缺失，否则不用改。

“Choosing HTTPS transport backend”同样保持默认“Use the OpenSSL library”，这个跟HTTPS证书校验有关，大多数场景下默认即可。如果你在的公司内网有用自签名证书，后面遇到证书报错再单独配置。

“Line Ending Conversions”是Windows平台特有的坑。建议选第一个“Checkout Windows-style, commit Unix-style line endings”。意思是：拉取代码到本地时自动转成Windows的CRLF，提交时自动转回Unix的LF。这样Windows和Linux/macOS的同事协作时，不会因为换行符差异导致整个文件被标记成修改。如果你的团队里有人专门处理过行尾问题，他们通常会给出更严格的要求，否则默认第一个就是最省事的选择。

“Use MinTTY”这个终端模拟器选项，我建议保持默认选MinTTY。它在中文显示、鼠标选择、复制粘贴这些体验上比Windows自带console窗口舒服得多。

装完之后，在任意文件夹空白处右键，点“Git Bash Here”，输入：

bash复制git --version

能输出版本号就说明安装成功。比如git version 2.45.1.windows.1。

2. 让Git知道你是谁：首次全局配置

装完Git第一件事不是急着连远程仓库，而是先配置用户身份。因为Git的每一次提交都会把“作者”和“提交者”信息写进记录里，不配的话后面提交会报错，或者提交记录上显示一个乱七八糟的默认用户名。

打开Git Bash，执行：

bash复制git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

这里的名字和邮箱建议跟你在Gitee上注册时用的信息一致，这样提交记录里能直接对应到你的Gitee账号。--global的意思是全局生效，这台电脑上以后所有仓库都会用这套身份。

想确认配置是否生效，可以执行：

`