必须完成安装、环境配置和基础仓库初始化三步:下载Git安装包并核对SHA256,安装时路径禁用中文/空格、PATH选“命令行及第三方软件可用”、换行符选“Windows检出/Unix提交”,安装后验证版本、配置user.name/email,最后git init初始化仓库。

你想在Windows上用Git管理代码版本,必须先完成安装、环境配置和基础仓库初始化三步,缺一不可。跳过其中任何一步,后续执行git init或git add都会报“不是内部或外部命令”或“fatal: not a git repository”错误。
下载并运行官方安装包
打开浏览器,访问 https://www.php.cn/link/7ca2d2c04c0bb98f7b3481751387214a,点击“Download for Windows”按钮下载最新稳定版(当前为 Git 2.55.0-64-bit.exe)。
国内用户若下载缓慢,可改用清华大学镜像站:https://www.php.cn/link/b394467db4a62ac8b46943a4f5fa519e,下载后核对页面下方 Assets 区域提供的 SHA256 值是否一致。
双击安装包,遇到用户账户控制提示时点“是”,许可协议页勾选“I accept the agreement”,直接点 Next。
关键安装选项配置
安装过程中有四个必须审慎选择的界面,顺序不可跳过:
-
选择安装路径:默认为
C:\Program Files\Git\,【路径中不能含中文或空格】,否则后续某些工具(如 VS Code 的终端集成)会无法识别 Git 命令。 - 组件选择:务必勾选“Git Bash Here”和“Git GUI Here”;“Git LFS”按需勾选(做游戏或AI模型训练建议勾选);“Associate .git* files”也建议勾选,方便右键直接编辑配置文件。
-
PATh 环境变量设置:必须选“Git from the command line and also from 3rd-party software”,这是让 CMD、PowerShell、VS Code 终端等都能调用
git命令的唯一正确选项。选错会导致你只能在 Git Bash 里用 Git,其他地方全失效。 - 换行符处理:选“Checkout Windows-style, commit Unix-style line endings”——这是跨平台协作(比如你写完推到 GitHub,同事在 macOS 上拉取)的黄金标准。若选错,别人会看到大量 CRLF 警告,甚至导致脚本执行失败。
安装后立即验证与基础配置
安装结束时勾选“Launch Git Bash”,窗口弹出后输入:git --version,回车确认输出类似 git version 2.55.0.windows.1。
用大白话操作当前项目的 Git/GitHub——配置 GitHub(装 gh CLI + 登录 + 建仓库)、备份、拉取下载、查询历史、回滚代码、管理分支。当用户用日常语言表达 git 意图时触发(例如"git备份一下""git下载项目""git拉下来""git看看我改了啥""git回退到上一个版本""git新建个分支搞新功能""git合并到主分支""git
接着在 Git Bash 中执行两行全局配置(替换为你的真实信息):
git config --global user.name "张三"
git config --global user.email "zhangsan@company.com"
这一步漏掉会导致每次提交都显示“unknown”作者,且 GitHub/GitLab 无法将提交关联到你的账户头像和贡献统计。
最后,在任意项目文件夹(如 D:\projects\myapp)中右键 → 选择“Git Bash Here”,输入:git init,成功返回 Initialized empty Git repository in D:/projects/myapp/.git/ 即表示本地版本管理已就绪。










