html项目初始化git并关联github需依次执行：git init、git add指定文件、git commit、git remote add origin、git push -u origin main；github pages需正确设置发布源、禁用jekyll、用相对路径、本地http服务预览。
HTML项目怎么初始化 Git 仓库并关联 GitHub
本地 HTML 项目默认没有版本控制，直接推送到 GitHub 会失败。必须先在项目根目录初始化 git，再添加远程地址。
- 进到你的 HTML 项目文件夹（比如
my-landing-page），终端运行：git init - 确认当前有
index.html等文件后，执行：git add index.html style.css（别用git add .，容易误提 node_modules 或 .DS_Store） - 提交：
git commit -m "initial html structure" - 去 GitHub 新建空仓库（不勾选 README、.gitignore、license），复制它的 HTTPS 地址，运行：
git remote add origin https://github.com/username/my-landing-page.git - 首次推送必须指定分支：
git push -u origin main（GitHub 默认主分支名是main，不是master）
为什么 GitHub 页面（GitHub Pages）不自动加载 index.html
GitHub Pages 不是“托管静态文件”那么简单——它依赖特定发布源设置，且对路径敏感。即使文件都对，页面仍可能 404。
- 进入仓库 Settings → Pages → Source，把分支选为
main（或gh-pages），文件夹选/ (root)；如果 HTML 在docs/下，要同步改这里 - 确保
index.html在所选源的根目录下（比如选/ (root)，那它必须和.git文件夹同级） - GitHub Pages 构建有延迟，推送后等 1–2 分钟再刷新；若仍空白，点页面右上角 “View deployment details” 查看构建日志，常见报错是
Page build failed（通常因非法符号或 Jekyll 干预） - 避免使用
_开头的文件夹（如_includes），GitHub Pages 默认跳过，Jekyll 会拦截渲染；纯静态 HTML 项目建议在仓库根目录加.nojekyll文件来禁用 Jekyll
本地开发时怎么模拟 GitHub Pages 的路径行为
本地双击打开 index.html 会走 file:// 协议，而 GitHub Pages 是 https:// + 相对路径，CSS/JS 加载失败很常见。
- 不要双击打开，用轻量 HTTP 服务：VS Code 安装插件 Live Server，右键
index.html→ “Open with Live Server”；或终端运行：npx serve -s（需先npm install -g serve） - 所有资源引用用相对路径，比如
./style.css、../js/main.js；避免绝对路径/style.css（它会从域名根开始找，但 GitHub Pages 项目 URL 是https://user.github.io/repo-name/，不是/） - 图片路径也一样：用
img/logo.png，而不是/img/logo.png；否则上线后图片 404
push 失败提示 “remote rejected” 或 “non-fast-forward” 怎么办
这不是网络问题，而是本地和远程历史不一致，Git 拒绝覆盖远程提交。常见于删了远程仓库重来、或别人改过同一分支。
立即学习“前端免费学习笔记（深入）”；
- 先拉取最新：
git pull origin main --rebase（推荐），解决冲突后git add . && git rebase --continue - 如果确定要强制覆盖（仅限个人小项目）：
git push -f origin main；但团队协作中禁用，会丢他人提交 - 检查是否误设了其他远程源：
git remote -v；多个origin会导致推送错仓库 - 确认当前分支名：
git branch；如果显示* master，但 GitHub 期望main，就先git branch -M main再推
GitHub Pages 对纯 HTML 最友好的方式，就是保持结构扁平、禁用 Jekyll、用相对路径、本地起服务验证——这些细节漏掉一个，页面就白屏或断链。真正卡住的往往不是语法，而是路径和协议的错位。
