发布一个npm包,更新包,删除包

发布一个npm包,更新包,删除包

如何将自己的项目 发布为一个 npm 包 ,并掌握 更新删除 的操作流程。


🚀 一、发布一个 npm 包的完整流程

✅ 1. 注册并登录 npm 账号

如果还没有账号,先注册:

然后在终端登录:

bash 复制代码
npm login

输入用户名、密码和邮箱即可。


✅ 2. 创建你的包项目

新建一个项目目录:

bash 复制代码
mkdir my-awesome-lib
cd my-awesome-lib
npm init -y

编辑 package.json,确保以下字段有意义:

json 复制代码
{
  "name": "my-awesome-lib",     // 包名,全局唯一
  "version": "1.0.0",            // 初始版本
  "main": "index.js",            // 入口文件
  "keywords": ["utils", "tools"],
  "author": "Your Name",
  "license": "MIT"
}

创建 index.js

js 复制代码
module.exports = function sayHello(name) {
  return `Hello, ${name}!`;
};

✅ 3. 发布你的包

bash 复制代码
npm publish

🎉 成功后,你可以在 npm 官网 搜索并查看你的包!


⚠️ 注意事项(发布失败的常见原因):

  1. 包名重复(需唯一) → 可以加前缀,比如 @yourname/yourlib(私有作用域包)
  2. 没有登录
  3. 忘记上传入口文件
  4. .npmignore 忽略了必须的文件

🔄 二、更新 npm 包版本

每次发布更新必须修改 package.json 中的版本号!

bash 复制代码
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

然后再次发布:

bash 复制代码
npm publish

❌ 三、删除一个 npm 包(谨慎操作)

⚠️ npm 官方限制:包发布后 72 小时内才能删除;超时只能 unpublish 某个版本

✅ 删除整个包(必须在 72 小时内):

bash 复制代码
npm unpublish my-awesome-lib --force

✅ 删除特定版本:

bash 复制代码
npm unpublish my-awesome-lib@1.0.0

🔒 一旦超时,建议:

  • 发新版本修复
  • 添加 deprecated 标记:
bash 复制代码
npm deprecate my-awesome-lib@"<1.1.0" "This version has critical bugs, please update to 1.1.0+"

🧪 练习建议

  1. 新建一个包目录
  2. 发布一个简单的工具函数(如格式化日期、加法函数)
  3. 尝试更新一个版本
  4. 使用其他项目 npm install 引用它
相关推荐
一字白首11 分钟前
小程序组件化进阶:从复用到通信的完整指南DAY04
前端·小程序·apache
读忆13 分钟前
你是否用过Tailwind CSS?你是在什么情况下使用的呢?
前端·css·经验分享·笔记·taiiwindcss
阿珊和她的猫17 分钟前
探秘小程序:为何拿不到 DOM 相关 API
前端·小程序
军哥全栈AI27 分钟前
Windows11 彻底卸载Node.js(无残留,适配所有版本)
npm·node.js
FlyWIHTSKY28 分钟前
Vue 3 onMounted 中控制同步与异步执行策略
前端·javascript·vue.js
蜗牛攻城狮33 分钟前
【Vue3实战】El-Table实现“超过3行省略,悬停显示全文”的完美方案(附性能优化)
前端·vue.js·性能优化·element-plus
孙12~33 分钟前
前端vue3+vite,后端SpringBoot+MySQL
前端·html·学习方法
隔壁小邓35 分钟前
vue的组件化的理解之单独拆分的组件&组件的封装
前端·javascript·vue.js
困惑阿三36 分钟前
全栈部署排雷手册:从 405 报错到飞书推送成功
服务器·前端·后端·nginx·阿里云·node.js·飞书
无名-CODING38 分钟前
从零开始!Vue3+SpringBoot前后端分离项目Docker部署实战(下):Vue前端Nginx反代与致命坑点盘点
前端·spring boot·docker