弃用和取消弃用包或包版本
See Details
目录
如果你不再希望维护一个包，或者如果你想鼓励用户更新到新的或不同的版本，你可以 弃用 它。弃用一个包或版本将在用户安装它时向终端打印一条消息。
¥If you no longer wish to maintain a package, or if you would like to encourage users to update to a new or different version, you can deprecate it. Deprecating a package or version will print a message to the terminal when a user installs it.
弃用警告或消息可以说明任何内容。你可能希望包含一条消息，鼓励用户更新到特定版本或替代的受支持包。
¥A deprecation warning or message can say anything. You may wish to include a message encouraging users to update to a specific version, or an alternate, supported package.
注意：我们强烈建议弃用包或包版本而不是 unpublishing 它们，因为取消发布会从注册表中完全删除一个包，这意味着任何依赖它的人都将无法再使 用它，而不会触发警告。
¥Note: We strongly recommend deprecating packages or package versions instead of unpublishing them, because unpublishing removes a package from the registry entirely, meaning anyone who relied on it will no longer be able to use it, with no warning.
弃用整个包
¥Deprecating an entire package
弃用整个包会将其从 npm 网站的搜索结果中删除，并且包页面上也会显示弃用消息。
¥Deprecating an entire package will remove it from search results on the npm website and a deprecation message will also be displayed on the package page.
如果你的包不符合 取消发布要求，则弃用包是删除包的替代方法。
¥Deprecating a package is an alternative to deleting a package if your package does not meet the unpublishing requirements.
使用网站
¥Using the website
-
在 npm“登录”页面上，输入您的帐户详细信息并单击登录。
-
导航到你要弃用的包的包页面，将
<your-package-name>替换为你的包名称：https://www.npmjs.com/package/<your-package-name>。¥Navigate to the package page for the package you want to deprecate, replacing
<your-package-name>with the name of your package:https://www.npmjs.com/package/<your-package-name>. -
单击“设置”。
¥Click Settings.
-
在 "弃用包" 下，单击 Deprecate package。
¥Under "deprecate package", click Deprecate package.
-
如果你确定要继续，请输入你的包名称并单击 Deprecate package。
¥If you are sure that you want to continue, enter your package name and click Deprecate package.
使用命令行
¥Using the command line
要弃用整个包，请运行以下命令，将 <package-name> 替换为你的包的名称，将 "<message>" 替换为你的弃 用消息：
¥To deprecate an entire package, run the following command, replacing <package-name> with the name of your package, and "<message>" with your deprecation message:
npm deprecate <package-name> "<message>"
如果你启用了 双重身份验证，请将一次性密码添加到命令 --otp=123456（其中 123456 是你的身份验证器应用的代码）。
¥If you have enabled two-factor authentication, add a one-time password to the command, --otp=123456 (where 123456 is the code from your authenticator app).
弃用单个版本的包
¥Deprecating a single version of a package
当你弃用某个版本的包时，该版本的包页面上将显示一条红色消息，类似于弃用整个包。
¥When you deprecate a version of a package, a red message will be displayed on that version's package page, similar to deprecating an entire package.
使用命令行
¥Using the command line
要弃用包版本，请运行以下命令，将 <package-name> 替换为包名称，将 <version> 替换为版本号，将 "<message>" 替换为弃用消息：
¥To deprecate a package version, run the following command, replacing <package-name> with the name of your package, <version> with your version number, and "<message>" with your deprecation message:
npm deprecate <package-name>@<version> "<message>"
CLI 还将接受 <version> 的版本范围。
¥The CLI will also accept version ranges for <version>.
如果你有双重身份验证，请在命令 --otp=123456 中添加一次性密码（其中 123456 是你的身份验证器的代码）。
¥If you have two-factor auth, add a one-time password to the command, --otp=123456 (where 123456 is the code from your authenticator).
取消弃用包或版本
¥Undeprecating a package or version
要取消弃用包，请在上述命令之一中将 "<message>" 替换为 ""（空字符串）。
¥To undeprecate a package, replace "<message>" with "" (an empty string) in one of the above commands.
例如，要取消弃用整个包，请运行以下命令，将 <package-name> 替换为你的包的名称，将 <version> 替换为你的版本号：
¥For example, to undeprecate an entire package, run the following command, replacing <package-name> with the name of your package, and <version> with your version number:
npm deprecate <package-name> ""
或者，如果要取消仅弃用单个软件包版本，请运行以下命令，将 <package-name> 替换为你的软件包名称，将 <version> 替换为你的版本号：
¥Or to undeprecate only a single package version, run the following command, replacing <package-name> with the name of your package, and <version> with your version number:
npm deprecate <package-name>@<version> ""
如果你有双重身份验证，请在命令 --otp=123456 中添加一次性密码（其中 123456 是你的身份验证器的代码）。
¥If you have two-factor auth, add a one-time password to the command, --otp=123456 (where 123456 is the code from your authenticator).
将弃用的包转移到 npm
¥Transferring a deprecated package to npm
如果你不再维护一个包，但其他用户依赖它，并且你想从你的用户个人资料中删除它，你可以将它转移到 @npm 用户账户，该账户归 npm 注册表所有。
¥If you are no longer maintaining a package, but other users depend on it, and you'd like to remove it from your user profile, you can transfer it to the @npm user account, which is owned by the npm registry.
注意：将包转移到 npm 账户后，你将无法再更新它。
¥Note: Once you transfer a package to the npm account, you will no longer be able to update it.
要将包转移到 npm 用户账户，请按顺序运行以下两个命令，将 <user> 替换为你的 npm 用户名，将 <package-name> 替换为你要转移的包：
¥To transfer a package to the npm user account, run the following two commands in order, replacing <user> with your npm user name, and <package-name> with the package you want to transfer:
npm owner add npm <package-name>npm owner rm <user> <package-name>
如果你有双重身份验证，请在命令 --otp=123456 中添加一次性密码（其中 123456 是你的身份验证器的代码）。
¥If you have two-factor auth, add a one-time password to the command, --otp=123456 (where 123456 is the code from your authenticator).