pnpm config

Псевдоніми: c

Керування файлами конфігурації.

Конфігураційні файли мають INI (глобальний) і YAML (локальний) формати.

Локальний файл конфігурації розташований у корені проєкту та має назву 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

Ви також можете отримати шлях до вашого глобального конфігураційного файлу, виконавши команду (додано у версії 10.21.0):

pnpm config get globalconfig

Команди

set <key> <value>

Встановити значення для ключа конфігурації.

Без прапорця --json значення розбирається як звичайний рядок:

pnpm config set --location=project nodeVersion 22.0.0

З прапорцем --json він розбирається значення як JSON:

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

Прапорець --json також дозволяє pnpm config set створювати масиви та обʼєкти:

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

Команда set не приймає шлях до властивості.

get <key>

Вивести значення конфігурації для вказаного ключа.

Ключ 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

Він також може бути шляхом до властивості:

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.

delete <key>

Видалити ключ конфігурації з файлу конфігурації.

list

Показати всі параметри конфігурації.

Параметри

--global, -g

Встановити конфігурацію у файлі глобальної конфігурації.

--location

Стандартно для --location встановлено значення global.

Якщо встановлено значення project, використовуватиметься файл .npmrc у найближчому package.json. Якщо в теці немає файлу .npmrc, налаштування буде записано у файл pnpm-workspace.yaml.

Якщо встановлено значення global, продуктивність така ж, як і з параметром --global.

--json

Зробити так, щоб get і list показували всі налаштування конфігурації у форматі JSON, а set аналізував значення як JSON.