【2026‑最新 Windows】Git 保姆级完整下载、安装、环境配置、SSH 密钥全套教程

适配当前最新稳定版Git‑2.50.1 64 位包含下载渠道、每一步安装参数详解、环境校验、全局用户名邮箱配置、SSH 公钥生成、常见踩坑适合后端、前端、PHP 全栈开发者。一、前置介绍Git 是分布式版本控制工具用于项目代码版本管理、代码提交、分支开发、远程仓库 (Gitee / GitHub / Gitea) 推送拉取Windows 平台推荐安装 git‑for‑windows内置 Git‑Bash、Git‑CMD、图形客户端。二、三种下载渠道优先镜像提速1、官方原版地址https://git‑scm.com/download/win缺点国内下载网速很慢2、npmmirror 国内镜像首选速度快https://registry.npmmirror.com/binary.html?pathgit‑for‑windows/进入文件夹找到最新Git‑2.50.1‑64‑bit.exe3、网盘安装包链接点击下载安装包存放路径禁止中文、空格、特殊符号三、分步安装详细设置每一项参数讲解双击Git‑2.55.0.3‑64‑bit.exe启动安装向导许可协议直接Next安装目录建议安装至固态硬盘非 C 盘示例D:\Git路径全程不要出现中文组件勾选必选默认勾选组件不要取消勾选On the Desktop创建桌面快捷方式 Next开始菜单文件夹保持默认Next选择 Git 默认编辑器新手不懂 Vim下拉选择Notepad/ Windows 记事本老手可保留默认 Vim初始化分支名称新版仓库主流选择Let Git decide/ main老项目兼容就默认 masterPATH 环境配置最重要推荐第二项日常开发标准配置Git from the command line and also from 3rd‑party software可以在 CMD、PowerShell、PHPStorm、VSCode 等软件调用 git 命令不会覆盖 Windows 自带系统工具第一项仅 Git‑Bash 可用IDE 无法识别 git 第三项会覆盖系统 find、sort 命令不推荐SSH 可执行程序默认使用 OpenSSHNextHTTPS 传输后端选用第一项 Use the OpenSSL library换行符转换Windows 开发必看 勾选默认Checkout Windows‑style, commit Unix‑style line endings检出文件自动转为 Windows CRLF 换行提交代码自动转为 Linux 标准 LF 换行解决跨平台换行冲突Git‑Bash 终端模拟器 默认第一项 MinTTY终端体验更好不选用 cmd 控制台​​​​​​​git‑pull 默认行为第一项标准合并模式​​​​​​​凭证管理器选择 Git Credential Manager记住远程仓库账号密码​​​​​​​额外配置选项全部默认勾选开启缓存、符号链接支持​​​​​​​​​​​​​​等待安装进度条跑完安装结束​​​​​​​四、校验 Git 环境是否安装成功两种验证方式方式 1 CMD 终端按下WinR→ 输入cmd回车git --version输出git version 2.50.1.windows.1即为安装成功环境变量自动生效方式 2 右键桌面打开 Git Bash五、全局用户名、邮箱配置提交代码必备提交记录依靠邮箱识别开发者邮箱必须和你的 Gitee/GitHub 账号邮箱一致1、全局配置本机所有项目通用推荐# 设置提交用户名昵称即可非平台账号 git config --global user.name 你的昵称 # 设置远程仓库绑定邮箱 git config --global user.email xxxqq.com2、单项目独立邮箱工作 / 私人仓库分开进入项目根目录打开 Git‑Bash不带--globalgit config user.name 公司名称 git config user.email workcompany.com3、查看全部配置git config --list报错处理fatal: unable to auto‑detect email address 代表没有配置提交邮箱执行上方命令即可解决六、生成 SSH 公钥免密码推送远程仓库适合 GitHub、GiteeHTTPS 每次输入账号密码SSH 实现免密推送Bash 执行生成密钥命令邮箱替换成你配置好的邮箱ssh-keygen -o -t rsa -b 4096 -C xxxqq.com连续三次回车默认存储密钥路径无需设置密钥密码打开密钥文件夹 路径默认C:\Users\你的用户名\.ssh文件资源管理器 → 查看 → 开启【隐藏的项目】才可看见 .ssh 文件夹使用记事本打开id_rsa.pub复制全部文本内容粘贴到 Gitee/GitHub 的 SSH 公钥设置面板测试 SSH 连通性# gitee测试 ssh -T gitgitee.com # github测试 ssh -T gitgithub.com返回欢迎文字代表公钥配置成功七、新手常用基础命令速查表#初始化本地仓库 git init #查看文件状态 git status #添加全部文件至暂存区 git add . #提交代码 git commit -m 初次提交 #绑定远程仓库地址 git remote add origin gitgitee.com/xxx/demo.git #推送至远端main分支 git push -u origin main八、高频问题与避坑清单cmd 提示 git 不是内部或外部命令安装的时候 PATH 选项选错重装选择第二项环境变量配置代码提交之后 GitHub 贡献图不亮 提交邮箱必须和平台绑定邮箱一模一样使用平台提供的 noreply 隐私邮箱Git‑Bash 中文乱码git config --global core.quotepath false换行符冲突、文件全部标记修改 保持默认安装选项检出 CRLF、提交 LF安装路径、项目路径不要带有中文、括号、空格规避绝大多数异常九、IDE 集成PHPStorm、VSCode 会自动读取系统环境变量识别 Git 程序路径安装完成之后即可直接在编辑器内使用版本控制功能。