前言

面給出一份「從 0 到 1」把 Node.js 代碼打包并發(fā)布為公共 npm 包的完整流程，全部步驟均來自 2024-2025 年最新社區(qū)實踐，可直接照做。

（如只想打綠色可執(zhí)行文件而不發(fā)布，可跳到最后「附：PKG 綠色可執(zhí)行包」小節(jié)）

一、前置準(zhǔn)備

1. 安裝 Node.js ≥ 14（推薦 18 LTS）

2. 注冊 npm 賬號 → https://www.npmjs.com/signup

3. 本地登錄

   npm login               # 按提示輸入賬號、密碼、郵箱
   npm whoami              # 驗證是否登錄成功

二、創(chuàng)建與編碼

1. 新建文件夾并初始化

   mkdir my-utils          # 包名僅作示例
   cd my-utils
   npm init -y             # 生成默認(rèn) package.json

2. 修改 package.json（關(guān)鍵字段）

   {
     "name": "my-utils",          // 全網(wǎng)唯一，可先去 npm 搜索確認(rèn)
     "version": "1.0.0",
     "description": "常用工具函數(shù)",
     "main": "dist/index.js",     // CommonJS 入口
     "module": "dist/index.mjs",  // ESModule 入口（可選）
     "files": ["dist"],           // 只發(fā)布 dist 目錄
     "scripts": {
       "build": "tsup src/index.ts --format cjs,esm --dts",
       "prepublishOnly": "npm run build"
     },
     "keywords": ["utils", "tool"],
     "author": "your-name <you@example.com>",
     "license": "MIT",
     "repository": {
       "type": "git",
       "url": "https://github.com/yourname/my-utils.git"
     }
   }

3. 業(yè)務(wù)代碼

   src
   └── index.ts

   示例 src/index.ts

   export const sleep = (ms: number) =>
     new Promise<void>(r => setTimeout(r, ms));

4. 安裝打包工具（零配置，2024 最流行）

   npm i -D tsup typescript @types/node

三、一鍵構(gòu)建

npm run build

生成 dist/ 目錄，里面同時出現(xiàn)

• index.js → CommonJS

• index.mjs → ESModule

• index.d.ts → 類型聲明

四、本地“白嫖”測試（可選）

1. 把包鏈到全局

   npm link

2. 在任意項目里

   npm link my-utils

3. 使用

   const { sleep } = require('my-utils');
   (async () => { await sleep(1000); console.log('ok'); })();

五、發(fā)布公共包

1. 確保包名全局唯一（去 https://www.npmjs.com/search 搜一下）

2. 發(fā)布

   npm publish --access public

   成功后會收到 npm 官方郵件；隨后任何人可

   npm i my-utils

六、常見踩坑提醒

表格

復(fù)制

附：PKG 綠色可執(zhí)行包（可選，不發(fā)布 npm 也能用）

1. 安裝

   npm i -g pkg

2. 在 package.json 里增加

   "bin": "dist/cli.js",
   "pkg": {
     "targets": ["node18-win-x64", "node18-linux-x64", "node18-macos-x64"],
     "outputPath": "release"
   }

3. 打包

   pkg . --compress Brotli

   得到 release/ 目錄下的綠色可執(zhí)行文件，無 Node 環(huán)境也能運行。

完成！現(xiàn)在你已經(jīng)同時擁有

• 一個可 npm i xxx 安裝的公共包；

• 一份可選的綠色可執(zhí)行文件用于離線分發(fā)。

如需繼續(xù)補(bǔ)充「CI 自動發(fā)布」「語義化版本」「雙模塊（CommonJS + ESM）兼容」等進(jìn)階主題。

總結(jié)

到此這篇關(guān)于nodejs打包作為公共包使用的文章就介紹到這了,更多相關(guān)nodejs打包公共包使用內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論