pnpm config

별칭: c

구성 파일들을 관리하기

pnpm 설정은 두 종류의 구성 파일로 나뉩니다:

• 레지스트리 및 인증 설정은 INI 파일에 있습니다 — 전역 rc 파일과 로컬 .npmrc 파일입니다.
• 그 외 모든 pnpm 설정은 YAML 파일에 있습니다 — 전역 config.yaml과 프로젝트별 pnpm-workspace.yaml입니다.

로컬 워크스페이스 구성 파일은 프로젝트 루트에 있으며 이름은 pnpm-workspace.yaml입니다. 전역 YAML 구성 파일(config.yaml)은 다음 위치에 있습니다:

• $XDG_CONFIG_HOME 환경 변수가 설정되어 있으면, $XDG_CONFIG_HOME/pnpm/config.yaml
• Windows: ~/AppData/Local/pnpm/config/config.yaml
• 운영체제 macOS: ~/Library/Preferences/pnpm/config.yaml
• Linux: ~/.config/pnpm/config.yaml

전역 rc 파일(레지스트리/인증 설정 전용)은 다음 위치에 있습니다:

• $XDG_CONFIG_HOME env 변수가 설정된 경우, $XDG_CONFIG_HOME/pnpm/rc
• 윈도우에서: ~/AppData/Local/pnpm/config/rc
• MacOS에서: ~/Library/Preferences/pnpm/rc
• Linux에서: ~/.config/pnpm/rc

다음을 실행하여 전역 구성 파일의 경로를 확인할 수도 있습니다(v10.21.0에서 추가됨):

pnpm config get globalconfig

명령어#

<key>와 <value> 설정하기#

Config 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 allowBuilds '{"react": true, "react-dom": true}'
pnpm config set --location=project --json catalog '{ "react": "19" }'

set 명령은 속성 경로를 허용하지 않습니다.

버전 v11.22.0부터 pnpm config set은 pnpm이 읽지 않는 설정을 프로젝트의 pnpm-workspace.yaml에 쓰는 것을 거부합니다 — configDir, pnpmHomeDir, stateDir, 그리고 머신 수준 상태를 지정하는 기타 설정입니다. 이 명령은 설정이 속하는 위치가 있으면 그 위치를 알려 주며, ERR_PNPM_CONFIG_SET_NOT_A_PROJECT_SETTING으로 실패합니다. pnpm config delete는 이미 해당 키가 있는 파일에서는 여전히 그 키를 삭제합니다.

<key> 가져오기#

제공된 key의 config value를 출력하십시오.

key는 단순 키일 수 있습니다:

pnpm config get nodeVersion
pnpm config get --json nodeVersion
pnpm config get --json packageExtensions
pnpm config get --json allowBuilds
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 'allowBuilds.react'
pnpm config get --json 'allowBuilds.react'
pnpm config get catalog.react
pnpm config get --json catalog.react

속성 경로의 구문은 JavaScript 속성 경로를 모방합니다.

<key> 삭제하기#

구성 파일에서 config key를 지웁니다.

list#

모든 구성 설정 표시하기 출력은 JSON 객체입니다.

인증 관련 설정은 출력에서 숨겨집니다; 명시적으로 읽으려면 pnpm config get <key>를 사용하세요.

옵션#

--global, -g#

전역 설정 파일에서 구성을 설정 하십시오.

--location#

기본적으로 --location은 global로 설정됩니다.

project로 설정하면 pnpm은 설정을 워크스페이스 루트의 pnpm-workspace.yaml에 기록합니다(또는, 레지스트리/인증 설정의 경우, 워크스페이스 루트의 .npmrc에 기록합니다).

global로 설정하면 --global 옵션을 전달할 때와 동작이 같습니다.

--json#

get과 list가 모든 구성 설정을 JSON 형식으로 표시하도록 하고, set이 값을 JSON으로 파싱하도록 합니다.