CLI & Node.js Settings

Параметри CLI

[no-]color

• Стандартно: auto
• Тип: auto, always, never

Керує кольорами у виводі.

• auto — вивід використовує кольори, коли стандартним виводом є термінал або TTY.
• always — ігнорувати різницю між терміналами та конвеєрами. У більшості сценаріїв, якщо вам потрібні кольорові коди у перенаправленому виводі, ви можете замість цього передати команді pnpm прапорець --color, щоб змусити її використовувати кольорові коди. Стандартні налаштування майже завжди відповідають вашим потребам.
• never — вимикає кольори. Цей параметр використовується для --no-color.

loglevel

• Стандартно: info
• Тип: debug, info, warn, error

Будуть показані всі журнали вказаного рівня або вище. Замість цього ви можете передати --silent, щоб вимкнути всі журнали виводу.

useBetaCli

• Стандартно: false
• Тип: Boolean

Експериментальна опція, яка дозволяє використовувати бета-функції CLI. Це означає, що ви можете отримати деякі зміни у функціоналі CLI, які є порушеннями або потенційними помилками.

recursiveInstall

• Стандартно: true
• Тип: Boolean

Якщо цей параметр увімкнено, основною поведінкою pnpm install стане поведінка pnpm install -r, тобто встановлення буде виконано до всіх пакунків робочого простору або вкладених тек.

Інакше, pnpm install збиратиме пакунок виключно у поточній теці.

engineStrict

• Стандартно: false
• Тип: Boolean

Якщо цей параметр увімкнено, pnpm не встановлюватиме пакунки, які стверджують, що вони несумісні з поточною версією Node.

Незалежно від цієї конфігурації, встановлення завжди завершиться невдачею, якщо проєкт (не залежність) вкаже несумісну версію у своєму полі engines.

npmPath

• Тип: path

Розташування бінарного файлу npm, який pnpm використовує для деяких дій, таких як публікація.

pmOnFail

Додано у: v11.0.0

• Стандартно: download
• Тип: download, error, warn, ignore

Overrides the onFail behavior of both the packageManager field and devEngines.packageManager when the running pnpm version does not match the declared one.

• download — download and run the declared pnpm version (this is the default and matches the previous managePackageManagerVersions: true behavior).
• error — fail the command (equivalent to the previous packageManagerStrictVersion: true).
• warn — print a warning but continue (equivalent to the previous packageManagerStrict: false or COREPACK_ENABLE_STRICT=0).
• ignore — skip the check entirely (equivalent to the previous managePackageManagerVersions: false). Useful when version management is handled by an external tool such as asdf, mise, or Volta.

Can be set via CLI flag, environment variable, or pnpm-workspace.yaml:

pnpm install --pm-on-fail=ignore
pnpm_config_pm_on_fail=ignore pnpm install

pnpm-workspace.yaml

pmOnFail: ignore

This setting replaces the removed managePackageManagerVersions, packageManagerStrict, and packageManagerStrictVersion settings, as well as the COREPACK_ENABLE_STRICT environment variable.

Migration:

Removed setting	Змінено на
managePackageManagerVersions: true	pmOnFail: download (стандартно)
managePackageManagerVersions: false	pmOnFail: ignore
packageManagerStrict: false	pmOnFail: warn
packageManagerStrictVersion: true	pmOnFail: error
COREPACK_ENABLE_STRICT=0	pmOnFail: warn

See also pnpm with for running pnpm at a specific version without changing this setting.

ignoreWorkspaceRootCheck

• Стандартно: false
• Тип: Boolean

If this is enabled, running pnpm install/pnpm add from the project's root folder will no longer error when -w/--ignore-workspace-root-check is not provided.

Параметри Node.js

nodeVersion

• Стандартно: значення, що повертається node -v, без префікса v
• Тип: точна версія semver (не діапазон)

Версія Node.js, яку слід використовувати при перевірці параметра engines пакунка.

Якщо ви хочете заборонити учасникам вашого проєкту додавати нові несумісні залежності, використовуйте nodeVersion та engineStrict у файлі pnpm-workspace.yaml у корені проєкту:

nodeVersion: 12.22.0
engineStrict: true

This way, even if someone is using Node.js v22, they will not be able to install a new dependency that doesn't support Node.js v12.22.0.

runtimeOnFail

Додано у: v11.0.0

• Стандартно: undefined
• Тип: download, error, warn, ignore

Overrides the onFail field of devEngines.runtime (and engines.runtime) in the root project's package.json. This is useful when you want a different local behavior than what is written in the manifest — for instance, forcing pnpm to download the declared runtime even when the manifest sets onFail: "warn":

pnpm-workspace.yaml

runtimeOnFail: download

nodeDownloadMirrors

Додано у: v11.0.0

• Стандартно: undefined
• Тип: Record<string, string>

Налаштуйте власні дзеркала завантаження Node.js у pnpm-workspace.yaml. Ключі — це канали релізів (release, rc, nightly, v8-canary тощо), а значення — URL-адреси.

Ось як можна налаштувати pnpm для завантаження Node.js з дзеркала Node.js в Китаї:

nodeDownloadMirrors:
  release: https://npmmirror.com/mirrors/node/
  rc: https://npmmirror.com/mirrors/node-rc/
  nightly: https://npmmirror.com/mirrors/node-nightly/