SuperAPI AI 工具集

ncc

通用与其它

查看项目

更新于 10-16 06:43

技能介绍

用途:@vercel/ncc(Node.js Compiler Collection)是 Vercel 提供的简单 CLI,用于把 Node.js 模块连同其全部依赖编译成单个文件。适合无服务器函数(部署单文件而非 node_modules)、CLI 工具(分发自包含可执行文件)以及 Docker 镜像(去掉 node_modules 以减小体积)。

安装:npm install -g @vercel/ncc,或作为开发依赖 npm install --save-dev @vercel/ncc。

基本用法:ncc build input.js -o dist/ 编译输出;ncc build input.js -o dist/ -w 开启监听模式;ncc run input.js 直接运行而不写盘。

主要能力与选项:-o/--out 指定输出目录(默认 dist);-m/--minify 压缩输出;-s/--source-map 生成 source map;-a/--asset-builds 递归构建嵌套 JS 资源;-e/--external 将模块保留为外部依赖不打包;-w/--watch 变更时重建;-t/--transpile-only 跳过 TypeScript 类型检查;--license 输出许可证到文件;-q/--quiet 抑制非错误输出;--no-cache 跳过构建缓存;--no-asset-builds 跳过嵌套 JS 资源构建。

TypeScript:原生支持,无需单独 tsc 步骤,会自动使用项目的 tsconfig.json,例如 ncc build src/index.ts -o dist/,加 -t 可跳过类型检查加快构建。

外部依赖:对原生模块或可选依赖可用 -e 排除,如 ncc build input.js -e aws-sdk -e sharp;在运行时已提供某些模块的无服务器环境(如 AWS Lambda 的 aws-sdk)中应标记为 external。

静态资源:非 JS 资源(.json、.node、二进制文件)会被复制到输出目录并在运行时正确引用。

常见模式:无服务器函数可用 ncc build api/handler.ts -o .output/ -m --no-cache;CLI 工具可在 package.json 中配置 bin 与 prepublishOnly 脚本;GitHub Actions 建议用 ncc 打包为单文件,如 ncc build src/index.ts -o dist/ -m --license licenses.txt。

限制与注意:无配置文件,完全由 CLI 标志驱动;二进制 .node 原生模块通常需要设为 external;调试可用 -s 生成 .js.map;开发时用 -w 快速迭代。官方资源见 ncc GitHub 与 Vercel 博客的 ncc 介绍。