optionalDependencies 到底会不会自动安装？

程序猿光泽提问于 2026-03-27 09:59:19 阅读 62

工具

我看到项目里 package.json 有个 optionalDependencies 字段，但用 pnpm install 装完后，里面的包好像没装上？是不是要加什么参数才能装 optional 的依赖啊？

我试过直接删 node_modules 重装，也试了 pnpm install --no-optional 的反向操作，但文档里又说默认是装 optional 的，现在有点懵。

{
  "optionalDependencies": {
    "fsevents": "^2.3.2"
  }
}

我来解答赞 9 收藏

反馈

2 条解答

打工人芹芹 Lv1

optionalDependencies 默认是会安装的，但 fsevents 这种包在非 macOS 系统上会被自动跳过。试试看用 pnpm install --check 或者直接在 mac 上跑一遍就知道了。要是真需要强制装，考虑改用 dependencies 字段吧。

2026-03-29 14:08

统维 Dev Lv1

这个问题的关键在于理解 optionalDependencies 的工作原理和 pnpm 的具体实现。

optionalDependencies 是一种特殊类型的依赖，主要用于某些平台特有的依赖。比如 fsevents 只在 macOS 上有意义，其他系统不需要安装它。

pnpm 默认是会尝试安装 optionalDependencies 的，但遇到编译错误时会跳过它们而不是中断整个安装过程。这可能是你没看到 fsevents 安装成功的原因之一。

首先检查你的操作系统环境是否支持 fsevents。如果是在非 macOS 系统上运行，pnpm 会直接跳过这个包的安装，并且不会报错。这是正常行为。

如果你确实需要强制安装所有可选依赖，包括那些可能不兼容当前系统的依赖，可以使用以下命令：

pnpm install --shamefully-hoist

不过要注意，--shamefully-hoist 主要用于解决一些特殊情况下的依赖冲突问题，并不能保证一定能安装所有 optionalDependencies。

如果你想确认某个具体的 optionalDependency 是否安装成功，可以在安装后运行以下命令来检查：

ls node_modules/fsevents

# 或者

find node_modules -name "fsevents"

如果返回空结果，说明该模块未被安装。但这不一定表示有问题，因为这就是 optionalDependencies 的设计初衷：在不适用的环境下静默跳过。

最后说下为什么会有这种机制：很多跨平台项目需要用到特定平台的优化库（如 fsevents 用于 mac 文件监控），但又不想让这些依赖影响到其他平台的构建过程，所以才有了 optionalDependencies 这个选项。开发者要做的就是根据实际需求判断是否需要手动处理这些"可选"依赖。

2026-03-27 10:01