如何发布及管理npm包

执行npm publish发布包

使用以下命令登陆npm账号,执行命令之后输入用户名、密码即可完成登陆操作

bash 复制代码
npm login

登陆之后就是发布环节,在项目发布之前最好再检查下package.json配置文件,确保name字段没有问题(要发布的包名需要唯一,否则发布将不成功),且version字段是最新的。keywords字段最好认真填写,因为keywords是开发的程序的标签,直接影响到开发的程序被其他程序员检索到的次数,也就是说这是一个和曝光量息息相关的字段。经过检查配置信息没有问题就可以进入项目根目录,使用以下命令发布

bash 复制代码
npm publish

发布之后,登录npm官网,搜索发布的包名,确保包已经成功发布并可见

版本更新与维护

在开发过程中,版本号的更新是很重要的。版本号可以帮助用户和开发者了解软件的更新状态和内容。版本号的命名原则遵循Semantic Versioning规范,通常由主版本号、次版本号和修订号组成,例如1.2.3。

更新版本号又分为手动更新和自动更新,手动更新操作就比较傻瓜一点,直接打开项目的package.json文件手动更新version字段。自动更新则是通过命令行方法更新,可以直接使用npm version命令更新,如下操作。也可以使用standard-version这样的工具根据提交的commit信息自动更新版本号

bash 复制代码
# 自动更新补丁版本号
npm version patch

# 自动更新次版本号
npm version minor

# 自动更新主版本号
npm version major

这些命令会自动更新package.json中的版本号,并创建一个新的Git提交和标签。更新版本号之后重新执行npm publish命令发布即可。

版本更新与维护过程中还有一个环节也很重要,就是README.md、CHANGELOG.md、API文档等文档信息的更新。及时更新这些文档信息可以帮助用户更好的理解软件的新功能、变更和修复。
README.md:添加新功能的描述、使用示例和任何重要的变更说明。
CHANGELOG.md:记录每个版本的变更内容,有助于用户了解每个版本的更新细节。如果想让其他程序员一起参与维护该项目,这个文件也是其他参与者上手的说明书。
API文档:如果插件有API文档,确保所有API的变更都被记录和更新

CHANGELOG.md文件格式如下:

bash 复制代码
# Changelog

## [1.1.0] - 2023-01-01
### Added
- Added a new feature that improves performance.

## [1.0.0] - 2022-12-01
### Added
- Initial release of the plugin.

管理多个注册表账户和私有包

如果需要管理多个npm注册表账户,或者发布私有npm包。则可以使用下面的方法来满足需求。

多用户管理时,可以通过创建多个.npmrc文件来管理不同的npm注册表账户。如,在项目根目录下创建一个名为.npmrc.private的文件,用于配置私有包的发布:

bash 复制代码
registry=<https://registry.npmjs.com/> //registry.npmjs.com/:\_authToken=your-private-token

发布时,只需切换到该配置文件即可:

bash 复制代码
npm --registry=<https://registry.npmjs.com/> --userconfig=.npmrc.private publish

发布私有包时,需要先在npm官网上创建一个组织,并设置相应的权限。然后在发布时,使用组织的命名空间来发布包,这样发布的包就只能被组织内的成员访问:

bash 复制代码
npm publish --access=restricted
相关推荐
deli00721 分钟前
手机拍灯为什么有一条条黑纹?PWM 240Hz 实测
前端
wangruofeng5 小时前
AI Models 1.1.0 发布,查大模型价格、对比模型和找 API 地址
前端·aigc·ai编程
wangruofeng5 小时前
给前端开发者的 100 个设计参考网站
前端·设计
星栈8 小时前
视频即代码,Remotion 能做什么、不能做什么
前端·音视频开发
广州华水科技8 小时前
单北斗GNSS位移监测系统的应用与技术解析
前端
用户47949283569159 小时前
从一句话或代码仓到可交互 HTML:开源 Agent 画图技能 Archify v3.2 实测与选型边界
前端·后端·面试
风骏时光牛马11 小时前
生成一个AI多模态标题,仅输出一条标题,无额外文字、问句、备选、配图、文案等任何附加内容,不需要其他的任务服务 只要标题。
前端
wangruofeng12 小时前
从 GIF 到 AVIF:网页图片格式演进与 2026 年选型指南
前端·架构
清晨Coding12 小时前
为什么用 React Developer Tools 查看组件树这么乱?
前端·react.js
鶴哥只手遮天13 小时前
《Electron 45.2.3 内核解剖》第 4 章 补丁体系:380 个补丁改了什么
前端·electron