CLI 命令行

基本用法

robuild [entries...] [options]

常用选项

robuild ./src/index.ts                    # 基本构建
robuild ./src/index.ts -w                 # 监听模式
robuild ./src/index.ts --stub             # Stub 开发模式
robuild ./src/index.ts --format esm       # 指定格式
robuild ./src/index.ts --minify           # 压缩代码
robuild ./src/index.ts --dts              # 生成类型声明
robuild ./src/runtime/:./dist/runtime     # Transform 模式

完整选项列表

基础选项

选项	简写	说明
--config <file>	-c	指定配置文件
--dir <dir>		工作目录
--out-dir <dir>	-d	输出目录（默认: dist）
--watch	-w	监听模式
--stub		Stub 开发模式

输出选项

选项	说明
--format <format>	输出格式: esm, cjs, iife, umd
--platform <platform>	目标平台: browser, node, neutral
--target <target>	ES 版本: es2015, es2020, esnext
--global-name <name>	IIFE/UMD 全局变量名

优化选项

选项	说明
--minify	压缩代码
--sourcemap	生成 source map
--splitting	代码分割
--treeshake	Tree shaking（默认开启）

类型声明

选项	说明
--dts	生成类型声明文件
--dts-only	仅生成类型声明

依赖处理

选项	说明
--external <module>	外部化依赖
--no-external <module>	强制打包依赖
--skip-node-modules	跳过 node_modules

其他选项

选项	说明
--clean	清理输出目录
--shims	启用兼容性垫片
--generate-exports	生成 package.json exports
--on-success <cmd>	构建成功后执行命令
--log-level <level>	日志级别

示例

多格式输出

robuild ./src/index.ts --format esm --format cjs

浏览器库

robuild ./src/index.ts --format iife --global-name MyLib --platform browser

CLI 工具

robuild ./src/cli.ts --platform node --minify

配置文件

robuild                           # 使用 build.config.ts
robuild --config custom.config.ts # 指定配置文件

package.json 脚本

{
  "scripts": {
    "build": "robuild ./src/index.ts",
    "dev": "robuild ./src/index.ts --stub",
    "watch": "robuild ./src/index.ts -w"
  }
}

下一步

• 配置 - 配置文件选项
• 构建模式 - Bundle 与 Transform 模式