Node扩展如何发布

在 Node.js（npm） 生态里，“Node 扩展”通常指 npm 包（Node 模块/扩展）。发布流程如下：

一、准备工作

1. 注册 npm 账号

• 官网：https://www.npmjs.com/
• 或使用命令行注册：

npm adduser

按提示输入用户名、密码、邮箱。

2. 登录 npm

npm login

检查是否登录成功：

npm whoami

二、创建 Node 扩展（包）

1. 初始化项目

mkdir my-node-ext
cd my-node-ext
npm init

或快速生成：

npm init -y

生成的 package.json 示例：

{
  "name": "my-node-ext",
  "version": "1.0.0",
  "main": "index.js",
  "description": "A node extension",
  "license": "MIT"
}

2. 编写代码

例如 index.js：

module.exports = function () {
  return 'Hello from node extension';
};

三、发布到 npm

1. 确保包名可用

npm view my-node-ext

如果报错说明可用。

2. 发布

npm publish

✅ 发布成功后可访问：

https://www.npmjs.com/package/my-node-ext

四、版本管理与更新

修改版本号

npm version patch   # 1.0.0 -> 1.0.1
npm version minor   # 1.0.0 -> 1.1.0
npm version major   # 1.0.0 -> 2.0.0

重新发布

npm publish

五、私有包 / 作用域包（可选）

作用域包

npm init --scope=yourname
npm publish --access=public

私有包

npm publish --access=private

（需要付费 npm 账号）

六、Node 原生扩展（C++ 插件）

如果你指的是 Node 原生扩展（addon）：

• 使用 N-API / node-gyp
• package.json 中配置：

{
  "gypfile": true,
  "scripts": {
    "install": "node-gyp rebuild"
  }
}

• 发布方式与普通 npm 包一致

七、常见注意事项

• 包名不能重复
• 不要发布敏感信息（.gitignore / .npmignore）
• 建议加 README.md
• 可加测试、CI

如果你指的是 VS Code / Electron / Koa / 特定框架的 Node 扩展，可以告诉我具体场景，我可以给你更针对性的发布方案。