从 Yarn 迁移

Yarn 是一个包管理器，不是运行时，因此你“迁移”的大部分内容是 配置，而不是代码。Yarn Classic 和 Yarn Berry 都使用标准的 package.json 来描述项目，而 Deno 会直接读取它：它会安装并解析相同的 npm 依赖，并运行你的脚本。一个典型的 Yarn 项目在 Deno 下通常无需任何改动即可运行。

唯一需要做出决定的 Yarn 功能是 Plug'n'Play，也就是 Yarn Berry 的默认 安装模式。Deno 不使用 PnP；它会安装一个真实的 node_modules 目录。下面会对此进行说明。

运行你的项目 Jump to heading#

安装依赖并运行你的入口文件：

cd my-yarn-app
deno install
deno run main.js

deno install 会读取你现有的 package.json 并解析相同的 npm 包，就像 yarn install 一样。它会写入一个 node_modules 目录以及它自己的 deno.lock。

在你第一次执行 deno install 时，如果还没有 deno.lock，Deno 会从 Yarn Classic (v1) 的 yarn.lock 进行初始化，沿用你已经锁定的版本和完整性 哈希。Yarn Berry (v2+) 使用不同的锁文件格式，Deno 不会从中初始化；在这种情况下，Deno 会重新解析你的 package.json 范围，因此在提交之前请先检查 deno.lock。

package.json 中定义的脚本会使用 deno task 运行，它相当于 yarn run：

deno task start

如果你还把应用从 Node 切换到 Deno 运行，那么要预期 一个立刻可见的差异：Deno 默认是沙箱化的。程序第一次访问 网络、文件系统或环境变量时，Deno 会提示请求权限。 你可以先使用 deno run -A main.js 一次性授予全部权限，以匹配 Node 的 行为，然后再在之后收紧这些标志。参见 安全性与权限。

Yarn 到 Deno 对照速查表 Jump to heading#

Deno 还内置了格式化工具和代码检查器，因此 deno fmt 和 deno lint 可以在无需额外依赖的情况下替代 Prettier 和 ESLint。

工作区 Jump to heading#

Yarn 会将工作区的 glob 模式存储在 package.json 的 workspaces 下，而 Deno 会直接读取该字段。像这样的 monorepo 可以直接按原样运行：

{
  "workspaces": ["packages/*"]
}

各成员通过其 package.json 依赖中的 workspace: 协议 相互引用，和在 Yarn 下的方式完全一样。无需进行任何转换。有关解析机制的工作原理，请参见 Workspaces。

Plug'n'Play Jump to heading#

Yarn Berry 默认使用 Plug'n'Play，它会跳过 node_modules，并通过生成的 .pnp.cjs 文件来解析包。Deno 不支持 PnP。当你运行 deno install 时，它会改为写入一个普通的 node_modules 目录，因此在 Deno 下你完全不需要 PnP。

实际上，这意味着一旦你迁移到 Deno，PnP 相关的文件和设置就不再适用：

• .pnp.cjs 和 .pnp.loader.mjs 不再使用。Deno 从 node_modules 进行解析。
• .yarnrc.yml 中的解析器设置（nodeLinker、pnpMode、plugins）是专门为 Yarn 配置的，不会沿用到 Deno。
• yarn patch 没有内置的 Deno 对应功能。你可以将依赖 vendoring，或者把补丁保留在 fork 中。

需要注意的事项 Jump to heading#

• 生命周期脚本默认不会运行。 如果某个依赖需要依赖 install 或 postinstall 脚本（原生插件、node-gyp 构建），请使用 deno install --allow-scripts=npm:<pkg> 为该包单独授权，或者通过 deno approve-scripts 管理审批。 这是出于安全考虑的默认行为，不是缺少功能。

继续 Jump to heading#

• 从 Node.js 迁移。 如果你也在迁移 运行时，这里涵盖了 CommonJS 和 ES 模块解析，以及 Deno 支持的 Node 内置模块。
• 从 npm 迁移 和 从 pnpm 迁移。 相同的 Deno 命令，并附带每种工具工作区格式的说明。
• 依赖管理。 详细介绍 npm、JSR 和 package.json 工作流。
• 供应链管理。 deno audit、 锁文件规范，以及最小依赖年龄。