RETROSPECTIVE · 회고
CI에서 eslint가 'could not find plugin react-hooks'로 멈춘 이유
etc
push했더니 CI의 lint 단계가 빨간불이었다. 경고 몇 개가 아니라 lint가 아예 돌지 못하고 멈췄다. 오류는 'react-hooks 플러그인을 찾을 수 없다'였다. 플러그인은 설치돼 있었고 설정도 그대로였다.
설정 구조
eslint 설정(flat config)은 eslint-config-next를 펼쳐 넣고, 그 뒤에 규칙 몇 개를 바꾸는 객체를 하나 더 붙인 모양이었다.
export default [
...nextConfig, // react-hooks 등 플러그인 등록
{
rules: { /* react-hooks 규칙 조정 */ },
},
];
eslint-config-next 안에서 플러그인을 등록하는 객체는 files: ["**/*.{js,jsx,mjs,ts,tsx,mts,cts}"]로 범위가 정해져 있다. 그런데 뒤에 붙인 규칙 객체에는 files가 없다. flat config에서 files가 없는 객체는 eslint가 검사하는 모든 파일에 적용된다.
무엇이 바뀌었나
이번 커밋에 .cjs 스크립트가 하나 들어갔다. eslint는 .cjs를 기본으로 검사한다. 그런데 위 glob에는 cjs가 없다. 그 파일 입장에서는 규칙 객체는 적용되는데 플러그인 등록은 적용되지 않는다. 설정된 규칙의 플러그인이 없는 건 eslint에서 경고가 아니라 설정 오류라서, 파일 하나 때문에 lint 전체가 멈췄다.
고친 것
- 규칙 객체에도 같은
filesglob을 붙였다. 플러그인이 등록되는 범위와 규칙이 적용되는 범위를 맞췄다. - 레포 안에 두고 쓰는 로컬 작업 폴더를
ignores에 넣었다.
const SRC = "**/*.{js,jsx,mjs,ts,tsx,mts,cts}";
export default [
...nextConfig,
{ files: [SRC], rules: { /* … */ } },
{ ignores: ["<로컬 작업 폴더>/**"] },
];
배운 점
- flat config에서
files없는 객체는 '모든 파일'이다. 규칙을 덮는 객체는 그 규칙의 플러그인이 등록된 범위와 같은 범위를 가져야 한다. - 설정을 안 건드려도 새 확장자의 파일 하나가 들어오면 깨질 수 있다. 설정이 어떤 파일까지 다루는지도 코드처럼 봐야 한다.