如何发布自己的 npm 包

创建 npm 包项目

  1. 创建项目目录:

    在本地创建一个新的项目目录,并进入该目录。

  2. 初始化项目:

    在命令行中运行以下命令初始化 npm 项目:

    复制代码
    npm init 

    按照提示填写项目信息,包括包名、版本、描述等。

编写代码

在项目目录中编写你的 npm 包代码。确保代码质量和功能完整。

配置 package.json

  • 添加入口文件:

在 package.json 文件中,确保有 main 字段指定了你的包的入口文件,比如:

javascript 复制代码
"main": "index.js", 

这表示 npm 将从 index.js 文件开始加载你的包。

  • 配置 scripts(可选):

如果有一些自定义的命令或脚本需要运行,可以在 scripts 字段中添加,比如:

javascript 复制代码
"scripts": { "test": "node test.js" } 

登录 npm 账户

  1. 创建 npm 账户:

    如果还没有 npm 账户,可以在 npm官网上注册一个。

  2. 登录 npm 账户:

    在命令行中运行以下命令,输入你的 npm 账户信息登录:

    javascript 复制代码
    // 使用以下命令查看npm仓库地址
    npm config get registry
    // https://registry.npmjs.org/   这个为npm源地址,如不是这个 用以下命令设置为源地址
     
    npm config set registry https://registry.npmjs.org/
     
    // 然后执行以下命令登录
    npm login
    // 根据提示输入:用户名、密码、邮箱验证码

    输入用户名、密码、邮箱等信息。

本地调试

1、开发过程中可以在其他本地项目中使用调试,以查看实时效果

javascript 复制代码
// 在 npm 包根目录 执行以下命令
npm link

2、在本地其他项目根目录执行命令引用

javascript 复制代码
// 在需要引用的项目根目录执行
npm link 'npm包名称'

然后在项目的 node_modules 文件夹下查看是否有 npm 包

发布 npm 包

运行以下命令发布包:

javascript 复制代码
npm publish 

如果是第一次发布,可能需要验证邮箱。

更新 npm 包

如果在发布后进行了一些修改,需要更新版本号并重新发布。

  • 使用 npm version 命令,更新版本号。

规则:对于"version":"x.y.z"

  • 修复 bug 或小改动,增加 z
  • 增加了新特性,但仍能向后兼容,增加 y
  • 有很大的改动,无法向后兼容,增加 x
  • 运行以下命令重新发布

    复制代码
    npm publish 
  • 使用 时重新安装即可

    javascript 复制代码
    // 卸载之前安装的包
    npm uninstall 'npm包名'
    
    // 重新安装
    npm install 'npm包名'

注意事项

以上步骤应该能够帮助你成功发布自己的npm包。请确保在发布前认真测试和验证你的代码,以确保其他开发者能够无缝地使用你的包。

  • 在每次发布前确保测试通过,代码无误。
  • 避免频繁发布小版本号,遵循语义化版本规范。
  • 避免删除已发布的版本,可以发布的版本,但不建议删除已经有人使用的版本,因为这可能会破坏其他用户的依赖。
  • 如果你发布的是一个公共包,确保包名没有被其他用户占用。可以在 npm官网 上搜索包名来检查。
  • 如果你的包是一个重要的项目,考虑添加文档、示例代码等,使其他人更容易使用你的包。
  • 当你发布一个新版本时,不仅仅是代码变更,还需要更新 CHANGELOG 文件,向用户提供新版本的改动信息。
相关推荐
谭光志10 小时前
Vibe Coding 时代,程序员该何去何从
前端·后端·ai编程
仿生狮子12 小时前
别再说“全栈”了,AI 时代团队只认这 5 种人
前端·人工智能·后端
kyriewen12 小时前
AI 写的 React 组件,合并前必查的 6 个坏味道——每个都有代码对比
前端·javascript·react.js
Highcharts.js12 小时前
软件开发公司为什么选择 Highcharts?
前端·前端框架·echarts·数据可视化·技术选型·highcharts·图表工具
阿祖zu12 小时前
企业 AI 转型之痛,个人提效十倍不止,组织效率仍止步不前?
前端·aigc·agent
摇滚侠14 小时前
SpringBoot3+Vue3 全套视频教程 45-51
前端·javascript·vue.js
酸梅果茶14 小时前
【6】lightning_lm项目-LIO 前端 -点云预处理模块
前端·slam
Hilaku14 小时前
前端大裁员背后的恐慌:我们还剩什么底牌?
前端·javascript·程序员
咖啡无伴侣15 小时前
unplugin-auto-import 使用详解+面试高频考点
前端·架构
搬砖记录员15 小时前
录屏文件打不开?H.265兼容性踩坑与4种实战方案
前端