git init必须在含index.html的最外层文件夹执行,即直接存放index.html、css/、js/、images/等的目录;在上层或子目录执行会导致文件不在工作区,git status显示“nothing to commit”。

必须在含 index.html 的最外层文件夹执行 git init,否则 Git 根本看不到 HTML 文件——这不是配置问题,是工作区错位。
git init 必须在项目根目录运行
所谓“根目录”,就是直接放着 index.html、css/、js/、images/ 这些内容的那层文件夹。不是它的父级,也不是 css/ 里面。
- 误在上层目录执行:
git status显示 “nothing to commit”,但你明明改了index.html—— 因为它根本不在 Git 工作区里 - 误在
js/里执行:git add .只会把 JS 文件加进去,index.html和css/style.css全被漏掉 - VS Code 打开的是哪个文件夹,终端默认路径就是哪个——别只看编辑器标题栏,用
pwd(macOS/Linux)或cd(Windows)确认当前路径是否真含index.html
.gitignore 必须屏蔽本地临时文件,否则会污染提交
纯 HTML 项目不编译,但编辑器、浏览器、操作系统会在项目目录里偷偷写一堆东西:.DS_Store、Thumbs.db、.vscode/、*.swp……它们不该进仓库,但 git add . 默认全收。
GitHub Hosts 更新工具(仅限中国用户),安全更新系统hosts文件,保留原有非GitHub条目,仅替换GitHub相关地址。支持备份恢复和风险提示。用于解决GitHub访问问题。
- 漏写
.gitignore的后果:别人git clone后看到一堆红色文件名,git status永远不干净,还可能泄露你本地的编辑器配置 - 最小可用
.gitignore内容:*.log .DS_Store Thumbs.db .vscode/ .history/ *.swp *.swo
- 如果已经误提交了
.vscode/,运行git rm -r --cached .vscode/清出暂存区,再git commit,后续就不会再跟踪
相对路径断裂是 Git 克隆后白屏的主因,和 Git 无关但总在 Git 流程里暴露
git clone 完,双击打开 index.html 是白屏?90% 是因为 <link href="/css/style.css"> 这种带开头 / 的绝对路径。浏览器在 file:// 协议下,/ 指向磁盘根目录,不是你的项目文件夹。
- 必须全部改用相对路径:
css/style.css、../images/logo.png、js/main.js - 检查所有
<link href="">、<script src=""></script>、<img src="">,一个都不能漏 - 用浏览器开发者工具的 Network 标签页刷新页面,看有没有
404的css或js请求——那是最直接的线索 - 如果部署到子路径(如
https://example.com/my-app/),才考虑加<base href="/my-app/">,但要注意它会影响所有相对 URL
git add 后发现漏了某个 CSS 文件,先查是不是被 .gitignore 拦住了
刚 git commit 完,同事说样式没了,一查 css/ 根本没进历史——大概率不是你忘了 add,而是它被 .gitignore 规则静默过滤了。
- 运行
git check-ignore -v css/style.css,它会告诉你哪条规则把它挡住了 - 如果没被 ignore,但
git status也不显示,可能是文件权限异常(比如从 ZIP 解压出来带只读属性),试试chmod 644 css/style.css - 补救方式只有
git add css/style.css && git commit --amend --no-edit,但仅限还没push的本地提交;一旦推上去,就得另起一次正常提交
Git 本身不校验路径对不对、不阻止你提交坏链接、也不提醒你漏了 .gitignore——这些都得靠人盯。最容易被忽略的,是每次 git add . 前,手动跑一遍 git status 确认列出的文件确实是你想提交的那批。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










