发布开源包到 npm 需注册账号并用官方 registry 登录，确保 package.json 含唯一 name、语义化 version、main 入口等字段，构建产物后执行 npm publish，再新建项目安装验证。
发布自己的开源包到 npm 仓库，核心是让代码可发现、可安装、可运行。整个流程不复杂，但关键步骤必须到位，否则会失败或发布无效内容。
注册账号并正确登录
必须使用官方 registry 登录，不能用淘宝镜像等代理源：
- 访问 npmjs.com 注册账号（邮箱需验证）
- 终端执行
npm login，按提示输入用户名、密码、已验证邮箱 - 确认当前 registry 是官方地址：
npm config get registry应返回https://registry.npmjs.org/
确保 package.json 配置合规
这是发布成功与否的决定性文件，至少要包含以下字段：
-
name：包名唯一，不能与已有包重名（可在 npmjs.com 搜索确认）；scoped 包（如
@yourname/utils）默认私有，公开需加--access public -
version：必须符合语义化版本（如
1.0.0），且不能重复发布相同版本；可用npm version patch自动递增 -
main：指定运行入口（如
"main": "dist/index.js"） -
types（如有 TypeScript）：指向类型声明文件（如
"types": "dist/index.d.ts"） -
files 或
.npmignore：显式声明要发布的文件，避免误传src/、tests/、.git等
构建与本地预览
npm 不会自动编译源码，你得自己准备好可运行产物：
立即学习“Java免费学习笔记（深入）”；
- 若用 TypeScript、ESM 或需转译，先执行构建命令（如
npm run build），确保dist/目录存在且结构正确 - 运行
npm pack生成.tgz包，手动解压检查：入口文件是否存在、类型是否齐全、有没有意外打包的大文件或敏感内容 - 建议在
package.json#scripts中加入"prepublishOnly": "npm run build"，防止忘记构建
正式发布与后续验证
确认无误后执行发布命令，并快速验证是否生效：
- 基础发布：
npm publish - 发布 scoped 公共包：
npm publish --access public - 发布测试版（不覆盖 latest）：
npm publish --tag beta - 发布后立即新开终端，创建空目录，运行
npm init -y && npm install your-package-name，再写个简单脚本 require 并调用，确认能正常加载和执行
发布不是终点。记得及时更新文档、维护 issue、响应社区反馈，一个长期活跃的开源包才真正有价值。
