Перейти до основного змісту
Версія: Next

pnpm config

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

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

Конфігураційні файли мають 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

Команди​

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.