メインコンテンツまでスキップ
Version: Next

pnpm config

エイリアス: c

設定ファイルを管理します。

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

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

グローバル設定ファイルは以下のいずれかの場所にあります。

  • $XDG_CONFIG_HOME 環境変数が設定されている場合、 $XDG_CONFIG_HOME/pnpm/rc
  • Windowsの場合: ~/AppData/Local/pnpm/config/rc
  • macOSの場合: ~/Library/Preferences/pnpm/rc
  • Linuxの場合: ~/.config/pnpm/rc

コマンド​

set <key> <value>​

設定キーを指定された値に設定します。

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

pnpm config set --location=project nodeVersion 22.0.0

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

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

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" }'

The set command does not accept a property path.

get <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

The syntax of the property path emulates JavaScript property paths.

delete <key>​

設定ファイルから設定キーを削除します。

list​

すべての設定を表示します。

オプション​

--global, -g​

グローバル設定ファイル内の設定を設定します。

--location​

By default, --location is set to global.

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 オプションを設定した場合と同じになります。

--json​

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