git 是独立命令行工具，需单独安装并配置 user.name 和 user.email 才能提交；vs code 的 git 功能仅是图形界面，依赖系统已安装的 git；windows 安装时须勾选添加 path，macos/linux 推荐用包管理器安装。
Git 客户端不是 html 开发环境的一部分，它和 HTML 本身无关；你真正需要的是在你的操作系统上安装 Git 命令行工具，然后用它管理 HTML 项目文件。
Git 不是浏览器插件，也不是 VS Code 内置功能
很多人误以为“HTML 开发环境”自带 Git，或者装个编辑器就等于有了 Git。其实 git 是一个独立的命令行程序，必须单独安装。VS Code 可以调用它、浏览器完全不认它、index.html 文件里更不可能嵌入 Git。
- VS Code 的“源代码管理”侧边栏只是
git命令的图形界面，背后依赖系统已安装的git - 如果你在终端输入
git --version报错command not found，说明还没装，编辑器里的 Git 功能会直接灰掉 - Windows 用户尤其容易卡在路径问题：安装时务必勾选
Add Git to the system PATH（否则 VS Code 或终端都找不到git）
Windows 上装 Git：别跳过 PATH 配置
官网下载 Git for Windows 安装包后，一路下一步很容易忽略关键选项。最常踩的坑就是没让 Git 写入系统环境变量。
- 安装过程中遇到 “Adjusting your PATH environment” 页面，选
Git from the command line and also from 3rd-party software - 如果已装完但
git --version仍报错，打开系统设置 → 环境变量 → 编辑Path→ 手动添加类似C:Program FilesGitbin的路径 - 重启所有已打开的终端或 VS Code 窗口，否则旧进程看不到新 PATH
macOS 和 Linux：优先用包管理器装
别直接下 macOS 的 .pkg 安装包，也别手编译。系统自带的包管理器能更好处理更新和依赖。
立即学习“前端免费学习笔记（深入）”；
- macOS：运行
brew install git（需先装 Homebrew），不要用 App Store 版 Git - Linux（ubuntu/debian）：
sudo apt update && sudo apt install git - Linux（centos/RHEL）：
sudo yum install git-core或sudo dnf install git - 装完立刻验证：
git config --global user.name "Your Name"和git config --global user.email "you@example.com"，这是后续提交必需的
验证是否真能用：别只看图标
编辑器里看到 Git 图标不等于能用。真实可用的标准只有一个：能在项目目录下执行基础操作且不出错。
- 进到你的 HTML 项目文件夹（比如
my-website），运行git init—— 应该返回Initialized empty Git repository - 接着
git add index.html，再git commit -m "first commit"，成功才算闭环 - 如果卡在
fatal: unable to auto-detect email address，说明git config没设好，不是 Git 没装成 - 注意：HTML 文件本身不需要任何特殊配置，Git 只当它是普通文本文件处理
最容易被忽略的是：Git 安装后必须手动配 user.name 和 user.email，否则连第一次提交都会失败——这个步骤没有错误提示，只有提交时突然中断，很多人反复重装 Git 也没意识到问题在这儿。