이 글에서 정리하는 내용
eslint.config.js로 바꾼 뒤 규칙이 안 먹는 문제는 대부분 flat config의 배열 순서, files 범위, ignores 위치, TypeScript parser 연결에서 생깁니다. extends 방식으로 생각하지 말고 어떤 객체가 어떤 파일에 적용되는지 먼저 확인해야 합니다.
- 내 증상이 이거면 여기부터 보세요
- 먼저 적용할 핵심 수정 코드
- 왜 이런 오류가 생기는가
- 실제 작업에서 점검하는 순서
- 그래도 안 될 때 볼 예외 케이스
- 다음에 같은 문제를 줄이는 체크리스트
내 증상이 이거면 여기부터 보세요
undefined
- eslint.config.js를 루트에 두었는지 확인합니다.
- ignores는 가능하면 ignores만 가진 객체로 분리합니다.
- TypeScript 파일은 files 범위와 parser 설정을 같이 확인합니다.
- 변경 뒤에는 eslint –print-config로 실제 적용 결과를 확인합니다.
결국 ESLint flat config 오류는 하나의 마법 같은 해결책보다 확인 순서가 더 중요합니다. 에러 문구를 단계별로 나누고, 설정 파일과 실행 명령을 같은 기준으로 맞추면 같은 문제를 훨씬 짧게 끝낼 수 있습니다.