github pages 可免费为个人项目提供 username.github.io 二级域名,需创建同名公开仓库、推送静态文件至默认分支、在 settings 中启用 pages 并设源为根目录分支,系统自动配置 cdn 和 https。

如果您希望为个人项目或博客搭建一个无需支付域名费用的在线展示平台,GitHub Pages 提供了自动绑定的免费二级域名服务。以下是实现此目标的具体步骤:
一、创建符合命名规范的仓库
GitHub Pages 会为特定命名格式的仓库自动分配 username.github.io 格式的二级域名,该域名直接指向仓库的默认分支(通常是 main 或 master)根目录下的静态文件。
1、登录 GitHub 账户,点击右上角加号图标,选择 New repository。
2、在 Repository name 输入框中,必须严格填写为 username.github.io,其中 username 是您的 GitHub 用户名,大小写需完全一致。
3、将仓库设为 Public,初始化时不要勾选 “Add a README file”。
二、推送静态网站文件到主分支
GitHub Pages 仅托管静态内容,因此需将 HTML、CSS、JavaScript 等前端文件推送到仓库的默认分支,系统将自动识别并发布。
1、在本地新建文件夹,放入 index.html 及其他必要资源文件。
2、使用 git init 初始化本地仓库,执行 git remote add origin https://github.com/username/username.github.io.git 绑定远程地址。
3、运行 git add .、git commit -m "initial commit"、git push -u origin main(或 master,视默认分支而定)完成推送。
三、启用 GitHub Pages 发布设置
即使文件已推送,仍需在仓库设置中手动启用 Pages 功能,否则不会触发域名解析和页面渲染。
1、进入仓库主页,点击 Settings 选项卡。
2、在左侧边栏滚动至 Pages 区域,展开配置面板。
3、在 Source 部分,从 Branch 下拉菜单中选择 main(或 master),并指定文件夹为 /(root)。
4、点击 Save 保存后,页面顶部将显示绿色提示条,注明站点已发布,并附带 https://username.github.io 的访问链接。
四、验证 DNS 解析与 HTTPS 启用
GitHub 自动为 username.github.io 域名配置全球 CDN 和有效 TLS 证书,但首次访问可能存在短暂缓存延迟或证书加载等待。
1、在浏览器中输入 https://username.github.io,确认页面正常加载且地址栏显示锁形图标。
2、若出现 “Not Found” 页面,检查仓库名称是否拼写错误、分支是否匹配、index.html 是否位于根目录。
3、若提示证书异常,等待最多 10 分钟后刷新;切勿手动导入或覆盖证书,GitHub 全程自动管理。










