nodejs的包如何打包发布详细流程

# 使用 nrm 工具切换（推荐）
npm i -g nrm
nrm use npm  # 切换到官方镜像

# 或直接设置
npm config set registry=https://registry.npmjs.org/
npm config set proxy null  # 确保代理为空

npm login
# 按提示输入用户名、密码、邮箱（邮箱会公开）

mkdir my-package && cd my-package
npm init -y  # 或 npm init 交互式创建

{
  "name": "your-unique-package-name",  // 全局唯一，可使用 npm search 检查
  "version": "1.0.0",                  // 遵循 SemVer 规范
  "main": "index.js",                  // 入口文件
  "files": ["dist", "lib"],            // 白名单：指定发布哪些文件
  "scripts": {
    "build": "node build.js",          // 构建命令
    "prepublishOnly": "npm run build && npm test"  // 发布前自动执行
  },
  "keywords": ["nodejs", "tool"],      // 关键词，便于搜索
  "author": "Your Name",
  "license": "MIT"
}

my-package/
├── src/              # 源码
├── dist/             # 构建后的文件（发布用）
├── index.js          # 入口文件
├── README.md         # 必须：使用文档
├── .npmignore        # 黑名单：排除不发布的文件
└── package.json

# 安装构建工具（如需要）
npm install --save-dev webpack rollup

# 在 package.json 中配置构建脚本
"scripts": {
  "build": "rollup -c",
  "prepublishOnly": "npm run build"
}

# 查看哪些文件会被发布（生成 .tgz 文件预览）
npm pack

# 检查包内容
tar -tf your-package-1.0.0.tgz

# 本地测试（推荐）
npm link  # 在包目录执行
cd ../test-project
npm link your-package-name  # 在测试项目链接

npm publish

# 遵循 SemVer 规范
npm version patch  # 1.0.0 → 1.0.1（修复bug）
npm version minor  # 1.0.0 → 1.1.0（新增功能）
npm version major  # 1.0.0 → 2.0.0（不兼容变更）

# 然后重新发布
npm publish

# 24 小时内可撤销单个版本
npm unpublish your-package-name@1.0.0

# ⚠️ 限制：撤销后该版本号永久不可再用

# 全局安装 pkg
npm install -g pkg

# 打包当前项目
pkg index.js

# 生成多平台文件
pkg index.js --targets node18-linux-x64,node18-win-x64

# 1. 创建配置文件 sea-config.json
{
  "main": "dist/index.js",
  "output": "dist/out.blob"
}

# 2. 生成 blob 文件
node --experimental-sea-config sea-config.json

# 3. 拷贝 Node.js 可执行文件
cp $(command -v node) my-app

# 4. 注入 blob 到可执行文件
# （具体命令因操作系统而异，参考官方文档）

# 1. 创建 Dockerfile
FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .
CMD ["node", "index.js"]

# 2. 构建镜像
docker build -t my-app .

# 3. 运行容器
docker run -d my-app

# 完整发布流程示例
npm run test          # 1. 运行测试
npm run build         # 2. 构建代码
npm version patch     # 3. 更新版本
git add . && git commit -m "release: v1.0.1"
git tag v1.0.1
npm publish           # 4. 发布
git push && git push --tags  # 5. 推送代码