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

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

pnpm config get globalconfig

Commands#

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

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

get <key>#

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

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

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

list#

모든 구성 설정 표시하기

옵션#

--global, -g#

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

--location#

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

project로 설정하면 가장 가까운 package.json 위치의 .npmrc 파일이 사용됩니다. 디렉터리에 .npmrc 파일이 없으면 설정이 pnpm-workspace.yaml 파일에 기록됩니다.

global로 설정하면 --global 옵션을 설정한 것과 동일하게 동작합니다.

--json#

get 및 list가 모든 설정을 JSON 형식으로 표시하게 하고, set이 값을 JSON으로 파싱하게 합니다.