学习路线:从部署一个网站开始
我以前会把“看完教程”和“掌握一个工具”划等号。后来发现,真正把一个网站交给别人访问时,问题才开始出现:域名没生效、部署没有更新、页面构建失败、密钥放错位置、内容改了但线上没变化。
因此这次做个人博客时,我给自己设了一个目标:不只做出页面,而是把从内容写作到线上访问的链路完整跑通。
一套网站背后的完整链路
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 或环境变量中。公开仓库里的任何提交都可能被长期保存,所以先分清“可公开配置”和“私密凭据”非常重要。
误区三:部署一次就结束
真正有价值的是可重复发布:改一篇文章、提交、构建、上线、验证。这条链路稳定后,网站才会成为一个可以长期更新的工具,而不是一次性的作品。
我现在的排查顺序
当线上不符合预期时,我会按这个顺序检查:
- 本地构建是否成功。
- 最新提交是否已经推送到仓库。
- 部署平台是否拿到了这次提交。
- 目标域名是否返回新版本。
- 是否受到浏览器或 CDN 缓存影响。
这个顺序能避免在错误层级浪费时间。
下一步
博客会继续作为我的实验场:学习缓存与 CDN、记录 API 调用链路、写项目复盘,也练习把复杂系统讲清楚。对我而言,部署这个网站不是学习的终点,而是之后每一次实践都能被记录和验证的起点。