툴링난이도 쉬움⏱ 1~2시간
ESLint + Prettier에서 Biome로 마이그레이션
ESLint + Prettier→Biome
요약: Biome는 린터와 포매터를 하나의 빠른 도구(Rust 기반)로 통합합니다. ESLint+Prettier 두 설정·플러그인 충돌을 없애고 실행 속도를 크게 높입니다.
왜 옮기나
- ESLint+Prettier는 설정이 둘로 나뉘고 규칙 충돌·플러그인 관리가 번거롭습니다.
- Biome는 Rust 기반으로 린트·포맷이 매우 빠릅니다.
- 하나의 설정 파일·하나의 명령으로 통합됩니다.
전제 — 현재 상태
ESLint(.eslintrc) + Prettier(.prettierrc) + 다수 플러그인.
마이그레이션 단계
1
Biome 설치·초기화
Biome를 설치하고 설정을 생성합니다.
npm install -D @biomejs/biome
npx @biomejs/biome init2
기존 설정 마이그레이션
Biome가 일부 ESLint/Prettier 설정을 자동 변환해 줍니다.
npx @biomejs/biome migrate eslint --write
npx @biomejs/biome migrate prettier --write3
스크립트 교체
lint·format 스크립트를 Biome 명령으로 바꿉니다.
"lint": "biome check .",
"format": "biome format --write ."4
ESLint/Prettier 제거
동작 확인 후 기존 의존성과 설정 파일을 제거합니다.
npm uninstall eslint prettier eslint-config-prettier ...⚠️ 막히는 케이스 · 함정
- Biome는 아직 일부 ESLint 플러그인(특정 프레임워크 전용 규칙)을 100% 대체하지 못합니다 — 꼭 필요한 규칙이 있으면 ESLint를 일부 병행할지 검토하세요.
- 에디터 확장(Biome extension)으로 교체해야 저장 시 포맷이 동작합니다.
- CI에서 biome ci 명령으로 검사하도록 파이프라인을 갱신하세요.
✅ 검증: biome check가 통과하고, 저장 시 포맷·CI 검사가 기존과 동등하게 동작하는지 확인합니다.
BiomeESLintPrettier린터포매터