Git管理的是项目文件快照而非HTML单独版本；必须在含index.html的根目录执行git init，分支命名需明确对应可预览的HTML变体（如dark-theme），并确保CSS/JS/图片等配套文件完整且使用相对路径，同时用.gitignore屏蔽编辑器临时文件。
Git 不能直接“管理 HTML 版本”，它管理的是整个项目目录里的文件快照；所谓“HTML 版本”，实际是你对 index.html、css/style.css、js/main.js 等文件的一组同步变更。想靠 Git 实现网页多版本切换，关键在分支隔离 + 路径正确 + 提交及时。
git init 必须在含 index.html 的根目录执行
这不是建议，是硬性前提。如果在父目录或子目录（比如 js/）里运行 git init，git status 会显示 “nothing to commit”，但你改的 index.html 根本不在工作区里——Git 压根看不见它。
- 确认当前路径是否真含
index.html：用ls（macOS/Linux）或dir（Windows）看一眼 - VS Code 打开的文件夹 ≠ 终端默认路径，别只信编辑器标题栏
- 典型错误：项目结构是
/my-site/index.html，却在/my-site的上层目录执行git init
分支命名要反映 HTML 变体用途，别用 feature/xxx 模糊命名
HTML 项目分支不是为写代码服务的，是为保存可预览的完整页面变体。命名必须让人一眼看出这个分支打开后看到什么。
- 推荐命名：
dark-theme、responsive-v2、ab-test-landing、print-version - 避免命名：
feature/header（没说明影响范围）、fix-123（无法对应到可访问的 HTML 表现） - 每个分支应包含该变体所需的全部文件：不只是
index.html，还有配套的 CSS 类、JS 初始化逻辑、图片路径等 - 切换分支后，双击打开
index.html要能立刻渲染出预期效果，而不是一堆 404 请求
相对路径断裂是克隆后白屏的最常见原因
git clone 完全没问题，但双击打开 index.html 是白屏？90% 是因为用了绝对路径，比如 。在 file:// 协议下，开头的 / 指向磁盘根目录，不是你的项目文件夹。
- 全部改用相对路径：
css/style.css、../images/logo.png、js/main.js - 检查所有
、<script src=""></script>、 - 用浏览器开发者工具的 Network 标签页刷新页面，看有没有 404 的资源请求——这是最直接的线索
- 只有部署到子路径（如
https://example.com/my-app/）才考虑加
.gitignore 必须屏蔽编辑器和系统临时文件
纯 HTML 项目不编译，但 VS Code、Mac Finder、Windows 资源管理器会在目录里偷偷生成一堆东西：.vscode/、.DS_Store、Thumbs.db、*.swp……它们不该进仓库，但 git add . 默认全收。
- 最小可用
.gitignore内容必须包含：*.log、.DS_Store、Thumbs.db、.vscode/、.history/、*.swp、*.swo - 如果已经误提交了
.vscode/，运行git rm -r --cached .vscode/清出暂存区，再git commit - 漏写
.gitignore的后果：别人git clone后git status永远不干净，还可能泄露你本地编辑器配置
真正难的不是命令怎么敲，而是每次修改 HTML 时，同步检查它所依赖的 CSS 类是否存在、JS 函数是否被删、图片路径是否仍有效——Git 不校验这些，它只管文件有无变动。一个分支里删了 js/chart.js，但 index.html 还留着 <script src="js/chart.js"></script>，页面就白屏，而 git status 显示一切正常。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
