Zola
单文件静态网站生成器，内置 Markdown、Tera 模板、Sass、图片处理、分类、分页、搜索索引、链接检查和本地热更新。
Zola 的静态网站能力
Zola 是单二进制静态网站生成器，提供 Markdown、Tera 模板、Sass、图片处理、主题、短代码、多语言基础支持、分类、分页、搜索索引、内部链接、目录、链接检查和本地热更新。生成结果可部署到常见静态托管平台。
四个命令与输出目录
核心命令是 init、build、serve 和 check。init 创建项目结构，serve 本地预览，check 验证页面和外部链接，build 生成 public。构建和预览会清理输出目录，因此 public 必须是可再生制品，不能混入唯一上传文件或手工修改。
base_url、主题与暴露范围
base_url 决定 canonical、站内链接、sitemap 和资源地址，生产构建必须使用正式 HTTPS 域名。第三方主题可能包含外部脚本和错误 SEO 标签，应先审查。serve 默认仅本机访问，绑定所有接口会暴露给局域网，不是生产服务器。
归档与维护记录
本页于 2026-08-06 根据 Zola 0.22.1 的初始化、构建、预览、链接检查和静态站点功能复核。0.22 之后新增代码采用 EUPL-1.2，既有代码仍含 MIT 许可；归档文件为 zola-v0.22.1-x86_64-pc-windows-msvc.zip，大小为 14.07 MB。
选择下载方式
下载前请核对资源版本和授权范围。本站不提供破解软件及未经授权的资料。
Zola 初始化、预览、检查与安全构建教程
在全新的 Git 项目目录初始化测试站点，明确 base_url 和输出目录。先本地预览与检查，再构建到可删除的 public 目录并逐项核对 SEO 文件。
安装前准备
- 创建空的测试目录并纳入版本控制，不在已有网站根目录直接使用 force。
- 明确正式域名、HTTPS、尾斜杠与部署子路径，用于设置正确 base_url。
- 确认 public 只是可重新生成的输出目录，所有源内容和静态资源另有备份。
安装步骤
- 01
解压并验证版本
核对 Zola 0.22.1、Windows x64 和归档文件后解压，查看版本、总帮助及 init、serve、check、build 子命令。
- 02
在空目录初始化站点
使用 init 创建结构，检查 zola.toml、content、templates、static 和 sass，不对非空目录使用强制初始化。
- 03
设置基础地址与内容
配置正式 base_url、标题和分类，在 content 中新增测试页，使用相对资源并检查 front matter。
快速上手
- 01
仅在本机预览
使用默认本机接口运行 serve，检查页面、导航、模板、图片和热更新；无需局域网访问时不绑定 0.0.0.0。
- 02
运行内容与链接检查
使用 check 验证页面和外部链接，区分临时网络错误与真实死链；敏感预发布地址不应被公开检查服务访问。
- 03
构建并核对 public
确认输出目录可删除后运行 build，检查 canonical、标题描述、结构化数据、sitemap、robots、404 和静态资源路径再部署。
使用建议
- build 和 serve 会清理输出目录，任何手工上传文件都必须来自 static 或独立发布步骤。
- 第三方主题包含模板、脚本和样式，启用前审查外部请求、统计代码、SEO 标签和版本兼容。
- base_url 错误会影响 canonical、站内链接、sitemap 和分享地址，预览域名不能带入生产构建。
故障排查与卸载方法
部署后 CSS 或图片路径错误怎么办？
检查 base_url、部署子路径、相对与绝对链接以及 static 目录结构，用生产参数重新构建而不是手改 public。
serve 能访问但其他设备打不开怎么办？
默认只监听本机是预期行为；确需局域网测试时在可信网络临时绑定局域网接口并检查防火墙，完成后恢复本机监听。
- 停止服务并移除工具目录终止 serve，保留源项目和配置，确认 public 可重新生成后从 PATH 或工具目录移除 Zola。
常见问题
Zola 需要 Node.js、数据库或服务器运行时吗？
生成阶段使用单个 Zola 二进制即可，输出通常是可由静态服务器托管的 HTML、CSS 和资源文件；主题或部署流程可能另有工具需求。
zola build 会覆盖 public 目录吗？
会。官方文档说明默认构建前会删除已有 public 目录，serve 也会清理输出目录。不要把源文件、上传内容或手工文件只存放在输出目录。
zola serve 可以直接用于生产网站吗？
不建议。serve 用于本地预览和热更新，默认只监听本机；将接口改为 0.0.0.0 会暴露给局域网，应只在可信网络短时测试。
下载时需要提取码吗？
夸克网盘无需提取码；百度网盘所需的四位提取码会直接显示在下载入口旁。