eslint

KO | EN

gitlite — search

#python #php #c-plus-plus #ruby #hacktoberfest #javascript #shell #library #bash #dotfiles #java #ssh

★ 27,457 Open GitHub ↗

JavaScript 코드의 문제를 찾아 수정하세요.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![npm version](https://img.shields.io/npm/v/eslint.svg)](https://www.npmjs.com/package/eslint)
[![Downloads](https://img.shields.io/npm/dm/eslint.svg)](https://www.npmjs.com/package/eslint)
[![Build Status](https://github.com/eslint/eslint/workflows/CI/badge.svg)](https://github.com/eslint/eslint/actions)
  
[![Open Collective Backers](https://img.shields.io/opencollective/backers/eslint)](https://opencollective.com/eslint)
[![Open Collective Sponsors](https://img.shields.io/opencollective/sponsors/eslint)](https://opencollective.com/eslint)
# ESLint
[Website](https://eslint.org) |
[Configure ESLint](https://eslint.org/docs/latest/use/configure) |
[Rules](https://eslint.org/docs/rules/) |
[Contribute to ESLint](https://eslint.org/docs/latest/contribute) |
[Report Bugs](https://eslint.org/docs/latest/contribute/report-bugs) |
[Code of Conduct](https://eslint.org/conduct) |
[X](https://x.com/geteslint) |
[Discord](https://eslint.org/chat) |
[Mastodon](https://fosstodon.org/@eslint) |
[Bluesky](https://bsky.app/profile/eslint.org)
ESLint는 ECMAScript/JavaScript 코드에서 발견되는 패턴을 식별하고 보고하기 위한 도구입니다. 여러 면에서 JSLint 및 JSHint와 유사하지만 몇 가지 차이점이 있습니다.
- ESLint는 JavaScript 파싱을 위해 [Espree](https://github.com/eslint/js/tree/main/packages/espree)를 사용합니다.
- ESLint는 AST를 사용하여 코드의 패턴을 평가합니다.
- ESLint는 완전히 플러그인 방식으로 작동하며, 모든 단일 규칙이 플러그인이고 런타임에 더 많은 규칙을 추가할 수 있습니다.
## 목차
1. [설치 및 사용법](#installation-and-usage)
1. [구성](#configuration)
1. [지원 버전](#version-support)
1. [행동 규범](#code-of-conduct)
1. [이슈 제기](#filing-issues)
1. [자주 묻는 질문](#frequently-asked-questions)
1. [릴리스](#releases)
1. [보안 정책](#security-policy)
1. [시맨틱 버저닝 정책](#semantic-versioning-policy)
1. [ESM 종속성](#esm-dependencies)
1. [라이선스](#license)
1. [팀](#team)
1. [후원자](#sponsors)
1. [기술 후원자](#technology-sponsors) 
## 설치 및 사용법
### 사전 요구 사항
ESLint를 사용하려면 SSL 및 ICU 지원으로 빌드된 [Node.js](https://nodejs.org/) (`^20.19.0`, `^22.13.0`, 또는 `>=24`)가 설치되어 있어야 합니다. (공식 Node.js 배포판을 사용하는 경우 SSL과 ICU가 항상 기본으로 빌드되어 있습니다.)
ESLint의 TypeScript 타입 정의를 사용하는 경우, TypeScript 5.3 이상이 필요합니다.
### npm 설치
다음 명령어를 사용하여 ESLint를 설치하고 구성할 수 있습니다:
```shell
npm init @eslint/config@latest
```
그 후, 다음과 같이 모든 파일이나 디렉토리에서 ESLint를 실행할 수 있습니다:
```shell
npx eslint yourfile.js
```
### pnpm 설치
pnpm과 함께 ESLint를 사용하려면 최소한 다음과 같은 설정이 포함된 `.npmrc` 파일을 설정하는 것이 좋습니다:
```text
auto-install-peers=true
node-linker=hoisted
```
이렇게 하면 pnpm이 npm과 더 호환되는 방식으로 종속성을 설치하며 오류가 발생할 가능성이 줄어듭니다.
## 구성
다음 예제와 같이 `eslint.config.js` 파일에서 규칙을 구성할 수 있습니다:
```js
import { defineConfig } from "eslint/config";
export default defineConfig([
{
files: ["\*\*/\*.js", "\*\*/\*.cjs", "\*\*/\*.mjs"],
rules: {
"prefer-const": "warn",
"no-constant-binary-expression": "error",
},
},
]);
```
`"prefer-const"` 및 `"no-constant-binary-expression"` 이름은 ESLint의 [규칙](https://eslint.org/docs/rules) 이름입니다. 첫 번째 값은 규칙의 오류 수준이며 다음 값 중 하나일 수 있습니다:
- `"off"` 또는 `0` - 규칙 끄기
- `"warn"` 또는 `1` - 규칙을 경고로 켜기 (종료 코드에 영향 없음)
- `"error"` 또는 `2` - 규칙을 오류로 켜기 (종료 코드가 1이 됨)
이 세 가지 오류 수준을 통해 ESLint가 규칙을 적용하는 방식을 세밀하게 제어할 수 있습니다(더 많은 구성 옵션과 세부 정보는 [구성 문서](https://eslint.org/docs/latest/use/configure) 참조).
## 지원 버전
ESLint 팀은 현재 버전에 대한 지속적인 지원을 제공하며, 이전 버전에 대해서는 6개월간의 제한된 지원을 제공합니다. 제한된 지원

rt는 치명적인 버그 수정, 보안 문제 및 호환성 문제만 포함합니다.
ESLint는 파트너사인 [Tidelift][tidelift] 및 [HeroDevs][herodevs]를 통해 현재 버전과 이전 버전 모두에 대해 상용 지원을 제공합니다.
자세한 내용은 [Version Support](https://eslint.org/version-support)를 참조하세요.
## Code of Conduct
ESLint는 [OpenJS Foundation Code of Conduct](https://eslint.org/conduct)를 준수합니다.
## Filing Issues
이슈를 제출하기 전에 보고하려는 내용에 대한 가이드라인을 반드시 읽어주세요.
- [Bug Report](https://eslint.org/docs/latest/contribute/report-bugs)
- [Propose a New Rule](https://eslint.org/docs/latest/contribute/propose-new-rule)
- [Proposing a Rule Change](https://eslint.org/docs/latest/contribute/propose-rule-change)
- [Request a Change](https://eslint.org/docs/latest/contribute/request-change)
## Frequently Asked Questions
### Does ESLint support JSX?
네, ESLint는 JSX 구문 파싱을 기본적으로 지원합니다([configuration](https://eslint.org/docs/latest/use/configure)에서 활성화해야 합니다). JSX 구문을 지원하는 것이 React를 지원하는 것과 \_동일하지 않다\_는 점에 유의하세요. React는 ESLint가 인식하지 못하는 특정 시맨틱을 JSX 구문에 적용합니다. React를 사용하고 있으며 React 시맨틱을 원한다면 [eslint-plugin-react](https://www.npmjs.com/package/eslint-plugin-react) 사용을 권장합니다.
### Does Prettier replace ESLint?
아니요, ESLint와 Prettier는 서로 다른 역할을 합니다. ESLint는 린터(문제가 있는 패턴을 찾음)이고 Prettier는 코드 포맷터입니다. 두 도구를 함께 사용하는 것은 일반적이며, 두 도구가 조화롭게 작동하도록 설정하는 방법은 [Prettier's documentation](https://prettier.io/docs/en/install#eslint-and-other-linters)을 참조하세요.
### What ECMAScript versions does ESLint support?
ESLint는 ECMAScript 3, 5 및 2015년부터 최신 stage 4 사양(기본값)까지 매년 출시된 버전을 완벽하게 지원합니다. 원하는 ECMAScript 구문 및 기타 설정(전역 변수 등)은 [configuration](https://eslint.org/docs/latest/use/configure)을 통해 설정할 수 있습니다.
### What about experimental features?
ESLint의 파서는 공식적으로 최신 최종 ECMAScript 표준만 지원합니다. (올바른 실험용 ESTree 구문을 사용하여 구현된 경우에 한해) stage 3 ECMAScript 구문 제안에서 충돌이 발생하는 것을 방지하기 위해 코어 규칙을 변경할 것입니다. 언어 확장(JSX, Flow, TypeScript 등)과 더 잘 연동되도록 하기 위해 사례별로 코어 규칙을 변경할 수도 있습니다.
다른 경우(단순히 충돌을 방지하는 것이 아니라 새로운 구문으로 인해 규칙이 더 많거나 적은 경우에 경고를 표시해야 하는 경우 포함)에는 다른 파서 및/또는 규칙 플러그인을 사용하는 것을 권장합니다. Babel을 사용하는 경우 [@babel/eslint-parser](https://www.npmjs.com/package/@babel/eslint-parser)와 [@babel/eslint-plugin](https://www.npmjs.com/package/@babel/eslint-plugin)을 사용하여 Babel에서 사용할 수 있는 모든 옵션을 활용할 수 있습니다.
언어 기능이 ECMAScript 표준에 채택되면([TC39 process](https://tc39.github.io/process-document/)에 따른 stage 4), [contributing guidelines](https://eslint.org/docs/latest/contribute)에 따라 새 기능과 관련된 이슈 및 풀 리퀘스트를 수락합니다. 그 전까지는 실험용 기능에 적합한 파서와 플러그인을 사용해 주세요.
### Which Node.js versions does ESLint support?
ESLint는 ESLint의 각 메이저 릴리스마다 지원되는 Node.js 버전을 업데이트합니다. 이때 ESLint가 지원하는 Node.js 버전은 다음과 같이 업데이트됩니다.
1. 가장 최근의 Node.js 유지보수 릴리스
1. ESLint 팀이 사용하고자 하는 기능이 포함된 Node.js LTS 릴리스의 가장 낮은 마이너 버전
1. Node.js Current 릴리스
또한 ESLint는 Node.js Current 릴리스 이후에 출시된 Node.js 버전에서도 작동할 것으로 기대됩니다.
특정 ESLint 릴리스에서 공식적으로 지원하는 Node.js 버전은 [Quick Start Guide](https://eslint.org/docs/latest/use/getting-started#prerequisites)를 참조하세요.
### Where to ask for help?
[discussion](https://github.com/eslint/eslint/)에 문의하세요.

discussions) 또는 [Discord server](https://eslint.org/chat)에 들러주세요.
### ESLint는 왜 의존성 버전을 잠그지 않나요?
`package-lock.json` 같은 잠금 파일(lock file)은 배포되는 애플리케이션에 유용합니다. 환경 간 및 배포 전반에 걸쳐 의존성이 일관되도록 보장해 줍니다.
npm 레지스트리에 배포되는 `eslint` 같은 패키지는 잠금 파일을 포함하지 않습니다. 사용자가 `npm install eslint`를 실행하면 ESLint의 `package.json`에 있는 버전 제약 조건을 따르게 됩니다. 사용자의 프로젝트에 잠금 파일이 있는 경우 ESLint와 그 의존성이 사용자의 잠금 파일에 포함되겠지만, ESLint 자체의 잠금 파일은 사용되지 않습니다.
사용자가 프로젝트에 ESLint를 설치할 때 얻게 되는 호환 가능한 최신 의존성 버전을 개발 및 CI 환경에서도 유지하기 위해, 우리는 의존성 버전을 의도적으로 잠그지 않습니다.
더 자세한 내용은 Twilio 블로그의 [심층 분석 글](https://www.twilio.com/blog/lockfiles-nodejs)에서 확인하실 수 있습니다.
## 릴리스
우리는 2주마다 금요일 또는 토요일에 정기 릴리스를 진행합니다. 특정 릴리스 일정에 대한 업데이트는 [릴리스 이슈](https://github.com/eslint/eslint/issues?q=is%3Aopen+is%3Aissue+label%3Arelease)를 팔로우하여 확인하실 수 있습니다.
## 보안 정책
ESLint는 보안을 매우 중요하게 생각합니다. 우리는 모든 사용자에게 ESLint가 안전하며, 보안 문제가 신속하고 책임감 있게 처리되도록 최선을 다하고 있습니다. 전체 [보안 정책](https://github.com/eslint/.github/blob/master/SECURITY.md)을 읽어보세요.
## 시맨틱 버저닝 정책
ESLint는 [시맨틱 버저닝](https://semver.org)을 따릅니다. 그러나 코드 품질 도구로서 ESLint의 특성상 마이너 버전이나 메이저 버전이 언제 올라가는지 항상 명확하지는 않습니다. 이를 명확히 하기 위해 ESLint는 다음과 같은 시맨틱 버저닝 정책을 정의했습니다.
- 패치 릴리스 (lint 빌드를 깨뜨리지 않도록 의도됨)
- ESLint가 보고하는 린트 에러 수를 줄이는 규칙의 버그 수정.
- CLI 또는 코어(포매터 포함)의 버그 수정.
- 문서 개선.
- 코드 리팩토링, 테스트 추가/삭제/수정, 테스트 커버리지 증가와 같은 사용자 비노출 변경 사항.
- 실패한 릴리스 이후의 재릴리스(예: 누구에게도 제대로 작동하지 않는 릴리스를 다시 배포하는 경우).
- 마이너 릴리스 (lint 빌드를 깨뜨릴 수도 있음)
- ESLint가 보고하는 린트 에러 수를 늘리는 버그 수정 (예: 코어 규칙의 거짓 음성(false negative) 수정, 또는 이전에 잘못 건너뛰었던 추가 파일 린트).
- 새로운 규칙 생성.
- 기본적으로 ESLint가 더 많은 린트 에러를 보고하게 만들지 않는, 기존 규칙에 대한 새로운 옵션.
- 기본적으로 ESLint가 더 많은 린트 에러를 보고하게 만드는, 새로 추가된 언어 기능(최근 12개월 이내)을 지원하기 위한 기존 규칙의 새로운 추가 사항.
- 기존 규칙의 지원 중단(deprecated).
- 새로운 CLI 기능 생성.
- 공개 API에 새로운 기능 추가 (새로운 클래스, 새로운 메서드, 기존 메서드에 대한 새로운 인자 등).
- 새로운 포매터 생성.
- `eslint:recommended`가 업데이트되어 결과적으로 린트 에러가 엄격하게 줄어드는 경우 (예: 규칙 제거).
- 메이저 릴리스 (lint 빌드를 깨뜨릴 가능성이 높음)
- `eslint:recommended`가 업데이트되어 새로운 린트 에러가 발생할 수 있는 경우 (예: 규칙 추가, 대부분의 규칙 옵션 업데이트).
- 기본적으로 ESLint가 더 많은 린트 에러를 보고하게 만드는, 기존 규칙에 대한 새로운 옵션.
- 기존 포매터 제거.
- 공개 API의 일부가 호환되지 않는 방식으로 제거되거나 변경되는 경우. 공개 API에는 다음이 포함됩니다:
- 규칙 스키마
- 설정 스키마
- 명령줄 옵션
- Node.js API
- 규칙, 포매터, 파서, 플러그인 API
정책에 따라 모든 마이너 업데이트는 이전 릴리스보다 더 많은 린트 에러를 보고할 수 있습니다 (예: 버그 수정으로 인해). 따라서 빌드 결과를 보장하기 위해 `package.json`에서 예: `"eslint": "~3.1.0"`과 같이 틸드(`~`)를 사용하는 것을 권장합니다.
## ESM 의존성
ESLint는 CommonJS 패키지이므로, ESM 전용 패키지를 의존성으로 사용할 수 있는 제한이 있습니다.
ESLint 팀이 관리하고 외부 의존성이 없는 패키지는 안전합니다

[`require(esm)`](https://nodejs.org/api/modules.html#loading-ecmascript-modules-using-require)을 사용하여 동기식으로 로드되므로 모든 컨텍스트에서 사용됩니다.
외부 패키지의 경우, 패키지가 최상위 수준의 `await`을 추가하여 ESLint를 중단시킬 수 있으므로 `require(esm)`을 사용하지 않습니다. 외부 ESM 전용 패키지는 비동기 코드에서만 필요한 경우에만 사용할 수 있으며, 이 경우 동적 `import()`를 사용하여 로드할 수 있습니다.
이러한 정책은 `eslint-config-eslint`와 같이 자체 용도로만 사용하려는 패키지에는 적용되지 않습니다.

## License
MIT License
Copyright OpenJS Foundation and other contributors,

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.

## Team
이 사람들은 프로젝트를 계속 진행시키며 도움을 주는 리소스입니다.

### 기술 운영위원회 (TSC - Technical Steering Committee)
릴리스를 관리하고, 기능 요청을 검토하며, ESLint가 적절히 유지보수되도록 정기적으로 모이는 사람들입니다.

|  |  |  |
| --- | --- | --- |
| [Nicholas C. Zakas's Avatar  Nicholas C. Zakas](https://github.com/nzakas) | [Francesco Trotta's Avatar  Francesco Trotta](https://github.com/fasttime) | [Milos Djermanovic's Avatar  Milos Djermanovic](https://github.com/mdjermanovic) |

### 검토자 (Reviewers)
새로운 기능을 검토하고 구현하는 사람들입니다.

|  |  |
| --- | --- |
| [唯然's Avatar  唯然](https://github.com/aladdin-add) | [Nitin Kumar's Avatar  Nitin Kumar](https://github.com/snitin315) |

### 커미터 (Committers)
버그를 검토 및 수정하고 이슈 분류(triage)를 돕는 사람들입니다.

|  |  |  |  |  |
| --- | --- | --- | --- | --- |
| [fnx's Avatar  fnx](https://github.com/DMartens) | [Sweta Tanwar's Avatar  Sweta Tanwar](https://github.com/SwetaTanwar) | [Tanuj Kanti's Avatar  Tanuj Kanti](https://github.com/Tanujkanti4441) | [lumir's Avatar  lumir](https://github.com/lumirlumir) | [Pixel's Avatar  Pixel](https://github.com/Pixel998) |

### 웹사이트 팀 (Website Team)
eslint.org에 특히 집중하는 팀 멤버들입니다.

|  |  |  |
| --- | --- | --- |
| [Amaresh  S M's Avatar  Amaresh S M](https://github.com/amareshsm) | [Harish's Avatar  Harish](https://github.com/harish-sethuraman) | [Percy Ma's Avatar  Percy Ma](https://github.com/kecrily) |

## 스폰서 (Sponsors)
다음 기업, 단체, 개인들이 ESLint의 지속적인 유지보수와 개발을 지원하고 있습니다. README와 [웹사이트](https://eslint.org/sponsors)에 로고를 올리려면 [스폰서 되기](https://eslint.org/donate)를 참고해 주세요.

### 플래티넘 스폰서 (Platinum Sponsors)

[![Automattic](https://images.opencollective.com/automattic/d0ef3e1/logo.png)](https://automattic.com)

### 골드 스폰서 (Gold Sponsors)

[![Qlty Software](https://images.opencollective.com/qltysh/33d157d/logo.png)](https://qlty.sh/) [![Shopify](https://avatars.githubusercontent.com/u/8085)](https://shopify.engineering/) [![CodeRabbit](https://avatars.githubusercontent.com/u/132028505)](https://www.coderabbit.ai/?utm_source=cr_org&utm_medium=github)

### 실버 스폰서 (Silver Sponsors)

[![Vite](https://images.opencollective.com/vite/d472863/logo.png)](https://vite.dev/) [![Liftoff](https://images.opencollective.com/liftoff/2d6c3b6/logo.png)](https://liftoff.io/) [![StackBlitz](https://avatars.githubusercontent.com/u/28635252)](https://stackblitz.com)

### 브론즈 스폰서 (Bronze Sponsors)

[![Cybozu](https://images.opencollective.com/cybozu/933e46d/logo.png)](https://cybozu.co.jp/) [![SAP](https://avatars.githubusercontent.com/u/2531208)](https://opensource.sap.com) [![Syntax](https://github.com/syntaxfm.png)](https://syntax.fm) [![Icons8](https://images.opencollective.com/icons8/7fa1641/logo.png)](https://icons8.com/) [![Discord](https://images.opencollective.com/discordapp/f9645d9/logo.png)](https://discord.com) [![GitBook](https://avatars.githubusercontent.com/u/7111340)](https://www.gitbook.com) [![Citadel AI](https://avatars.githubusercontent.com/u/75781367)](https://citadel-ai.com) [![TestMu AI Open Source Office (Formerly LambdaTest)](https://avatars.githubusercontent.com/u/171592363)](https://www.testmuai.com)

### 기술 스폰서 (Technology Sponsors)

기술 스폰서는 오픈소스 생태계와 우리의 작업에 대한 기여의 일환으로 그들의 제품과 서비스를 무료로 사용할 수 있도록 지원합니다.

[![Netlify](https://raw.githubusercontent.com/eslint/eslint.org/main/src/assets/images/techsponsors/netlify-icon.svg)](https://netlify.com) [![Algolia](https://raw.githubusercontent.com/eslint/eslint.org/main/src/assets/images/techsponsors/algolia-icon.svg)](https://algolia.com) [![1Password](https://raw.githubusercontent.com/eslint/eslint.org/main/src/assets/images/techsponsors/1password-icon.svg)](https://1password.com)

[tidelift]: https://tidelift.com/funding/github/npm/eslint
[herodevs]: https://www.herodevs.com/support/eslint-nes?utm\_source=ESLintWebsite&utm\_medium=ESLintWebsite&utm\_campaign=ESLintNES&utm\_id=ESLintNES

eslint

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README