CLI

Methanol 内置轻量级命令行工具，用于启动开发服务器、执行静态构建及本地预览。

核心命令

快速体验（推荐）：直接使用 npx 运行：

npx methanol dev      # 启动开发服务器
npx methanol build    # 构建输出到 dist/
npx methanol serve    # 预览生产环境构建产物

若需频繁使用，建议进行全局安装以提升启动速度：

npm install methanol -g
methanol dev

input 与 output 可作为位置参数传入（请遵循顺序）：

npx methanol build ./pages ./dist

在 dev 模式下仅接受 input 参数：

npx methanol dev ./pages

参数详解

--input, -i: 指定 pages/ 目录（覆盖默认值）
--components: 指定 components/ 目录（覆盖默认值）
--assets: 指定 public/ 目录（覆盖默认值）
--output, -o: 指定 dist/ 目录（覆盖默认值）
--config, -c: 指定自定义配置文件路径
--theme: 覆盖配置文件中的 theme。当提供字符串时，Methanol 首先尝试将其解析为内置主题（如 default、blog）；若未找到，则搜索名为 methanol-theme-xxx（xxx 为指定的字符串）的包。本地主题请在 methanol.config.* 中 import 后，将 theme 设为导入的主题对象/工厂函数。
--site-name: 指定站点名称（覆盖配置）
--owner: 指定站点拥有者（覆盖 site.owner）
--base: 临时覆盖 site.base（dev 模式下会被忽略）
--port: dev/preview 服务端口（默认 5173）
--host: dev/preview 绑定 Host（仅写 --host 表示绑定全部接口）
--intermediate-dir: 中间态 HTML 输出目录（仅 build）
--emit-intermediate: 启用中间构建产物输出（仅 build，输出到 build/）
--highlight/--no-highlight: 控制代码高亮功能。
--jobs, -j: 设置构建 worker 线程数（0 表示按页面数量自动调整）
--search/--no-search: 控制 Pagefind 搜索索引构建。
--rss/--no-rss: 控制 RSS/Atom 订阅源输出。
--atom/--no-atom: 输出 Atom（启用时等同于打开订阅源）。
--pwa/--no-pwa: 控制 PWA 功能支持。
-v, --verbose: 启用详细日志模式（build 时显示 Vite / Pagefind 日志）

代码高亮功能默认开启，需要关闭时可用 --no-highlight。

在 serve/preview 中，第一个位置参数会被视为输出目录：

npx methanol serve ./dist

非 npx 方式运行

node node_modules/methanol/bin/methanol.js dev