Node.js v20.2.0 文档

工作流程#

启用该功能#

由于处于实验状态，目前需要显式地启用 Corepack 才能生效。 为此，则运行 corepack enable，其将在您的环境中设置 node 二进制文件旁边的符号链接（并在必要时覆盖现有的符号链接）。

从现在开始，对 支持的二进制文件 的任何调用都将无需进一步设置即可工作。 如果您遇到问题，请运行 corepack disable 从您的系统中删除代理（并考虑在 核心包仓库 上打开一个问题让我们知道）。

配置包#

Corepack 代理将在当前目录层次结构中找到最近的 package.json 文件以提取其 "packageManager" 属性。

如果该值对应于 支持的包管理器，Corepack 将确保对相关二进制文件的所有调用都针对请求的版本运行，如果需要则按需下载，如果无法成功检索则中止。

升级全局版本#

当在现有项目之外运行时（例如运行 yarn init 时），Corepack 将默认使用与每个工具的最新稳定版本大致对应的预定义版本。 可以通过运行 corepack prepare 命令以及您希望设置的包管理器版本来覆盖这些版本：

corepack prepare yarn@x.y.z --activate 拷贝

或者，可以使用标签或范围：

corepack prepare pnpm@latest --activate
corepack prepare yarn@stable --activate 拷贝

离线工作流程#

很多生产环境没有网络访问权限。 由于 Corepack 通常直接从其仓库下载包管理器版本，它可能与此类环境发生冲突。 为避免这种情况发生，请在您仍有网络访问权限时调用 corepack prepare 命令（通常在您准备部署映像的同时）。 这将确保即使没有网络访问，所需的包管理器也可用。

prepare 命令有 各种标志。 有关详细信息，请参阅详细的 核心包文档。

支持的包管理器#

以下二进制文件通过 Corepack 提供：

常见问题#

Corepack 如何与 npm 交互？#

虽然 Corepack 可以像任何其他包管理器一样支持 npm，但默认情况下不启用它的 shim。 这有几个后果：

• 总是可以在配置为与另一个包管理器一起使用的项目中运行 npm 命令，因为 Corepack 无法拦截它。

• 虽然 npm 是 "packageManager" 属性中的有效选项，但缺少 shim 将导致使用全局 npm。

运行 npm install -g yarn 不起作用#

npm 防止在进行全局安装时意外覆盖 Corepack 二进制文件。 为避免此问题，请考虑以下选项之一：

• 不要运行这个命令； Corepack 无论如何都会提供包管理器二进制文件，并确保请求的版本始终可用，因此不需要显式安装包管理器。

• 给 npm install 加上 --force 标志； 这将告诉 npm 可以覆盖二进制文件，但您将在此过程中删除 Corepack 文件。 （运行 corepack enable 将它们添加回来。）