Skip to main content
Version: 10.x

pnpm config

别名：c

🌐 Aliases: c

管理配置文件。

🌐 Manage the configuration files.

配置文件有 INI（全局）和 YAML（本地）格式。

🌐 The configuration files are in INI (the global) and YAML (the local) formats.

本地配置文件位于项目根目录下，名为 pnpm-workspace.yaml。

🌐 The local configuration file is located in the root of the project and is named pnpm-workspace.yaml.

全局配置文件位于以下位置之一：

🌐 The global configuration file is located at one of the following locations:

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

你还可以通过运行以下命令来获取全局配置文件的路径（v10.21.0 版本新增）：

🌐 You can also retrieve the path to your global config file by running (added in v10.21.0):

pnpm config get globalconfig

命令​

🌐 Commands

设置 <key> <value>​

🌐 set <key> <value>

将配置键设置为提供的值。

🌐 Set the config key to the value provided.

没有 --json 标志时，它会将值解析为普通字符串：

🌐 Without the --json flag, it parses the value as plain string:

pnpm config set --location=project nodeVersion 22.0.0

使用 --json 标志，它会将值解析为 JSON：

🌐 With the --json flag, it parses the value as JSON:

pnpm config set --location=project --json nodeVersion '"22.0.0"'

--json 标志还允许 pnpm config set 创建数组和对象：

🌐 The --json flag also allows pnpm config set to create arrays and objects:

pnpm config set --location=project --json onlyBuiltDependencies '["react", "react-dom"]'
pnpm config set --location=project --json catalog '{ "react": "19" }'

set 命令不接受属性路径。

🌐 The set command does not accept a property path.

获取<key>​

🌐 get <key>

打印提供的密钥的配置值。

🌐 Print the config value for the provided key.

key 可以是一个简单的键：

🌐 The key can be a simple key:

pnpm config get nodeVersion
pnpm config get --json nodeVersion
pnpm config get --json packageExtensions
pnpm config get --json onlyBuiltDependencies
pnpm config get --json catalog

它也可以是属性路径：

🌐 It can also be a property path:

pnpm config get 'packageExtensions["@babel/parser"].peerDependencies["@babel/types"]'
pnpm config get --json 'packageExtensions["@babel/parser"].peerDependencies["@babel/types"]'
pnpm config get 'onlyBuiltDependencies[0]'
pnpm config get --json 'onlyBuiltDependencies[0]'
pnpm config get catalog.react
pnpm config get --json catalog.react

属性路径的语法模拟 JavaScript 属性路径。

🌐 The syntax of the property path emulates JavaScript property paths.

删除 <键>​

🌐 delete <key>

从配置文件中删除配置密钥。

🌐 Remove the config key from the config file.

list​

显示所有配置设置。

🌐 Show all the config settings.

选项​

🌐 Options

--global, -g​

在全局配置文件中设置配置。

🌐 Set the configuration in the global config file.

--location​

默认情况下，--location 设置为 global。

🌐 By default, --location is set to global.

当设置为 project 时，将使用最近 package.json 处的 .npmrc 文件。如果目录中不存在 .npmrc 文件，该设置将写入 pnpm-workspace.yaml 文件。

🌐 When set to project, the .npmrc file at the nearest package.json will be used. If no .npmrc file is present in the directory, the setting will be written to a pnpm-workspace.yaml file.

当设置为 global 时，性能与设置 --global 选项时相同。

🌐 When set to global, the performance is the same as setting the --global option.

--json​

让 get 和 list 以 JSON 格式显示所有配置设置，并让 set 将值解析为 JSON。

🌐 Make get and list show all the config settings in JSON format and make set parse the value as JSON.