6.1 KiB
id, title, category, status, canonical_id, aliases, duplicate_of, source_trust_level, confidence_score, tags, raw_sources, last_reinforced, github_commit, inferred_by, tech_stack
| id | title | category | status | canonical_id | aliases | duplicate_of | source_trust_level | confidence_score | tags | raw_sources | last_reinforced | github_commit | inferred_by | tech_stack | ||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| wiki-2026-0508-eslint | ESLint | 10_Wiki/Topics | needs_review | self |
|
none | A | 0.9 |
|
2026-04-20 | [P-Reinforce] Continuous Worker - ESLint | Claude Opus 4.7 (auto-normalize 2026-05-08) |
|
ESLint
📌 한 줄 통찰 (The Karpathy Summary)
ESLint는 자바스크립트 및 타입스크립트 코드에서 문법적 오류와 잠재적 버그를 식별하고 코딩 컨벤션을 강제하는 정적 분석 도구(Linter)입니다 [1, 2]. 소스 코드를 실행하지 않고 추상 구문 트리(AST)로 변환하여 사전에 정의된 논리 및 스타일 규칙을 적용함으로써 런타임 에러를 방지합니다 [3, 4]. 주로 코드 품질을 보장하고 팀 내 일관된 스타일을 유지하기 위해 사용되며, 코드 포매팅 도구인 Prettier와 함께 모던 웹 개발 환경의 필수적인 도구로 활용됩니다 [1, 5].
📖 구조화된 지식 (Synthesized Content)
-
정적 분석 및 코드 품질 관리 ESLint는 런타임 환경 이전에 소스 코드의 문제 패턴을 식별하는 정적 분석 도구입니다 [1, 6]. 사용되지 않는 변수, 글로벌 스코프 오염, 잘못된 API 사용 등 잠재적인 버그를 검출하고 코드 퀄리티 규칙을 강제하여 일관된 코드 작성을 돕습니다 [2, 7, 8]. 발견된 문제 중 특정 문법이나 스타일 위반은
--fix옵션을 통해 자동으로 수정(Auto-fixing)할 수 있습니다 [9-11]. -
설정 및 규칙 커스터마이징 ESLint의 규칙은
off(0),warn(1),error(2) 등 세 가지 수준으로 커스터마이징하여 적용할 수 있습니다 [12, 13]. 프로젝트별로.eslintrc파일이나 ESLint 9부터 도입된 Flat Config(예:eslint.config.mjs) 포맷을 통해 설정을 중앙화하고 관리할 수 있습니다 [14-16]. 주로 Airbnb나 Google 스타일 가이드처럼 널리 쓰이는 규칙을 확장(extends)하여 사용하며, TypeScript(@typescript-eslint), React(eslint-plugin-react) 등을 지원하는 다양한 서드파티 플러그인(plugins)을 장착할 수 있습니다 [17-19]. -
Prettier와의 역할 분담 및 충돌 해결 ESLint는 코드 품질(버그 탐지)에 초점을 맞추는 반면, Prettier는 코드 포매팅(시각적 통일성)에 중점을 둡니다 [2, 5, 20]. ESLint에도 일부 포매팅 규칙이 포함되어 있어 두 도구를 함께 사용할 경우 충돌이 발생할 수 있습니다 [21, 22]. 이를 해결하기 위해
[[eslint-config-prettier|eslint-config-prettier]]패키지를 사용하여 Prettier와 충돌하는 ESLint의 스타일 규칙을 비활성화(off)하는 방법이 가장 널리 권장됩니다 [21, 23-25]. -
워크플로우 및 자동화 연동 코드 변경 사항이 Git 저장소에 반영되기 전, 나쁜 코드가 커밋되는 것을 방지하기 위해 자동화 파이프라인과 결합하여 사용됩니다 [26, 27]. 주로
[[Husky|Husky]]와lint-staged도구를 활용하여, Git의pre-commit훅(hook) 단계에서 변경된(staged) 파일에 대해서만 ESLint 검사 및 자동 수정을 실행하도록 구성합니다 [11, 28-30]. 대규모 모노레포(Monorepo) 환경에서는 중복 구성을 피하기 위해 중앙집중식 ESLint 설정 패키지를 만들어 각 하위 패키지가 이를 공유하도록 구성하여 효율성을 극대화합니다 [15, 31, 32].
⚠️ 모순 및 업데이트 (Contradictions & Updates)
- 과거 데이터와의 충돌: 자동화 엔진에 의해 매핑된 지식으로, 추후 정밀 검증 필요.
- 정책 변화: Programming & Language 분야의 자동 자산화 수행.
🔗 지식 연결 (Graph)
- Related Topics: Prettier, Husky, lint-staged, 정적 분석(Static Analysis), AST(Abstract Syntax Tree)
- Projects/Contexts: 모노레포(Monorepo) 기반 구성 중앙화, Git Hook을 이용한 CI/CD 자동화 파이프라인
- Contradictions/Notes: 소스 [33]에서는
[[eslint-plugin-prettier|eslint-plugin-prettier]]사용 시 에디터에 밑줄이 너무 많이 생기고 느려져 문서에서도 추천하지 않는다며 설정을 삭제했다고 언급하지만, 소스 [25]에서는 Prettier의 포매팅 이슈를 ESLint의 린터 오류로 띄워 통합적으로 관리할 수 있는 효과적인 방식이라고 설명하는 등 개발자 또는 조직 간의eslint-plugin-prettier활용에 대해 엇갈린 평가 및 설정 선호도 차이가 존재합니다.
Last updated: 2026-04-18
🤖 LLM 활용 힌트 (How to Use This Knowledge)
언제 이 지식을 쓰는가:
- (TODO)
언제 쓰면 안 되는가:
- (TODO)
🧪 검증 상태 (Validation)
- 정보 상태: needs_review
- 출처 신뢰도: A
- 검토 이유: (P-Reinforce Phase 1 자동 정규화. 본문 검증 필요.)
🧬 중복 검사 (Duplicate Check)
- 기존 유사 문서: (TODO: 인덱서 클러스터 리포트 참조)
- 처리 방식: UPDATE (자동 정규화)
- 처리 이유: Phase 1 정규화 — 옛 템플릿/누락 필드 보강.
🕓 변경 이력 (Changelog)
| 날짜 | 변경 내용 | 처리 방식 | 신뢰도 |
|---|---|---|---|
| 2026-05-08 | P-Reinforce Phase 1 정규화 (frontmatter + 헤더 표준화) | UPDATE | A |
💻 코드 패턴 (Code Patterns)
패턴 1: (TODO: 이 프로젝트 컨벤션 반영한 구조 스켈레톤)
# TODO
🤔 의사결정 기준 (Decision Criteria)
선택 A를 써야 할 때:
- (TODO)
선택 B를 써야 할 때:
- (TODO)
기본값:
(TODO)
❌ 안티패턴 (Anti-Patterns)
- [안티패턴]: (TODO: 무엇을 하면 안 되는가 + 이유 + 대신 무엇을)