跳到主内容
版本：11.x

配置

pnpm 设置分为两类：

  • 身份验证和证书设置存储在 INI 文件中。 这些文件包含敏感凭据，不应提交到你的仓库。 有关详细信息，请参阅身份验证设置。
  • 所有其他设置都存储在 YAML 文件中：项目 pnpm-workspace.yaml 和全局 config.yaml。

pnpm 也不再从 package.json 的 pnpm 字段读取设置。 设置应在 pnpm-workspace.yaml 中定义。

本地项目配置​

项目级设置放在 pnpm-workspace.yaml 文件中：

pnpm-workspace.yaml
nodeVersion: "22"
saveExact: true

全局配置​

全局 YAML 配置文件（config.yaml）位于以下路径之一：

  • 如果设置了 $XDG_CONFIG_HOME 环境变量，则 $XDG_CONFIG_HOME/pnpm/config.yaml
  • 在 Windows 上：~/AppData/Local/pnpm/config/config.yaml
  • 在 macOS 上：~/Library/Preferences/pnpm/config.yaml
  • 在 Linux 上：~/.config/pnpm/config.yaml

全局 rc 文件（仅用于注册表和身份验证设置）位于：

  • 如果设置了 $XDG_CONFIG_HOME 环境变量，则为 $XDG_CONFIG_HOME/pnpm/rc
  • 在 Windows上：~/AppData/Local/pnpm/config/rc
  • 在 macOS 上：~/Library/preferences/pnpm/rc
  • 在 Linux上：~/.config/pnpm/rc

环境变量​

名称以 pnpm_config_（或 PNPM_CONFIG_）开头的环境变量将被加载到配置中。 这些设置会覆盖 pnpm-workspace.yaml 中的设置，但不会覆盖 CLI 参数。

警告

pnpm 不再读取 npm_config_* 环境变量。 请改用 pnpm_config_* 环境变量（例如，pnpm_config_registry 而不是 npm_config_registry）。

例如：

pnpm_config_save_exact=true pnpm add foo

如果你需要 pnpm 跨多个硬盘或文件系统工作， 请阅读常见问题解答。

有关管理配置的更多信息，请参阅 config 命令。