快速开始

前置要求

• Rust 1.85+（edition 2024，stable 工具链）
• 编写插件还需添加 wasm 编译目标：rustup target add wasm32-unknown-unknown

安装

预编译二进制（推荐，无需 Rust 工具链，静态链接开箱即用）：

• Linux / macOS：

  curl -fsSL https://anycms.org/install.sh | sh
  

• Windows（PowerShell）：

  iwr -useb https://anycms.org/install.ps1 | iex
  

安装到 ~/.anycms/bin（Windows 为 %LOCALAPPDATA%\anycms\bin），按提示加入 PATH 即可。下载校验见 SHA-256 校验和。

macOS 原生构建尚未发布：安装脚本会装一个占位 anycms，运行时提示用 Cargo 从源码构建（见下）。

从源码构建（开发或需要最新主干时）：

git clone https://github.com/anycms/anycms-ssg anycms-ssg
cd anycms-ssg
cargo install --path .        # 安装 `anycms` 二进制到 ~/.cargo/bin

也可直接用 cargo run -- 代替已安装的 anycms。

三步生成你的第一个站点

anycms init my-site           # 生成站点骨架（site.kdl + content + templates + sass + ts）
cd my-site
anycms build                  # → public/（渲染 Markdown、编译 Sass、转译 TS、压缩 HTML）
anycms serve                  # → http://127.0.0.1:1111 实时热重载

编辑 content/ 下的 Markdown，保存后浏览器自动刷新。

使用主题

anycms init my-site
cd my-site
anycms theme install ../themes/ink      # 安装内置主题到 ./themes/ink
# 在 site.kdl 中设置 theme "ink"，并删除 site 自带的 templates/ 和 sass/ 让主题生效：
rm -rf templates sass
anycms build && anycms serve

overlay 优先级：site 的 templates/*.html 与 sass/main.scss 会覆盖主题同名文件。 全新 init 会同时生成这两者，要让已安装主题接管布局与样式，需先删除它们。详见主题。

安装一个插件

# 从内置示例构建并安装一个插件
cd examples/plugins/reading-time
anycms plugin build --install ../../sites/demo-ink --release

# 构建站点，插件自动加载
anycms build --root ../../sites/demo-ink

下一步

• 了解站点结构
• 配置你的 site.kdl
• 编写你的第一个插件