ESLint v10 — eslintrc의 시대가 끝났다

.eslintrc, 이제 진짜 안 된다

ESLint v9에서 flat config가 기본이 됐을 때, .eslintrc는 "권장하지 않음" 상태였다. v10에서는 완전히 제거됐다. .eslintrc.json, .eslintrc.js, .eslintignore 파일이 프로젝트에 있어도 ESLint가 읽지 않는다. 비유하면 구형 열쇠가 아예 자물쇠에 안 맞게 된 것이다.

npm install eslint@10 --save-dev

제거된 것들

v10에서 사라진 레거시 목록이 길다. 한눈에 정리하면 이렇다.

아직 .eslintrc를 쓰고 있다면, 더 이상 미룰 수 없다. ESLint 공식 마이그레이션 가이드의 config 변환 도구를 활용하면 된다.

npx @eslint/migrate-config .eslintrc.json

[💡 잠깐! 이 용어는?] Flat Config: ESLint v9부터 도입된 새로운 설정 형식이다. eslint.config.js 파일에 배열로 설정을 정의하며, extends 체이닝 대신 스프레드 연산자로 합성한다. 설정의 흐름이 위에서 아래로 직관적이어서 "flat(평탄한)"이라는 이름이 붙었다.

설정 탐색 방식의 변화

v10에서 가장 실질적인 변화다. 이전에는 ESLint가 eslint.config.js를 **현재 작업 디렉토리(cwd)**에서 찾았다. v10부터는 린트 대상 파일의 디렉토리에서 위로 올라가며 찾는다.

monorepo/
├── eslint.config.js          ← 루트 설정
├── packages/
│   ├── web/
│   │   ├── eslint.config.js  ← web 전용 설정
│   │   └── src/
│   │       └── App.tsx       ← 이 파일은 web/eslint.config.js 적용
│   └── api/
│       └── src/
│           └── index.ts      ← 이 파일은 루트 eslint.config.js 적용

모노레포에서 각 패키지마다 다른 린트 규칙을 적용하고 싶었다면, 이전에는 설정 안에서 files 패턴으로 분기해야 했다. 이제는 각 패키지에 eslint.config.js를 두면 자동으로 해당 설정이 적용된다. 각 방이 자기 조명을 갖는 것과 같다.

주의할 점이 있다. v9에서 --flag v10_config_lookup_from_file 플래그로 이 동작을 미리 써본 경우, v10에서는 해당 플래그를 제거해야 한다. 이제 기본 동작이니까.

JSX 참조 추적

React 프로젝트에서 골치 아팠던 문제가 해결됐다. v9까지는 JSX에서 컴포넌트를 사용해도 ESLint의 스코프 분석이 이를 "참조"로 인식하지 못했다.

import { Card } from "./card.jsx"
 
export function createCard(name: string) {
  return <Card name={name} />
}

v9에서는 Card가 사용되었는데도 no-unused-vars 규칙이 "Card is defined but never used"라고 경고했다. 그래서 eslint-plugin-react의 jsx-uses-vars 같은 워크어라운드 플러그인이 필요했다.

v10부터는 ESLint 코어가 JSX 식별자를 참조로 추적한다. <Card>를 만나면 Card 변수가 사용된 것으로 인식한다. 반대로, 정의되지 않은 컴포넌트를 JSX에서 쓰면 no-undef가 정상적으로 잡아낸다.

import react from "eslint-plugin-react"
 
export default [
  {
    plugins: { react },
    rules: {
      // v10에서는 더 이상 필요 없다
      // "react/jsx-uses-vars": "error",  ← 제거
    }
  }
]

eslint:recommended 업데이트

eslint:recommended에 3개의 규칙이 새로 추가됐다.

기존 프로젝트에서 v10으로 올리면 이 규칙들 때문에 새로운 에러가 나올 수 있다. 당장 수정이 어렵다면 config에서 "off"로 끄면 된다.

import js from "@eslint/js"
 
export default [
  js.configs.recommended,
  {
    rules: {
      "no-unassigned-vars": "off",
      "no-useless-assignment": "off",
      "preserve-caught-error": "off"
    }
  }
]

플러그인 개발자가 알아야 할 것

커스텀 룰을 만들어 쓰는 팀이라면, 제거된 API를 교체해야 한다.

자동 변환 도구가 제공된다.

npx eslint-transforms v9-rule-migration ./rules/

[💡 잠깐! 이 용어는?] RuleTester: ESLint 규칙의 동작을 검증하는 테스트 유틸리티다. 유효한 코드(valid)와 규칙을 위반하는 코드(invalid)를 각각 정의하고, 규칙이 올바르게 보고하는지 확인한다. v10에서는 테스트 케이스 작성 요건이 더 엄격해졌다.

Node.js 버전 요구사항

홀수 버전(v21, v23)은 Node.js의 비LTS 릴리스라 ESLint가 지원을 끊었다. CI에서 Node 버전을 확인하고, 필요하면 올려야 한다.

마이그레이션 체크리스트

v10으로 올릴 때 순서대로 확인할 항목이다.

• Node.js v20.19.0 이상으로 업그레이드
• .eslintrc.* → eslint.config.js로 전환 (아직 안 했다면)
• .eslintignore 삭제, config의 ignores로 이동
• 코드 내 /* eslint-env */ 주석 전부 제거
• JSX 워크어라운드 플러그인 규칙 제거 (jsx-uses-vars 등)
• eslint:recommended 신규 규칙 에러 처리
• 커스텀 룰에서 deprecated API 교체
• CI의 --flag v10_config_lookup_from_file 플래그 제거
• jiti 사용 시 v2.2.0 이상으로 업데이트

마무리

ESLint v10은 2~3년에 걸친 flat config 전환의 마침표다. .eslintrc가 완전히 사라지고, 설정 탐색이 파일 기반으로 바뀌면서 모노레포 지원이 자연스러워졌다. JSX 참조 추적이 코어에 들어온 것은 React 생태계에 소소하지만 확실한 개선이다.

• 당장 할 일: .eslintrc → eslint.config.js 전환, Node.js 버전 확인
• React 프로젝트: JSX 워크어라운드 플러그인 정리
• 모노레포: 패키지별 eslint.config.js 배치 검토
• 플러그인 개발: deprecated API 교체

한 마디로, 미뤄왔던 설정 정리를 할 시간이다.

참고:

• ESLint v10.0.0 릴리스 공지: https://eslint.org/blog/2026/02/eslint-v10.0.0-released/
• ESLint v10 마이그레이션 가이드: https://eslint.org/docs/latest/use/migrate-to-10.0.0
• Flat Config 소개: https://eslint.org/docs/latest/use/configure/configuration-files