설정

pnpm 설정은 두 가지 범주로 나뉩니다:

  • 인증 및 인증서 설정은 INI 파일에 저장됩니다. 여기에는 민감한 자격 증명이 포함되어 있으므로 저장소에 커밋해서는 안 됩니다. 자세한 내용은 인증 설정을 참조하세요.
  • 기타 모든 설정은 YAML 파일에 저장됩니다: 프로젝트의 pnpm-workspace.yaml과 전역 config.yaml.

또한 pnpm은 더 이상 pnpm 필드에 있는 설정을 package.json에서 읽지 않습니다. 설정은 pnpm-workspace.yaml에 정의해야 합니다.

로컬 프로젝트 설정#

프로젝트 수준 설정은 pnpm-workspace.yaml에 작성합니다:

pnpm-workspace.yaml
nodeVersion: "22"
saveExact: true

전역 설정#

전역 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

환경 변수#

이름이 pnpm_config_(또는 PNPM_CONFIG_)로 시작하는 환경 변수가 설정으로 로드됩니다. 이 변수는 pnpm-workspace.yaml의 설정보다 우선하지만 CLI 인수보다는 우선하지 않습니다.

경고

pnpm은 더 이상 npm_config_* 환경 변수를 읽지 않습니다. 대신 pnpm_config_* 환경 변수를 사용하세요(예를 들어, pnpm_config_registry를 npm_config_registry 대신 사용).

예시:

pnpm_config_save_exact=true pnpm add foo

여러 하드 드라이브나 파일 시스템에서 pnpm을 사용해야 하는 경우, FAQ를 참고하세요.

설정 관리에 대한 자세한 내용은 config 명령을 참조하세요.