{
  "id": "static-site-generator",
  "title": "静态站点生成器",
  "lang": "zh-Hans",
  "source_lang": "en",
  "summary": "静态站点生成器在访客发出请求前，根据内容、模板和数据构建网站文件，将页面生成与交付分离。",
  "category": "computer-science",
  "subcategory": "software",
  "type": "concept",
  "aliases": [
    "SSG",
    "静态网站生成器"
  ],
  "generated_at": "2026-11-05",
  "model": "pro/gpt-6.1-sol",
  "url": "https://aiwiki.page/zh/static-site-generator/",
  "translations": {
    "en": {
      "url": "https://aiwiki.page/en/static-site-generator/",
      "json": "https://aiwiki.page/en/static-site-generator.json"
    }
  },
  "sections": [
    {
      "heading": "",
      "text": "静态站点生成器（SSG）是一种将网站生成为一组文件的软件，通常在构建过程中将内容、模板、配置和其他数据组合起来。其输出通常包括 超文本标记语言文档、样式表、脚本和媒体资源，网页服务器可以直接提供这些文件，而无须在响应访客请求时逐一生成页面。“静态”描述的是发布文件的生成和提供方式，并不一定表示网站的行为是静态的：生成的页面仍可包含交互功能、获取实时数据，并与外部服务通信。"
    },
    {
      "heading": "工作原理",
      "text": "静态站点生成器将页面生成与页面交付分离。它预先完成动态渲染网站可能在每次收到请求时执行的工作，例如将文章填入布局、构建导航，以及生成相关页面列表。\n\n典型的输入包括：\n\n- 内容文件，通常使用 Markdown 标记语言、HTML 或其他标记格式编写。\n- 模板与布局，用于定义可复用的页面结构。\n- 配置与元数据，例如站点设置、发布日期、作者和导航标签。\n- 结构化数据，通过本地文件、数据库或应用程序编程接口提供。\n- 资源文件，包括图像、字体、层叠样式表和 JavaScript。\n\n模板引擎提供变量替换、条件判断、循环和可复用组件等机制。许多生成器还支持 front matter，即位于内容文件开头的元数据块，用于指定标题、布局或发布状态等属性。\n\n典型的构建过程分为以下几个阶段：\n\n- 读取配置、内容和数据源。\n- 解析内容并收集其元数据。\n- 确定输出路径及页面之间的关系。\n- 使用模板或组件渲染页面。\n- 复制或转换资源，并将生成的文件写入输出目录。\n\n构建过程还可能生成订阅源、站点地图、标签索引、分页内容或可供搜索的内容索引。随后，生成的目录会被发布到托管服务上。\n\n生成器本身不必在生产环境的网页服务器上运行。它可以在作者的计算机、构建服务器或自动化部署服务中运行。"
    },
    {
      "heading": "静态生成与其他渲染模式",
      "text": "静态生成是产生浏览器可见内容的多种方式之一。各种方式的主要区别在于渲染发生的时间和位置。\n\n渲染模式 | 页面内容生成的时间 | 主要特点\n静态生成 | 在收到请求之前，于构建过程中生成 | 多位访客可以收到同一份预先构建的文档\n服务端渲染 | 在服务器处理请求时生成 | 内容可以直接取决于当前数据或请求上下文\n客户端渲染 | 在访客的浏览器中，通过脚本生成 | 页面内容依赖浏览器执行脚本，通常还需要额外的数据请求\n混合渲染 | 结合上述多种方式生成 | 不同页面或组件可以采用不同的渲染策略\n\n采用服务端渲染时，服务器可能会针对收到的请求查询数据库并构建 HTML。缓存可以减少重复执行这些工作的次数，但在请求时生成内容仍是架构的一部分。\n\n采用客户端渲染时，网页浏览器使用 JavaScript 构建或更新界面。静态文件托管服务也可以提供这类应用，但仅凭这一点，并不能说明应用中有实质意义的页面内容是静态生成的。\n\n生成器也可以生成随后进行水合的 HTML：浏览器端代码为现有文档附加交互行为。这种方法将预先构建的内容与客户端应用功能结合起来。\n\n增量构建只重新生成受变更影响的输出。一些框架还支持在部署后重新生成单个页面，通常称为增量静态再生或按需重新验证。这些机制在不同实现中有所差异，而且可能需要运行时服务，因此不能假定它们可以在仅提供文件托管的环境中工作。"
    },
    {
      "heading": "发展历程与主要类型",
      "text": "早期网站通常由手工编写的 HTML 文件组成。随着网站规模扩大，共用导航、重复布局和频繁更新使手工维护的负担日益加重。静态站点生成器将这些任务自动化，同时保留了基于文件的发布方式。\n\n随着以数据库为支撑的内容管理系统的发展，动态页面生成逐渐普及。不过，静态生成对于文档、个人出版物，以及其他不需要针对每次请求进行计算的网站，仍然具有实用价值。\n\nJekyll 等工具推动形成了一种工作流程：将文本文件与模板一同纳入版本控制。Hugo、Pelican 等生成器采用不同的编程语言和内容模型，发展出了类似的方法。后来的 Gatsby、Next.js、Astro 和 Eleventy 等工具，通过基于组件的开发、外部数据集成，或静态与动态渲染相结合等方式，拓展了这一生态系统。其中一些工具属于功能更全面的网页开发框架，而非仅用于静态站点生成。\n\n常见类型包括：\n\n- 面向内容的生成器，围绕文章、页面、分类和主题组织内容。\n- 文档生成器，提供层级导航、代码高亮和文档版本管理等功能。\n- 面向组件的生成器，使用可复用的界面组件构建页面。\n- 数据驱动的生成器，根据结构化记录、远程服务或无头内容管理系统中的数据创建页面。\n\n这些类别之间存在重叠。同一种工具可以支持多种发布方式。"
    },
    {
      "heading": "发布与部署",
      "text": "生成的文件可以托管在常规网页服务器、配置为提供网站内容的对象存储服务，或内容分发网络（CDN）上。内容交付仍然需要服务器和网络基础设施；静态托管意味着应用不必在每次收到页面请求时渲染页面。\n\n一种常见工作流程是将源内容和配置存储在 Git（版本控制系统）中。变更会触发自动构建、验证检查和输出发布。这将静态生成融入持续交付流程，也使编辑性修改能够与模板或代码修改一同接受审查。\n\n部署系统可以将一次完整构建的结果作为一个整体发布，从而降低访客收到新旧文件混合版本的可能性。缓存配置仍然很重要：文档、脚本和图像可能需要不同的过期策略，而成功部署也不一定会清除之前缓存的所有副本。\n\n无头内容管理系统可以提供图形化编辑界面，同时将页面生成工作交给 SSG。内容变更可以触发新的构建，而不必要求作者直接编辑代码仓库中的文件。"
    },
    {
      "heading": "应用与优势",
      "text": "静态站点生成器常用于博客、作品集、项目网站、产品信息、软件文档和参考资料集。对于大量读者阅读基本相同的内容，且内容更新可以通过构建过程发布的场景，它们尤其适用。\n\n其主要优势包括：\n\n- 交付简单。 预先构建的文件不需要在每次页面请求时执行模板或查询数据库。\n- 缓存高效。 多人共用的文档可以通过缓存和 CDN 分发。\n- 运行环境分离。 发布环境可以独立于面向公众提供内容的环境。\n- 输出可移植。 普通 HTML 和资源文件通常可以在不同托管服务商之间迁移，不过重定向、路由规则及平台特有功能可能需要调整。\n- 源文件便于审查。 文本形式的内容和模板可以采用成熟的软件协作流程。\n\n预先构建的 HTML 还可以直接呈现页面内容，而无须先执行客户端渲染。这有助于内容被发现，并提高稳健性，但本身并不能保证搜索可见性、加载速度或网页无障碍。"
    },
    {
      "heading": "局限性与安全注意事项",
      "text": "构建成本与内容时效性\n\n大型站点可能需要较长的构建时间，尤其是在处理图像、获取远程数据，或生成大量语言与分类组合时。增量处理可以降低这项成本，但共用导航或索引可能导致一次小修改影响许多页面。\n\n已发布的内容通常反映的是构建时可用的数据。因此，对于频繁变化的信息，在下一次构建或重新验证之前，内容可能已经过时。\n\n个性化与事务功能\n\n供所有人访问的同一份静态文档，无法独立执行针对不同用户的权限限制，也无法独立处理事务。私人仪表板、购物车、评论和账户管理等功能，通常需要浏览器端状态、后端服务，或两者配合。\n\n客户端的身份认证界面并不能使公开提供的静态文件变为私密文件。受限信息需要在托管层或应用层实施适当的访问控制。同样，嵌入生成页面或发送到浏览器的脚本中的 API 凭据，也会暴露给访客。\n\n安全边界\n\n移除面向公众的渲染应用及其直连数据库的连接，可以缩小生产系统的攻击面，但并不能消除安全风险。构建依赖、插件、发布凭据、第三方脚本和外部服务都可能引入安全漏洞。\n\n生成的输出可能意外发布草稿、机密记录或构建过程中获取的秘密信息。另一方面，如果模板或渲染插件未能安全处理不可信输入，恶意内容仍然可能传递给访客。\n\n性能与编辑工作的权衡\n\n静态生成并不保证页面轻量。大型图像、过多脚本、远程字体和第三方集成，都可能成为加载与交互开销的主要来源。\n\n基于文件的发布方式也会带来编辑工作上的权衡。分支和代码审查有助于有序管理变更，但非技术作者可能需要额外的界面来完成预览、定时发布、媒体管理和协同编辑。因此，SSG 是否适用，取决于完整的发布与应用架构，而不仅仅是它能否生成 HTML。"
    }
  ],
  "links": [
    "html",
    "markdown",
    "database",
    "application-programming-interface",
    "cascading-style-sheets",
    "javascript",
    "metadata",
    "web-browser",
    "version-control",
    "software-documentation",
    "web-accessibility",
    "authentication",
    "access-control",
    "security-vulnerability"
  ],
  "sources": [],
  "license": "https://creativecommons.org/licenses/by/4.0/"
}