npm adduser 和 npm publish 的踩坑

一、npm adduser的踩坑

1、先注册

- 注册官网:https://www.npmjs.com/

- 注意,账号接收小写英文字母【a-z】+下划线【_】,但不接受大写英文字母

 - 填写邮箱:注意,一定要去邮箱验证!!!

A. 登录邮箱去找到npm发来的邮件,点击“Verify email address"按钮去验证

B. 在新窗口点“continue”按钮 ,完成最终的验证。

C. 有个坑:在npmjs.com中注册账号的浏览器 和 邮箱验证的浏览器 要同一个!!!


2、确定源地址是否为官方地址

在VS Code终端输入:

npm adduser 

这时候会提示当前源地址是淘宝镜像!!

淘宝镜像
源地址是淘宝镜像

 坑:源地址必须是官方地址,不能是淘宝镜像!!!

- 修改源地址,在VS Code终端中输入:

npm config set registry https://registry.npmjs.org/ 

- 确定是否修改成功,输入:

npm confing list
源地址修改为官方地址

 - 修改成功后,再执行 npm adduser 


3、npm adduser 执行时踩的坑

执行步骤

        A. 提示输入用户名:你在注册时输入的名字。

        B. 提示输入密码:你在注册时输入的密码注意,密码不会显示出来给你看,是空的。不用理,直接输入你的密码即可。

        C. 提示输入邮箱:你在注册时输入的邮箱

        

踩坑如下:

坑1: 注意,用户名不是邮箱。

坑2: 用户名确定和注册时输入的一模一样,否则会出现提示如下:用户名对应的邮箱已存在。

 

二、npm publish的踩坑

1、确保终端先运行了 npm adduser

2、检查模块目录是否纯英文;【目录名不能出现中文!】

3、检查模块目录是否有 index.js文件 和 package.json文件

A.  没有index.js文件,新建一份即可;【 index.js文件是模块的入口文件,必须要有!】

B.  没有package.json文件,在VS Code终端中,进入模块目录下,输入:

cd k:\node-01\llmoduletext

 再新建package.json文件,输入:

npm init -y

package.json文件创建成功

 4、模块发布,输入

npm publish

成功截图:

npm publish 运行成功截图

失败截图:

npm publish 运行失败截图

 失败原因分析:账号注册后,未去验证邮箱!!! o(╥﹏╥)o

 5、验证成功会收到模块发布成功的邮件: “Successfully published llmodulestext@1.0.0” 

llmodulestext@1.0.0是我发布的模块名

6、在nodejs.com官网中,查看packages 可以找到更新的模块名'llmoduletext'

 

### 发布 NPM 包的过程 为了成功发布一个NPM包,开发者需遵循一系列特定步骤来准备配置项目。创建并测试好本地库之后,下一步就是将其分享给更广泛的社区。 #### 注册与登录 首先,在命令行工具中注册一个新的账号或使用现有账户登录: ```bash npm adduser ``` 这一步骤会提示输入用户名、密码以及邮箱地址[^1]。 #### 初始化新包 在项目的根目录下运行`npm init`命令,按照指示完成JSON文件的初始化设置。此操作将生成必要的`package.json`文件,其中包含了关于该软件包的重要元数据信息,比如名称、版本号等。 #### 配置入口文件 对于采用ESM标准编写的模块化JavaScript程序来说,可以通过指定`module`字段作为浏览器环境下的默认加载路径;而对于兼容CommonJS规范的传统Node.js应用,则继续沿用`main`属性指向相应的入口脚本位置[^2]。 例如,在`package.json`内添加如下内容以支持两种不同类型的导入方式: ```json { "name": "your-package-name", "version": "0.0.1", "description": "...", "main": "./dist/index.cjs", // CommonJS entry point "module": "./src/index.esm.js" // ES Module entry point } ``` #### 构建与打包 确保已经设置了合适的构建流程(如Webpack, Rollup),以便能够针对不同的目标平台产出优化后的输出文件。通常情况下,这些产物会被放置于`/dist`或其他预设好的分发目录之下。 #### 安全性考量 考虑到安全因素,在正式提交之前建议执行以下几项措施: - 更新依赖关系至最新稳定版; - 移除不必要的开发阶段专用资源; - 对源码实施严格的静态分析扫描; - 测试所有公开接口的功能完整性。 #### 提交前最后检查 仔细核对`README.md`文档是否清晰描述了安装指南、API说明等内容,并确认`.gitignore`已排除敏感资料泄露风险。 #### 执行发布指令 当一切准备工作完成后,就可以通过简单的CLI命令向官方仓库推送最新的变更记录了: ```bash npm publish ``` 如果希望仅限内部团队访问私有化的存储空间而不对外公开,则可利用企业级解决方案——如GitHub Packages或是自托管型服务器实现这一需求。 #### 版本管理策略 每当引入非破坏性的修复补丁时应增加小数点后一位数字(`patch`);新增功能特性但保持向下兼容则提升中间位次序(`minor`);而一旦发生不兼容的重大改动就必须调整最前面的主要部分(`major`)。具体更新类型可通过参数传递给publish函数来进行控制。 #### 取消发布的处理方法 假如发现刚刚上线的内容存在问题急需撤回的话,可以借助unpublish命令快速撤销某单一版本甚至整个历史记录: ```bash npm unpublish <package_name>@<version> ``` 需要注意的是,频繁地删除重发可能会引起缓存同步延迟等问题,因此务必谨慎行事。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值