@vercel/ncc Wiki

术语表

核心概念

术语	说明
ncc	Node.js Compiler Collection 的缩写，将 Node.js 模块编译为单文件
自举（Bootstrap）	ncc 使用自身来编译自身的构建策略
资源重定位（Asset Relocation）	分析代码中的文件系统引用，将引用的文件复制到输出目录
ExternalMap	自定义的映射数据结构，支持精确匹配和正则匹配
finalizeHandler	Webpack 编译完成后的后处理函数
memory-fs	内存中的虚拟文件系统，用于接收 Webpack 输出

模块解析

术语	说明
@@notfound.js	占位模块，将构建时无法解析的模块转为运行时 require
TsconfigPathsPlugin	Webpack resolve 插件，支持 TypeScript paths 别名
conditionNames	Node.js 条件导出中使用的条件名（如 `require`、`import`、`node`）
mainFields	package.json 中用于确定入口文件的字段（ncc 只使用 `main`）
包边界（Package Boundary）	由 package.json 定义的模块包范围

输出处理

术语	说明
V8 缓存	使用 V8 引擎预编译代码为字节码，加速冷启动
`__nccwpck_require__`	ncc 重命名后的 Webpack require 函数，支持嵌套构建
source-map-register	运行时注册 source map 支持的模块
shebang	文件首行的 `#!/usr/bin/env node` 指令
Terser mangle	标识符混淆，缩短变量名以减少文件体积
assetBuilds	递归编译输出中的 JS 资源文件（如 worker）

Webpack 相关

术语	说明
Loader	Webpack 模块转换器，在模块加载时处理文件内容
resolve 插件	自定义 Webpack 的模块路径解析行为
compilation	Webpack 一次编译过程的上下文对象
compilationStack	ncc 维护的编译上下文栈，支持嵌套编译
scope hoisting	Webpack 的模块连接优化（`concatenateModules`）
deterministic IDs	确定性的模块/chunk ID，确保输出稳定
`node: false`	禁用 Webpack 的 Node.js polyfill

构建与发布

术语	说明
semantic-release	基于 commit 消息自动确定版本号并发布
Conventional Commits	约定式提交格式（如 `feat:`, `fix:`, `chore:`）
OIDC trusted publishing	通过 OpenID Connect 进行 npm 可信发布
corepack	Node.js 内置的包管理器版本管理工具
frozen lockfile	安装时不更新 lock 文件，确保可复现

文件格式

术语	说明
ESM	ECMAScript Modules，使用 `import`/`export`
CJS	CommonJS，使用 `require()`/`module.exports`
`.mjs`	强制 ESM 格式的文件扩展名
`.cjs`	强制 CJS 格式的文件扩展名
`"type": "module"`	package.json 中声明包内 `.js` 文件为 ESM