@utoo/pack-cli

@utoo/pack 的命令行工具，基于 Turbopack 构建的高性能打包器。

@utoo/pack-cli 提供 up CLI 命令来使用 @utoo/pack 构建和启动开发服务器。它从 utoopack.json、utoopack.config.mjs 或 utoopack.config.js 读取配置。

安装

Terminal


ut install @utoo/pack-cli --save-dev

用法

开发模式

启动带有 HMR 的开发服务器：

Terminal


utx up dev

生产构建

构建生产环境项目：

Terminal


utx up build

Webpack 兼容

使用已有的 webpack.config.js 兼容模式：

Terminal


utx up build --webpack
utx up dev --webpack

命令

up build

构建生产环境项目。

选项	描述
`-p, --project <path>`	设置项目路径
`-r, --root <path>`	设置根路径
`--webpack`	启用 webpack 兼容模式
`--tracing`、`--no-tracing`	显示或隐藏编译进度；默认取配置文件中的 `tracing`，未设置时开启

up dev

启动 HMR 开发服务器（端口 3000）。

选项	描述
`-p, --project <path>`	设置项目路径
`-r, --root <path>`	设置根路径
`--webpack`	启用 webpack 兼容模式
`--tracing`、`--no-tracing`	显示或隐藏编译进度；默认取配置文件中的 `tracing`，未设置时开启

配置

CLI 按以下顺序查找配置文件：

utoopack.json
utoopack.config.mjs
utoopack.config.js

详见 @utoo/pack 配置。

processEnv、watch、dev、buildId、tracing、packPath、projectPath、rootPath 等运行时字段同样从该文件读取；--project 和 --root 优先于 projectPath 和 rootPath。

构建前 CLI 会补齐几个默认值：未显式设置时 persistentCaching 默认开启；生产构建（mode 不是 development 且 dev 不为 true）下，optimization.concatenateModules、optimization.removeUnusedExports 和 optimization.removeUnusedImports 默认为 true。

示例

utoopack.json


{
  "$schema": "@utoo/pack/config_schema.json",
  "entry": [
    {
      "import": "./src/index.ts",
      "html": {
        "template": "./index.html"
      }
    }
  ],
  "output": {
    "path": "./dist",
    "filename": "[name].[contenthash:8].js",
    "chunkFilename": "[name].[contenthash:8].js",
    "clean": true
  },
  "sourceMaps": true
}

package.json 脚本

package.json


{
  "scripts": {
    "dev": "up dev",
    "build": "up build"
  }
}

Terminal


ut dev
ut build