Zola 提供三种安装方式：Rust 工具链（需 nightly，获最新版）、Homebrew（macOS 稳定安装）、手动下载预编译二进制（免 Rust，指定版本）；安装后需验证版本、初始化项目并运行 serve 查看默认页面。

一、通过 Rust 工具链安装 Zola

若系统已安装 Rust 及 cargo，Zola 可直接通过 cargo 安装，该方式能获取最新 nightly 构建版本，适用于需频繁更新或参与主题开发的用户。

1、确保已安装 Rust nightly 工具链：运行 rustup install nightly。

2、执行 cargo 安装命令：运行 cargo +nightly install zola。

3、验证安装是否成功：运行 zola --version，输出应包含版本号及 commit hash。

二、使用 Homebrew 安装 Zola

Homebrew 是 macOS 上最主流的包管理器，安装方式稳定、校验完整，适合注重环境一致性和可复现性的用户。

1、确保 Homebrew 已正确初始化且仓库正常：运行 brew update，若报 shallow clone 错误，请先执行仓库修复流程。

2、执行安装命令：运行 brew install zola。

3、检查二进制路径：运行 which zola，确认返回路径为 /opt/homebrew/bin/zola（Apple Silicon）或 /usr/local/bin/zola（Intel）。

三、手动下载预编译二进制安装

该方式绕过编译过程，适用于无 Rust 环境、网络受限或需指定特定版本（如 v0.18.1）的场景，所有依赖均已静态链接。

1、访问 Zola 官方 GitHub Releases 页面：https://github.com/getzola/zola/releases。

2、下载对应 Apple Silicon 或 Intel 架构的 zola-x.x.x-x86_64-apple-darwin.tar.gz 或 zola-x.x.x-aarch64-apple-darwin.tar.gz 文件。

3、解压并移动二进制文件至系统路径：执行 tar -xzf zola-*.tar.gz && sudo mv zola /usr/local/bin/。

4、赋予执行权限：运行 sudo chmod +x /usr/local/bin/zola。

四、验证与初始化项目

安装完成后必须验证 CLI 可用性，并创建最小可行项目结构，为后续主题集成与内容编写奠定基础。

1、新建项目目录：运行 mkdir my-blog && cd my-blog。

2、初始化 Zola 项目：运行 zola init，按提示输入站点标题、作者名等基本信息。

3、启动本地服务：运行 zola serve，确认终端输出显示 Listening for requests at http://127.0.0.1:1111。

4、在浏览器中打开 http://localhost:1111，确认默认欢迎页面正常渲染。