Node 单文件打包
给出 Node.js 入口文件,用 @vercel/ncc 把代码和 node_modules 一起编译成单个文件,用于 Serverless 函数、CLI 工具或精简 Docker 镜像。
功能与用途
部署 Serverless 函数或发布命令行工具时,带一整包 node_modules 又大又慢。这个 Skill 讲解和编排 @vercel/ncc 的打包流程:把入口和依赖编译成一个自包含文件,支持 TypeScript 直编(用项目自己的 tsconfig.json)、minify、source map、watch 模式和 externals 排除原生模块,非 JS 资源会自动拷到输出目录。
适用场景
- Serverless 函数极简打包:把接口处理函数与依赖打入单个 JS 文件,避免上传庞大的 node_modules 目录。
- 独立 CLI 命令行工具分发:编译打包 Node 命令行脚本,自动拷贝非 JS 资源并支持原生模块排除与压缩。
- 精简容器镜像体积:利用单文件产物构建轻量 Docker 镜像,减少镜像层数与安装依赖的构建耗时。
适用人群
- 部署 Serverless 函数的后端开发
- 要发布 CLI 工具或 GitHub Action 的 Node 开发者
- 负责给 Docker 镜像瘦身的工程师
使用步骤
- 全局安装或作为开发依赖安装 @vercel/ncc。
- 确定入口文件与输出目录,执行打包命令,例如 ncc build src/index.ts -o dist/,需要压缩加 -m、source map 加 -s。
- 原生二进制模块或运行时已提供的模块(如 Lambda 的 aws-sdk、sharp)用 -e 标记为 external,避免被内联。
- 开发期用 -w 进入 watch 模式;最后把打包脚本写进 package.json 的 build 与 prepublishOnly,交由 node dist/index.js 运行。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- main
- 最近更新
- 2026-09-18
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Expert guidance for @vercel/ncc — a simple CLI for compiling Node.js modules into a single file with all dependencies included. Use when bundling serverless functions, CLI tools, or any Node.js project into a self-contained file.
使用前准备
- 需要 Node.js 与 npm/pnpm/yarn/bun 环境,并安装 @vercel/ncc(命令行工具)。
依赖与权限
- 读取用户主动提供的内容