4.4 KiB
4.4 KiB
id, category, confidence_score, tags, last_reinforced, github_commit
| id | category | confidence_score | tags | last_reinforced | github_commit | |
|---|---|---|---|---|---|---|
| P-REINFORCE-AUTO-D0626D | 10_Wiki/💡 Topics/Programming & Language | 0.90 |
|
2026-04-20 | [P-Reinforce] Continuous Worker - lint-staged |
lint-staged
📌 한 줄 통찰 (The Karpathy Summary)
lint-staged는 Git의 커밋 전 단계(pre-commit)에서 스테이징된(staged) 파일들에 대해서만 린터(Linter)나 포매터(Formatter) 등의 특정 명령어를 실행하도록 도와주는 도구입니다 [1, 2]. 전체 코드베이스 대신 변경된 파일만 검사하므로 실행 시간을 대폭 단축시켜 줍니다 [2, 3]. 주로 Husky와 같은 Git 훅(Hook) 관리 도구와 함께 사용되어, 커밋 전에 코드의 품질을 검사하고 문제를 자동으로 수정하여 오류 없는 깔끔한 코드만 저장소에 반영되도록 보장합니다 [4, 5].
📖 구조화된 지식 (Synthesized Content)
-
핵심 기능 및 작동 방식:
lint-staged의 주요 역할은 스테이징된 파일 집합을 가져와 지정된 glob 패턴과 대조한 후, 일치하는 파일에 대해서만 명령어를 실행하는 것입니다 [6].- 기본적으로 수정된 파일의 절대 경로를 작업(task)에 전달하며, 작업을 병렬(concurrently)로 실행합니다 [7, 8].
- 코드를 보호하기 위해 작업을 실행하기 전 백업 스태시(stash)를 생성합니다 [9]. 작업(예: 자동 수정)이 성공적으로 완료되면 수정된 내용을 자동으로 다시 스테이징(re-stages) 처리하므로, 명령어에
git add를 수동으로 추가할 필요가 없습니다 [9, 10].
-
설정 및 파일 매칭:
package.json,.lintstagedrc, 또는 전용 자바스크립트 설정 파일(.js,.mjs,.cjs등)을 통해 설정할 수 있습니다 [11].- glob 매칭에는
micromatch를 사용하며, 슬래시가 없는 패턴은 위치에 상관없이 파일명과 매칭되고 슬래시가 포함된 패턴은 경로 매칭이 적용됩니다 [7]. - 단일 파일 세트에 대해 여러 명령어(예:
eslint --fix실행 후prettier --write실행)를 순차적으로 실행하려면 설정에서 배열(array) 구문을 사용하여, 여러 명령어가 동시에 동일한 파일을 수정하여 발생하는 경쟁 상태(Race condition)를 방지할 수 있습니다 [8, 12].
-
고급 설정 및 모노레포(Monorepo) 적용:
- 기본 glob-to-command 매핑이 충분하지 않은 경우, 동적으로 명령어를 구성하거나 파일 목록을 필터링할 수 있는 함수 기반(Function-based) 설정을 사용할 수 있습니다 [13].
- 모노레포 환경에 대한 공식적인 권장 사항은 저장소 루트에
lint-staged를 설치하고, 규칙이 다르게 적용되어야 하는 패키지마다 별도의 설정 파일을 두는 것입니다 [14].lint-staged는 스테이징된 파일과 가장 가까운 설정 파일을 사용하여 독립적으로 격리된 규칙을 적용합니다 [14]. - Turborepo와 같은 환경에서는 루트의 오케스트레이션(orchestration) 설정을 통해, 특정 파일 패턴을 각 패키지의 린팅 규칙과 매핑하여 작업 효율을 높이고 캐싱 기능을 극대화할 수 있습니다 [15-17].
⚠️ 모순 및 업데이트 (Contradictions & RL Update)
- 과거 데이터와의 충돌: 자동화 엔진에 의해 매핑된 지식으로, 추후 정밀 검증 필요.
- 정책 변화: Programming & Language 분야의 자동 자산화 수행.
🔗 지식 연결 (Graph)
- Related Topics: Husky, ESLint, Prettier, Git Hooks
- Projects/Contexts: CI/CD 파이프라인 자동화, 모노레포(Monorepo) 아키텍처 설정, Turborepo 환경 구성
- Contradictions/Notes: 소스에 따르면
lint-staged의 명령어 목록에git add를 수동으로 포함하는 것은 피해야 합니다. v10 이후부터는 여러 작업이 동일한 파일을 편집할 때 발생하는 경쟁 상태를 방지하기 위해 도구 자체가 수정 사항을 자동으로 스테이징 처리하기 때문입니다 [9, 18]. 또한, 전체 프로젝트를 검사하도록 설계된 도구(예:ng lint또는tsc --noEmit)를lint-staged를 통해 실행하는 것은 구조적으로 맞지 않으며 지양해야 한다고 명시되어 있습니다 [13, 18].
Last updated: 2026-04-18
- Raw Source: 00_Raw/2026-04-20/lint-staged.md