# Chokidar - 효율적인 크로스플랫폼 파일 Watch 라이브러리

> Clean Markdown view of GeekNews topic #25522. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=25522](https://news.hada.io/topic?id=25522)
- GeekNews Markdown: [https://news.hada.io/topic/25522.md](https://news.hada.io/topic/25522.md)
- Type: news
- Author: [xguru](https://news.hada.io/@xguru)
- Published: 2026-01-03T09:31:01+09:00
- Updated: 2026-01-03T09:31:01+09:00
- Original source: [github.com/paulmillr](https://github.com/paulmillr/chokidar)
- Points: 11
- Comments: 0

## Summary

**Chokidar**는 OS별로 제각각인 파일 변경 이벤트를 **정규화**해 일관된 인터페이스로 제공하는 Node.js용 파일 감시 라이브러리입니다. `fs.watch` 기반의 비폴링 구조로 낮은 CPU 사용량을 유지하면서도, atomic write나 chunked write 같은 복잡한 쓰기 패턴을 실제 완료 시점 기준으로 안정적으로 감지합니다. v5부터 ESM 전용 패키지로 전환되며 Node.js 20 이상을 요구하고, CLI 도구와 함께 빌드·자동화 워크플로 전반에서 폭넓게 활용되고 있습니다.

## Topic Body

- 다양한 OS에서 발생하는 파일 변경 이벤트를 **정규화**해 일관된 방식으로 전달하기 위해 개발된 도구로, fs.watch 계열 API의 한계를 보완  
- 맥·리눅스·윈도의 이벤트 차이를 흡수해 **add / change / unlink 중심의 명확한 이벤트 모델** 제공  
- 일부 에디터가 사용하는 **atomic write 패턴**과 대용량 파일의 **chunked write**를 안정적으로 감지하도록 설계하여 실제 쓰기 완료 시점 기준 이벤트 처리  
- 기본적으로 `fs.watch` 기반 비폴링 구조를 사용해 **낮은 CPU 사용량** 유지  
  - 네트워크 파일 시스템 등 특수 환경에서는 polling 모드 전환 지원  
- 파일·디렉터리 필터링, 심볼릭 링크 추적, **항상 재귀 감시 지원** 등 실무 환경에서 필요한 기능을 기본 제공  
- v5부터 **ESM 전용 패키지**로 전환되고, 최소 Node.js 버전이 **v20 이상**으로 상향  
- HTML 빌드 도구인 [Brunch](https://brunch.github.io/) 용으로 2012년에 시작된 이후 현재 약 3천만 개의 리포지토리에서 사용되는 **검증된 프로덕션 라이브러리**로 자리잡음  
- CLI 도구인 `chokidar-cli` 등 생태계 확장을 통해 빌드·자동화·개발 워크플로에 폭넓게 활용 가능

## Comments



_No public comments on this page._