.yarnrc와 yarnrc.yml 설정파일

깃 충돌 해결하고 커밋하려니 문제가 생겼다.

> git -c user.useConfigOnly=true commit --quiet --allow-empty-message --file -
.husky/pre-commit: line 4: yarn: command not found
husky - pre-commit hook exited with code 127 (error)
husky - command not found in PATH=/Applications/Xcode.app/Contents/Developer/usr/libexec/git-core:/usr/bin:/bin:/usr/sbin:/sbin

😭

• yarn 제거하고 다시 설치
• corepack 설치
• .husky/pre-commit 코드 수정
• yarn 버전 업그레이드

등등 계속 했더니 점점 이상해졌다.

.yarnrc파일과 .yarnrc.yml 파일이 자동으로 추가되었다.

그냥 깔끔히 밀어버리고 다시 레포받아서 yarn 문제 이전 브랜치에서 브랜치 따서 작업했다.

원인은 yarn 버전이 너무 낮았던 것으로 추정되는데, 업그레이드하는 과정에서 내가 이것저것 아무거나 시도하느라 꼬인 듯하다.

---

yarnrc, yarnrc.yml이 생성된 이유

.yarnrc 랑 yarn.yml 이 뭘까?

yarn v.1은 .yarnrc 파일을, yarn v.2부터는 yarnrc.yml 를 생성한다.

✅ Yarn 1 (1.22.7)

• 설정 파일: .yarnrc
• 기본적으로 텍스트 형식의 설정 파일 사용

registry "https://registry.yarnpkg.com"
cache-folder "./.yarn-cache"

단순한 키-값 설정 방식

✅ Yarn 2 이상 (Yarn 4 포함)

• 설정 파일이 .yarnrc.yml로 변경됨
• YAML 형식 사용, 더 구조적인 설정 가능

yarnPath: ".yarn/releases/yarn-4.0.0.cjs"
nodeLinker: "node-modules"
npmRegistryServer: "https://registry.yarnpkg.com"

• .yarnrc.yml이 .yarnrc를 대체하면서 더 많은 설정이 가능해짐
• nodeLinker, plugins, packageExtensions 같은 추가 설정 가능

🔹 왜 두 개의 설정 파일이 생겼을까?

1. 기존 Yarn 1.x의 .yarnrc 유지

• 이전 버전에서 사용하던 .yarnrc 파일이 남아 있는 것
• 호환성을 위해 그대로 유지됨

2. Yarn 4의 새로운 .yarnrc.yml 추가

• Yarn 4는 .yarnrc.yml을 기본 설정 파일로 사용
• 업그레이드 과정에서 자동 생성됨

👉 내가 yarn을 최신버전으로 업그레이드하면서 생기게 됨.

🔹 결론

👉 Yarn 4를 사용할 거라면?

• 기존 .yarnrc 파일을 삭제하고, .yarnrc.yml만 유지
• .yarnrc.yml에서 필요한 설정을 직접 수정

👉 Yarn 1과 4를 혼용해야 한다면?

• .yarnrc는 기존 프로젝트와의 호환성을 위해 남겨두되,
• .yarnrc.yml에서 새로운 설정을 관리하는 방식으로 사용 가능

👉 업그레이드 취소하고 Yarn 1을 그대로 쓰려면?

• .yarnrc.yml은 Yarn4 업그레이드 과정에서 자동 생성, Yarn1에서 인식하지 않으므로 삭제해도 영향 없음

• ⚠️ yarnrc 설정파일 확인하기 ⚠️
  기존에 .yarnrc에 커스텀 설정(예: registry, cache-folder, network-timeout 등)이 있었다면, 삭제하면 설정이 초기화됨
  만약 설정 유지할 필요없다면 삭제해도 됨

🔹 Yarn 1로 되돌리는 과정

1. Yarn 4 제거

npm uninstall -g yarn

2. Yarn 1 재설치

npm install -g yarn@1.22.7

(원하는 버전 지정 가능)

3. Yarn 버전 확인

yarn -v