学习路线:从部署一个网站开始

我以前会把“看完教程”和“掌握一个工具”划等号。后来发现,真正把一个网站交给别人访问时,问题才开始出现:域名没生效、部署没有更新、页面构建失败、密钥放错位置、内容改了但线上没变化。

因此这次做个人博客时,我给自己设了一个目标:不只做出页面,而是把从内容写作到线上访问的链路完整跑通。

一套网站背后的完整链路

flowchart LR
  A[写代码或 Markdown] --> B[GitHub 仓库]
  B --> C[构建与检查]
  C --> D[Cloudflare 部署]
  D --> E[自定义域名、DNS、HTTPS]
  F[Echoes Studio] --> A

每一层都有不同职责:GitHub 保存历史,构建工具把源码变成可发布文件,Cloudflare 负责分发,DNS 让域名指向正确服务,内容工作台让 Markdown 写作更方便。

它们串起来之后,才是一套能持续使用的博客。

我踩过的三个认知误区

误区一:页面能在本地打开,就等于已经发布

本地开发服务器只说明代码在自己的电脑上运行。线上还要经过构建、上传、域名解析和 CDN 缓存等步骤。遇到差异时,应该按链路逐层排查,而不是反复改页面样式。

误区二:所有配置都可以写进代码

站点标题、公开地址等可以写进源码;Token、密钥、部署凭据必须放到 Secret 或环境变量中。公开仓库里的任何提交都可能被长期保存,所以先分清“可公开配置”和“私密凭据”非常重要。

误区三:部署一次就结束

真正有价值的是可重复发布:改一篇文章、提交、构建、上线、验证。这条链路稳定后,网站才会成为一个可以长期更新的工具,而不是一次性的作品。

我现在的排查顺序

当线上不符合预期时,我会按这个顺序检查:

  1. 本地构建是否成功。
  2. 最新提交是否已经推送到仓库。
  3. 部署平台是否拿到了这次提交。
  4. 目标域名是否返回新版本。
  5. 是否受到浏览器或 CDN 缓存影响。

这个顺序能避免在错误层级浪费时间。

下一步

博客会继续作为我的实验场:学习缓存与 CDN、记录 API 调用链路、写项目复盘,也练习把复杂系统讲清楚。对我而言,部署这个网站不是学习的终点,而是之后每一次实践都能被记录和验证的起点。