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: 指定自定义配置文件路径
--site-name: 指定站点名称（覆盖配置）
--base: 临时覆盖 site.base（dev 模式下会被忽略）
--port: dev/preview 服务端口（默认 5173）
--host: dev/preview 绑定 Host（仅写 --host 表示绑定全部接口）
--intermediate-dir: 中间态 HTML 输出目录（仅 build）
--emit-intermediate: 启用中间构建产物输出（仅 build，输出到 build/）
--code-highlighting: 控制代码高亮开关（--code-highlighting 启用；--code-highlighting false 禁用）
-v, --verbose: 启用详细日志模式（build 时显示 Vite / Pagefind 日志）

代码高亮功能默认关闭，按需开启即可。

node node_modules/methanol/bin/methanol.js dev