XXHolic / segment

some notes
MIT License
28 stars 4 forks source link

npm 发布包遇到的问题 #28

Open XXHolic opened 5 years ago

XXHolic commented 5 years ago

目录

引子

虽然有发布过包的经历,但没有发布过自己的包,于是就参照 npm developer guide 尝试了一下,有了下面的收获。

403 Forbidden

按照文档中的步骤,注册登录后,准备好了库,然后执行 npm publish,报了下面的错误:

Error: 403 Forbidden - PUT https://registry.npmjs.org/xx - You do not have permission to publish "xx". Are you logged in as the correct user?

查询资料后,发现了这个 issue,原来是因为公开的库里面,已经有了同名的库。由于是免费的账号,所以想在 npm 上发包,要么换个名称,要么花钱创建私有包。还有一种方式就是在内网搭建自己的服务。

Error: 402 Payment Required

换了个名字,想起了自己见过的库,就模仿加了个 @ 前缀的包,再次发布的时候,报了下面的错误:

Error: 402 Payment Required - PUT https://registry.npmjs.org/@xx/xx - You must sign up for private packages

查看文档,发现 @npm/package-name 这种形式的包名,是有作用域的包名形式,执行 npm publish 的时候默认是发布私有的包。因此,第一种方式是花钱买私有包的服务,另外一种方式就是指定参数,表示公开:

npm publish --access public

需要注意的是这种形式的包名跟 npm 账户有对应关系,不能随便填写。

npm init --scope=@my-org

这种形式表示是一个组织,my-org 对应是 npm 中的组织名。

npm init --scope=@my-username

这种形式表示是个人,my-username 对应是 npm 中的用户名。

对旧包的处理

在尝试的过程中,发布了一些包,想着只是测试的包,想要移除掉,但 npm 官方很不推荐这种做法,推荐用 npm deprecate 指令,告知安装者相关信息,例如“我不再维护这个库了,请不要使用”。

npm deprecate package-name "This is test package, do not use it!"

其中 package-name 是指发布的包的名称,可能跟库的名称不一样。

发布成功了,但在 npm 上找不到包

在一次发布中,看到发布成功的提示,但到 npm 账户发现没有相关的包。

反复尝试了几次,发现原来是因为自己本地 registry 指向了内网的一个地址,并没有指向 npm 官方的地址 https://registry.npmjs.org/

所以发包的时候,先确定一下发布的指向:

npm config get registry
或
npm config list

如果发现指向不对,有两种修改的方式: 方式 1:使用 npm config set registry 改成对应的指向,但这个是全局修改,之后如果需要发布其它指向的包,又要修改回来。

方式 2:执行指令时添加 --registry 参数 在 package.json 中添加参数:

"publishConfig": { "registry": "https://npm.pkg.github.com/" }

登录的时候,添加对应的参数:

npm login --registry=https://registry.npmjs.org/

在使用 npm deprecate 指令的时候,如果本地 registry 指向不对,也要添加 --registry 参数才会有效。

如何判断 npm 账户是否已登录

由于发布的包有不同的 registry 指向,在发布包的时候,登录要指向不同的源,所以发布之前想要看看是否已登录。

查看了文档,没有找到查看登录状态的特定命令,但可以使用能触发登录检查的命令,从侧面看是否已登录。

很容易想到的就是 npm login 命令,但登录过一次后,再执行时还是提示输入账号密码。

后来发现了一个简单的指令 npm whoami ,这个指令只能在登录状态下执行,没有登录就会提示:

npm ERR! code ENEEDAUTH

npm ERR! need auth This command requires you to be logged in.

npm ERR! need auth You need to authorize this machine using npm adduser

需要注意的是,这指令不带 registry 参数时,会指向 npm 默认的 registry ,如果这个不匹配,也是没有效果的。

当有多个 registry 时,一定要注意,不少的指令都需要一致的 registry 才有效。

Back to top :arrow_up:

参考资料

:wastebasket: 德国哲学家[马克斯·韦伯][url-wiki-person]将理性分为两种:价值理性和工具理性。 简单的说,我们在思考为什么要赚钱?什么样的生活才幸福快乐?这类问题时,我们依赖的那种理性,就叫做**价值理性**。凡是考虑到做一件事的目的何在时,我们动用的那种理性,就是一种价值理性。 我们去做一件事情,用什么样的方法跟手段去达成目标,最有效、最节省精力、最合乎成本效益,这个就是**工具理性**。 马克斯·韦伯当年曾提出过,现代社会很重要的一个危机,就是**工具理性**会随着整个现代化的过程,变的盖过了**价值理性**。简单的讲,就是我们最后很容易忘记,我们为什么活着,为什么要上班。 当我看到这些时,真的是一怔,这个很好的解释了一些时候的麻木。
youngjuning commented 5 years ago

mark