为什么个人品牌站适合静态生成：内容、模板与发布的分离

用结构化数据、Markdown 和模板生成静态页面，可以同时获得访问速度、低运维成本和持续更新能力。

为什么选择纯静态站

个人品牌站的主要内容是文章、作品、理念和联系方式，更新频率通常不需要每秒写入数据库。把内容预先生成成 HTML，可以让 Nginx 直接返回文件，减少运行时依赖、数据库连接和服务器计算，也更容易使用缓存和 CDN。

静态不等于手写 HTML。真正适合长期维护的方式是把内容、配置、模板和资源分开：JSON 保存结构化事实，Markdown 保存文章正文，模板保存展示结构，CSS 和 JavaScript 保存交互与样式，构建脚本负责把它们组合成公开页面。

源码目录要和发布目录分离

`/srv/site/source/` 是生产源代码，保存配置、正文、模板、图片和构建脚本；`/var/www/html/` 是发布结果，只保存浏览器访问的 HTML、CSS、JavaScript、图片和系统文件。Nginx 不应该直接读取内容源，也不应该依赖 Python 运行时。

发布目录可以增量更新，也可以通过 `--clean` 清理后重新生成。无论哪种模式，`.well-known/acme-challenge/` 都需要保留，因为它属于证书验证路径，不是站点内容。

用数据驱动页面

导航来自 `navigation.json`，个人信息来自 `profile.json`，理念来自 `principles.json`，作品来自 `works.json`，联系地图来自 `links.json`。分享的列表元数据放在 `posts.json`，正文放在对应的 Markdown 文件；动态和成长经历分别放在自己的 JSON 文件中。

这种拆分让 AI 或人工更新内容时只需改动数据文件，不必在一个巨大的脚本中寻找 HTML 字符串。构建脚本读入数据、转义文本、调用模板并生成页面，业务内容不会因为页面结构调整而丢失。

SEO 与 GEO 的静态基础

每个页面生成唯一 title、description、canonical 和结构化数据。文章有固定 slug、日期、分类和可读正文，站点生成 sitemap 和 robots。内部链接把首页、栏目页和详情页连接起来，让搜索引擎和生成式系统都能理解内容层级。

需要隐藏或延迟展示的内容，可以由 JavaScript 根据 API 返回的状态控制，但首屏核心信息不能依赖接口才能出现。这样既保持抓取和阅读的稳定性，也保留后续扩展小程序阅读、统计和个性化展示的能力。

什么时候不适合静态

如果页面依赖实时交易、复杂权限、频繁写入或强交互协作，应该把动态功能单独交给后端服务，主站仍然可以保持静态。目录型 Nginx 配置允许 `/api/` 或其他路径转发到独立服务，不需要把整个个人站改造成动态应用。

静态生成的价值，是把变化集中在源代码和内容层，把访问过程保持简单。只要构建过程可重复、输出可检查，个人站就能以很低的运维成本持续成长。