根据本站真实搭建过程整理的建站笔记草稿。从最简单的页面开始,先让一个想法拥有可以被访问的地址。

01先做出可以打开的一页

这个网站从一个标题、一段介绍和一份样式表开始。HTML 决定页面里有什么,CSS 决定它们怎么呈现。内容很少,却足够验证第一件事:自己写下的文字,能不能准确出现在浏览器里。

最初双击 index.html 打开的是电脑上的本地文件。此时地址以 file 开头,能看见页面不代表别人也能访问。把这个阶段当成工作台会更容易理解:我可以随时修改和试验,完成后再把结果交给托管平台。

text
personal-website/
├── README.md
└── public/
    ├── index.html
    └── style.css

02让每次修改留下记录

接下来为项目建立 Git 仓库,再把代码推送到 GitHub。Git 在本地记录版本,GitHub 保存远程仓库;即使暂时不联网,也可以在本地创建提交。这让改动有了可检查的历史,也让部署平台有了明确的代码来源。

本站使用私有仓库存放源码,并授权 Pages 访问它。仓库的可见性和网站的访问权限是两件事:仓库可以私有,部署出来的页面仍然能够公开访问。浏览器下载到的 HTML、CSS 和 JavaScript 则属于公开页面的一部分。

03把页面交给 Pages

连接 GitHub 后,Pages 从选定的生产分支部署网站。本站最初只有静态文件,不需要框架,输出目录选择 public。这里的关键是让平台找到准备对外提供的文件,而不是只确认仓库已经连接。

部署完成后先用 pages.dev 地址检查页面,再连接 mousyu.com。域名提供一个容易记住的入口,托管平台负责向访问者提供内容。已经承担其他用途的域名记录要保留,网站配置只处理对应的访问入口。

04上线以后,验证一次完整更新

能打开首页只是开始。更有用的练习是修改一句介绍,保存、提交、推送,等待部署完成,再打开线上页面确认文字确实改变。这样才能证明整个更新链路已经走通。

以后维护网站,就可以沿着这条路径定位问题:本地文件是否正确,GitHub 是否收到提交,Pages 是否部署了这个版本,浏览器是否加载了新文件。把每一步看清楚,网站更新就不再是一连串碰运气的按钮。

分享给别人之前,还可以用手机检查一次:标题是否完整、文字是否好读、链接是否能点击。一个能稳定访问的小页面,已经足够成为后续作品和文章的起点。

  • 本地修改与预览
  • 暂存、提交并推送到 GitHub
  • 确认 Pages 部署完成
  • 访问线上网址,检查内容和链接

继续阅读

对应的官方文档,适合需要更完整细节时查阅。

这一篇,到这里。回到文章顶部 ↑