# 使用 nrm 工具切換（推薦）
npm i -g nrm
nrm use npm  # 切換到官方鏡像

# 或直接設(shè)置
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 交互式創(chuàng)建

{
  "name": "your-unique-package-name",  // 全局唯一，可使用 npm search 檢查
  "version": "1.0.0",                  // 遵循 SemVer 規(guī)范
  "main": "index.js",                  // 入口文件
  "files": ["dist", "lib"],            // 白名單：指定發(fā)布哪些文件
  "scripts": {
    "build": "node build.js",          // 構(gòu)建命令
    "prepublishOnly": "npm run build && npm test"  // 發(fā)布前自動執(zhí)行
  },
  "keywords": ["nodejs", "tool"],      // 關(guān)鍵詞，便于搜索
  "author": "Your Name",
  "license": "MIT"
}

my-package/
├── src/              # 源碼
├── dist/             # 構(gòu)建后的文件（發(fā)布用）
├── index.js          # 入口文件
├── README.md         # 必須：使用文檔
├── .npmignore        # 黑名單：排除不發(fā)布的文件
└── package.json

# 安裝構(gòu)建工具（如需要）
npm install --save-dev webpack rollup

# 在 package.json 中配置構(gòu)建腳本
"scripts": {
  "build": "rollup -c",
  "prepublishOnly": "npm run build"
}

# 查看哪些文件會被發(fā)布（生成 .tgz 文件預(yù)覽）
npm pack

# 檢查包內(nèi)容
tar -tf your-package-1.0.0.tgz

# 本地測試（推薦）
npm link  # 在包目錄執(zhí)行
cd ../test-project
npm link your-package-name  # 在測試項目鏈接

npm publish

# 遵循 SemVer 規(guī)范
npm version patch  # 1.0.0 → 1.0.1（修復(fù)bug）
npm version minor  # 1.0.0 → 1.1.0（新增功能）
npm version major  # 1.0.0 → 2.0.0（不兼容變更）

# 然后重新發(fā)布
npm publish

# 24 小時內(nèi)可撤銷單個版本
npm unpublish your-package-name@1.0.0

# ?? 限制：撤銷后該版本號永久不可再用

# 全局安裝 pkg
npm install -g pkg

# 打包當(dāng)前項目
pkg index.js

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

# 1. 創(chuàng)建配置文件 sea-config.json
{
  "main": "dist/index.js",
  "output": "dist/out.blob"
}

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

# 3. 拷貝 Node.js 可執(zhí)行文件
cp $(command -v node) my-app

# 4. 注入 blob 到可執(zhí)行文件
# （具體命令因操作系統(tǒng)而異，參考官方文檔）

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

# 2. 構(gòu)建鏡像
docker build -t my-app .

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

# 完整發(fā)布流程示例
npm run test          # 1. 運行測試
npm run build         # 2. 構(gòu)建代碼
npm version patch     # 3. 更新版本
git add . && git commit -m "release: v1.0.1"
git tag v1.0.1
npm publish           # 4. 發(fā)布
git push && git push --tags  # 5. 推送代碼