#配置选项参考

#CLI 选项

#API 选项

require('@vercel/ncc')(entry, options)

#选项详解

#cache

• false：完全禁用缓存
• string：使用指定路径作为缓存目录
• undefined（默认）：使用 ~/.cache/ncc/<project-hash>

缓存基于 ncc 版本和入口文件路径的哈希值命名。版本升级后缓存自动失效。

#esm

自动检测逻辑（src/index.js:40）：

entry.endsWith('.mjs') || !entry.endsWith('.cjs') && hasTypeModule(entry)

手动设置可覆盖自动检测。ESM 模式会：

• 使用 libraryTarget: 'module'
• 启用 experiments.outputModule
• 禁用 V8 缓存
• 使用 import condition 解析依赖
• 必要时生成 package.json 声明 "type": "module"

#externals

三种格式：

// 数组格式：保留原始模块名
externals: ["fs", "path", "./config.json"]

// 对象格式：模块名映射
externals: { "old-module": "new-module" }

// 正则格式（对象中的键使用 /regex/ 语法）
externals: { "/caniuse-lite(/.*)/" : "caniuse-lite$1" }

#target

传入值必须以 es 开头（如 es2015、es2020）。映射到 Webpack 的 target 配置：

• 设置时：["node14", target]
• 未设置时："node14"

#watch

• true：使用 Webpack 默认的文件监视
• object：传入自定义 WatchFileSystem 实例

Watch 模式返回值不是 Promise，而是 { handler, rebuild, close } 对象。

#customEmit

customEmit: (path, { id, isRequire }) => {
  // 返回 false 阻止资源发射
  // 返回 string 替换为自定义代码
  // 返回 undefined 使用默认行为
}

由 @vercel/webpack-asset-relocator-loader 调用，用于自定义资源处理逻辑。

#filterAssetBase

限制资源输出的范围。只有位于此目录内的文件才会作为 asset 输出。超出此范围的文件引用会被忽略。

#production

控制 Node.js 条件导出（conditional exports）中使用 "production" 还是 "development" 条件。默认 true 使用 production 条件。

#环境变量