KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #developer-tools #cli #codex #claude-code #react #dsh-plugin #mcp #open-source #dsh #deepseek-harness

standard

★ 29,427 Open GitHub ↗

🌟 linter 및 자동 코드 수정 기능이 포함된 JavaScript 스타일 가이드

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">
  <a href="https://standardjs.com"><img src="https://cdn.rawgit.com/standard/standard/master/sticker.svg" alt="Standard - JavaScript Style Guide" width="200"></a>
  <br>
  JavaScript Standard Style
  <br>
  <br>
</h1>

<h5 align="center">
  Sponsored by&nbsp;&nbsp;&nbsp;&nbsp;<a href="https://socket.dev"><img src="https://cdn.rawgit.com/standard/standard/master/docs/logos/socket.png" alt="Socket – Supply Chain Dependency Security for JavaScript and npm" height=50 valign="middle"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="https://wormhole.app/?utm_medium=sponsorship&utm_source=standard&utm_campaign=feross"><img src="https://cdn.rawgit.com/standard/standard/master/docs/logos/wormhole.png" alt="Wormhole" height=50 valign="middle"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="https://serpapi.com/"><img src="https://cdn.rawgit.com/standard/standard/master/docs/logos/serpapi.png" height=35 valign="middle"></a>
</h5>

<p align="center">
  <a href="/docs/README-en.md">English</a> •
  <a href="/docs/README-esla.md">Español (Latinoamérica)</a> •
  <a href="/docs/README-fr.md">Français</a> •
  <a href="/docs/README-id.md">Bahasa Indonesia</a> •
  <a href="/docs/README-iteu.md">Italiano (Italian)</a> •
  <a href="/docs/README-ja.md">日本語 (Japanese)</a> •
  <a href="/docs/README-kokr.md">한국어 (Korean)</a> •
  <a href="/docs/README-ptbr.md">Português (Brasil)</a> •
  <a href="/docs/README-zhcn.md">简体中文 (Simplified Chinese)</a> •
  <a href="/docs/README-zhtw.md">繁體中文 (Taiwanese Mandarin)</a>
</p>

## JavaScript 스타일 가이드, linter 및 formatter

이 모듈은 다음과 같은 세 가지 방식으로 당신(그리고 다른 사람들!)의 시간을 절약해 줍니다:

- **설정이 필요 없습니다.** 프로젝트에서 코드 품질을 강제하는 가장 쉬운 방법입니다. 결정할 필요도 없고, 관리해야 할 `.eslintrc` 파일도 없습니다. 그냥 바로 작동합니다.
- **코드를 자동으로 포맷팅합니다.** `standard --fix`를 실행하기만 하면 지저분하거나 일관성 없는 코드와 작별할 수 있습니다.
- **스타일 문제와 프로그래머의 실수를 조기에 발견합니다.** 리뷰어와 기여자 사이의 불필요한 의견 교환을 없애 소중한 코드 리뷰 시간을 절약하세요.

지금 바로 `npx standard --fix`를 실행하여 체험해 보세요!

## 목차

- 빠른 시작
  - [설치](#install)
  - [사용법](#usage)
  - [더 효율적으로 사용하는 방법](#what-you-might-do-if-youre-clever)
- 자주 묻는 질문(FAQ)
  - [왜 JavaScript Standard Style을 사용해야 하나요?](#why-should-i-use-javascript-standard-style)
  - [누가 JavaScript Standard Style을 사용하나요?](#who-uses-javascript-standard-style)
  - [텍스트 에디터 플러그인이 있나요?](#are-there-text-editor-plugins)
  - [README 배지가 있나요?](#is-there-a-readme-badge)
  - [규칙 X에 동의하지 않습니다. 변경해 주실 수 있나요?](#i-disagree-with-rule-x-can-you-change-it)
  - [하지만 이건 진짜 웹 표준이 아니잖아요!](#but-this-isnt-a-real-web-standard)
  - [자동 포맷터가 있나요?](#is-there-an-automatic-formatter)
  - [파일을 어떻게 무시하나요?](#how-do-i-ignore-files)
  - [규칙을 어떻게 비활성화하나요?](#how-do-i-disable-a-rule)
  - [전역 네임스페이스를 오염시키는 라이브러리를 사용합니다. "variable is not defined" 에러를 어떻게 방지하나요?](#i-use-a-library-that-pollutes-the-global-namespace-how-do-i-prevent-variable-is-not-defined-errors)
  - [실험적인 JavaScript (ES Next) 기능을 어떻게 사용하나요?](#how-do-i-use-experimental-javascript-es-next-features)
  - [Flow나 TypeScript 같은 JavaScript 언어 변형을 사용할 수 있나요?](#can-i-use-a-javascript-language-variant-like-flow-or-typescript)
  - [Mocha, Jest, Jasmine, QUnit 등은 어떻게 하나요?](#what-about-mocha-jest-jasmine-qunit-etc)
  - [Web Workers와 Service Workers는 어떻게 하나요?](#what-about-web-workers-and-service-workers)
  - [경고(warning)와 에러(error)의 차이점은 무엇인가요?](#what-is-the-difference-between-warnings-and-errors)
  - [Markdown이나 HTML 파일 내부의 코드를 검사할 수 있나요?](#can-i-check-code-inside-of-markdown-or-html-files)
  - [Git `pre-commit` 훅이 있나요?](#is-there-a-git-pre-commit-hook)
  - [출력 결과를 어떻게 알록달록하고 예쁘게 만드나요?](#how-do-i-make-the-output-all-colorful-and-pretty)
  - [Node.js API가 있나요?](#is-there-a-nodejs-api)
  - [StandardJS에 어떻게 기여하나요?](#how-do-i-contribute-to-standardjs)

## Install

JavaScript Standard Style을 사용하는 가장 쉬운 방법은 Node 커맨드 라인 프로그램으로 전역 설치하는 것입니다. 터미널에서 다음 명령어를 실행하세요:

```bash
$ npm install standard --global
```

또는, 단일 프로젝트에서 사용하기 위해 `standard`를 로컬에 설치할 수도 있습니다:

```bash
$ npm install standard --save-dev
```

_참고: 위의 명령어를 실행하려면 [Node.js](http://nodejs.org)와 [npm](https://npmjs.com)이 설치되어 있어야 합니다._

## Usage

`standard`를 설치한 후에는 `standard` 프로그램을 사용할 수 있습니다. 가장 간단한 사용 사례는 현재 작업 디렉토리의 모든 JavaScript 파일 스타일을 검사하는 것입니다:

```bash
$ standard
Error: Use JavaScript Standard Style
  lib/torrent.js:950:11: Expected '===' and instead saw '=='.
```

`standard`를 로컬에 설치했다면 대신 `npx`로 실행하세요:

```bash
$ npx standard
```

선택적으로 glob 패턴을 사용하여 디렉토리(또는 여러 디렉토리)를 전달할 수 있습니다. glob 패턴이 포함된 경로는 셸이 아닌 `standard`에서 확장되도록 반드시 따옴표로 감싸주세요:

```bash
$ standard "src/util/**/*.js" "test/**/*.js"
```

**참고:** 기본적으로 `standard`는 다음 패턴과 일치하는 모든 파일을 찾습니다:
`**/*.js`, `**/*.jsx`.

## What you might do if you're clever

1. `package.json`에 추가하기

```json
   {
     "name": "my-cool-package",
     "devDependencies": {
       "standard": "*"
     },
     "scripts": {
       "test": "standard && node my-tests.js"
     }
   }
   ```

2. `npm test`를 실행할 때 스타일이 자동으로 검사됩니다.

```bash
   $ npm test
   Error: Use JavaScript Standard Style
     lib/torrent.js:950:11: Expected '===' and instead saw '=='.
   ```

3. 더 이상 pull request에서 스타일 피드백을 줄 필요가 없습니다!

## Why should I use JavaScript Standard Style?

JavaScript Standard Style의 매력은 단순함에 있습니다. 작업하는 모든 모듈/프로젝트마다 수백 줄짜리 스타일 설정 파일을 관리하고 싶은 사람은 아무도 없습니다. 이런 미친 짓은 이제 그만하십시오!

이 모듈은 다음과 같은 세 가지 방식으로 당신(그리고 다른 사람들!)의 시간을 절약해 줍니다:

- **설정이 필요 없습니다.** 프로젝트에서 일관된 스타일을 강제하는 가장 쉬운 방법입니다. 그냥 도입하기만 하세요.
- **코드를 자동으로 포맷팅합니다.** `standard --fix`를 실행하기만 하면 지저분하거나 일관성 없는 코드와 작별할 수 있습니다.
- **스타일 문제와 프로그래머의 실수를 조기에 발견합니다.** 리뷰어와 기여자 사이의 불필요한 의견 교환을 없애 소중한 코드 리뷰 시간을 절약하세요.

`standard` 스타일을 채택한다는 것은 코드의 명확성과 커뮤니티 컨벤션을 개인의 스타일보다 더 중요하게 생각한다는 것을 의미합니다. 이것이 모든 프로젝트와 개발 문화에 맞는 것은 아니겠지만, 오픈 소스는 초보자에게 불친절한 곳일 수 있습니다. 명확하고 자동화된 기여자 기대치를 설정하면 프로젝트가 더 건강해집니다.

더 자세한 정보는 컨퍼런스 강연 ["Write Perfect Code with Standard and ESLint"](https://www.youtube.com/watch?v=kuHfMw8j4xk)를 참고하세요. 이 강연에서는 linting, `standard`와 `eslint` 중 언제 무엇을 사용해야 하는지, 그리고 `prettier`가 `standard`와 어떻게 다른지에 대해 배울 수 있습니다.

## Who uses JavaScript Standard Style?

| [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/nodejs.png>](https://nodejs.org) | [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/npm.png>](https://www.npmjs.com) | [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/github.png>](https://github.com) | [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/wormhole.png>](https://wormhole.app) |
| --------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |

| [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/express.png>](http://expressjs.com) | [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/electron.png>](http://electron.atom.io) | [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/nuxtjs.png>](https://nuxtjs.org/) | [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/elastic.png>](https://www.elastic.co) |
| ------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |

| [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/mongodb.jpg>](https://www.mongodb.com) | [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/zendesk.png>](https://www.zendesk.com) | [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/brave.png>](https://www.brave.com) | [<img width=190 src=https://assets.vercel.com/image/upload/v1621541666/front/assets/logotype-black-on-white.png>](https://vercel.com) |
| --------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |

| [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/socket.png>](https://socket.dev) | [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/nearform.png>](http://www.nearform.com) | [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/typeform.png>](https://www.typeform.com) | [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/gov-uk.png>](https://gds.blog.gov.uk) |
| --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |

| [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/heroku.png>](https://www.heroku.com) | [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/saucelabs.png>](https://saucelabs.com) | [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/automattic.png>](https://automattic.com) | [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/godaddy.png>](https://www.godaddy.com) |
| ------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |

| [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/webtorrent.png>](https://webtorrent.io) | [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/ipfs.png>](https://ipfs.io) | [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/dat.png>](https://datproject.org) | [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/bitcoinjs.png>](https://bitcoinjs.org) |
| ---------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |

| [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/voltra.png>](https://voltra.co) | [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/treasuredata.png>](https://www.treasuredata.com) | [<img alt="Free MIDIs, MIDI file downloads" width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/bitmidi.png>](https://bitmidi.com) | [<img width=190 alt="College essays, AP notes" src=https://cdn.rawgit.com/standard/standard/master/docs/logos/studynotes.jpg>](https://www.apstudynotes.org) |
| -------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |

| [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/optiopay.png>](https://www.optiopay.com) | [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/jaguar-landrover.png>](https://www.jlrtechincubator.com/jlrti/) | [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/bustle.jpg>](https://www.bustle.com) | [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/zentrick.png>](https://www.zentrick.com) |
| ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |

| [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/greenkeeper.png>](https://greenkeeper.io) | [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/karma.png>](https://karma-runner.github.io) | [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/taser.png>](https://www.taser.com) | [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/neo4j.png>](https://www.neo4j.com) |
| ------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |

| [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/rentograph.png>](https://rentograph.com) | [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/eaze.png>](https://www.eaze.com) | [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/ctrl-alt-deseat.png>](https://www.ctrlaltdeseat.com) | [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/clevertech.png>](https://clevertech.biz) |
| ----------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |

| [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/aragon.png>](https://aragon.org) | [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/flowsent.png>](https://www.flowsent.com) | [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/puma-browser.png>](https://www.pumabrowser.com/) | [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/webstorm.png>](https://www.jetbrains.com/webstorm/) |
| --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |

| [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/fastify.png>](https://www.fastify.io) | [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/scuttlebutt.png>](https://www.scuttlebutt.nz) | [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/solid.png>](https://solid.inrupt.com) | [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/grab.png>](https://www.grab.com) |
| -------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |

| [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/jublia.png>](https://jublia.com/) | [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/atom.png>](https://atom.io) | [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/peek.png>](https://www.peek.com) | [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/dotenv.png>](https://www.dotenv.org) |
| ---------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |

| [<img width=190 src=https://cdn.rawgit.com/standard/standard/master/docs/logos/nodesource.png>](https://nodesource.com) | Your Logo Here |     |     |
| ----------------------------------------------------------------------------------------------------------------------- | -------------- | --- | --- |

기업 외에도 너무 많아서 이곳에 모두 나열할 수 없을 정도로 많은 커뮤니티 멤버들이 패키지에 `standard`를 사용하고 있습니다.

`standard`는 또한 GitHub의 [Clean Code Linter](https://github.com/showcases/clean-code-linters) 쇼케이스에서 가장 많은 별을 받은 linter이기도 합니다.

## Are there text editor plugins?

먼저 `standard`를 설치하세요. 그 다음, 사용하는 에디터에 맞는 플러그인을 설치하세요:

### Sublime Text

**[Package Control][sublime-1]**을 사용하여 **[SublimeLinter][sublime-2]**와 **[SublimeLinter-contrib-standard][sublime-3]**를 설치하세요.

저장 시 자동 포맷팅을 위해 **[StandardFormat][sublime-4]**을 설치하세요.

[sublime-1]: https://packagecontrol.io/
[sublime-2]: http://www.sublimelinter.com/en/latest/
[sublime-3]: https://packagecontrol.io/packages/SublimeLinter-contrib-standard
[sublime-4]: https://packagecontrol.io/packages/StandardFormat

### Atom

**[linter-js-standard][atom-1]**를 설치하세요.

또는 **[linter-js-standard-engine][atom-4]**를 설치할 수도 있습니다. 이 플러그인은 `standard` 버전을 내장하는 대신 현재 프로젝트에 설치된 버전을 자동으로 사용합니다. 또한 **[standard-engine][atom-5]** 기반의 다른 linter들과도 즉시 연동됩니다.

자동 포맷팅을 위해 **[standard-formatter][atom-2]**를, 스니펫을 위해 **[standardjs-snippets][atom-3]**를 설치하세요.

[atom-1]: https://atom.io/packages/linter-js-standard
[atom-2]: https://atom.io/packages/standard-formatter
[atom-3]: https://atom.io/packages/standardjs-snippets
[atom-4]: https://atom.io/packages/linter-js-standard-engine
[atom-5]: https://github.com/standard/standard-engine

### Visual Studio Code

**[vscode-standard][vscode-1]**를 설치하세요. (자동 포맷팅 지원 포함)

JS 스니펫을 위해 **[vscode-standardjs-snippets][vscode-2]**를, React 스니펫을 위해 **[vscode-react-standard][vscode-3]**를 설치하세요.

[vscode-1]: https://marketplace.visualstudio.com/items?itemName=standard.vscode-standard
[vscode-2]: https://marketplace.visualstudio.com/items?itemName=capaj.vscode-standardjs-snippets
[vscode-3]: https://marketplace.visualstudio.com/items?itemName=TimonVS.ReactSnippetsStandard

### Vim

**[ale][vim-1]**를 설치하고 `.vimrc` 파일에 다음 줄을 추가하세요.

```vim
let g:ale_linters = {
\   'javascript': ['standard'],
\}
let g:ale_fixers = {'javascript': ['standard']}
```

이렇게 하면 javascript 파일에 대해 `standard`를 유일한 linter 및 fixer로 설정하여 eslint와의 충돌을 방지합니다. 저장 시 린팅 및 자동 수정을 위해 `.vimrc`에 다음 줄을 추가하세요:

```vim
let g:ale_lint_on_save = 1
let g:ale_fix_on_save = 1
```

고려해 볼 만한 다른 플러그인으로는 [neomake][vim-2]와 [syntastic][vim-3]가 있으며, 두 플러그인 모두 `standard`를 기본적으로 지원합니다 (단, 설정이 필요할 수 있습니다).

[vim-1]: https://github.com/w0rp/ale
[vim-2]: https://github.com/neomake/neomake
[vim-3]: https://github.com/vim-syntastic/syntastic

### Emacs

**[Flycheck][emacs-1]**를 설치하고 **[매뉴얼][emacs-2]**을 확인하여 프로젝트에서 어떻게 활성화하는지 알아보세요.

[emacs-1]: http://www.flycheck.org
[emacs-2]: http://www.flycheck.org/en/latest/user/installation.html

### Brackets

확장 레지스트리에서 **["Standard Code Style"][brackets-1]**을 검색하고 "Install"을 클릭하세요.

[brackets-1]: https://github.com/ishamf/brackets-standard/

### WebStorm (PhpStorm, IntelliJ, RubyMine, JetBrains, etc.)

WebStorm은 최근 IDE에서 `standard`를 직접 지원하는 [네이티브 기능을 발표](https://blog.jetbrains.com/webstorm/2017/01/webstorm-2017-1-eap-171-2272/)했습니다.

여전히 `standard`를 수동으로 설정하는 것을 선호하신다면, [이 가이드][webstorm-1]를 따르세요. 이는 PhpStorm, IntelliJ, RubyMine 등을 포함한 모든 JetBrains 제품에 적용됩니다.

[webstorm-1]: docs/webstorm.md

## Is there a readme badge?

네! 프로젝트에서 `standard`를 사용한다면, README에 다음 배지 중 하나를 추가하여 코드가 standard 스타일을 사용하고 있음을 알릴 수 있습니다.

[![JavaScript Style Guide](https://cdn.rawgit.com/standard/standard/master/badge.svg)](https://github.com/standard/standard)

```md
[![JavaScript Style Guide](https://cdn.rawgit.com/standard/standard/master/badge.svg)](https://github.com/standard/standard)
```

[![JavaScript Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://standardjs.com)

```md
[![JavaScript Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://standardjs.com)
```

## I disagree with rule X, can you change it?

아니요. `standard`의 핵심은 코드 스타일에 대한 [소모적인 논쟁(bikeshedding)][bikeshedding]을 피함으로써 시간을 절약하는 것입니다. 온라인에는 탭 vs 스페이스 등 결코 해결되지 않을 논쟁이 많습니다. 이러한 논쟁은 정작 중요한 일을 처리하는 데 방해가 될 뿐입니다. 결국에는 '그냥 하나를 선택'해야 하며, 그것이 바로 `standard`의 철학입니다. 즉, 합리적인 '그냥 선택된' 의견들의 모음입니다. 사용자들이 자신의 의견을 고집하기보다 여기서 가치를 찾기를 바랍니다.

`standard`를 완전히 수용하고 싶지 않은 분들을 위해 몇 가지 유사한 패키지가 있습니다:

- [semistandard](https://github.com/standard/semistandard) - 세미콜론을 사용하는 standard
- [standardx](https://github.com/standard/standardx) - 커스텀 수정 사항이 적용된 standard

수백 개의 ESLint 규칙을 개별적으로 설정하고 싶다면, [eslint-config-standard](https://github.com/standard/eslint-config-standard)와 함께 `eslint`를 직접 사용하여 변경 사항을 추가할 수 있습니다.
[`standard-eject`](https://github.com/josephfrazier/standard-eject)를 사용하면 `standard`에서 `eslint` 및 `eslint-config-standard`로 마이그레이션할 수 있습니다.

꿀팁: 그냥 `standard`를 사용하고 다음 단계로 넘어가세요. 당신의 시간을 들여 해결해야 할 진짜 실제 문제들이 세상엔 많으니까요! :P

[bikeshedding]: https://docs.freebsd.org/en/books/faq/#bikeshed-painting

## But this isn't a real web standard!

당연히 아닙니다! 여기서 제시하는 스타일은 어떤 공식 웹 표준 그룹과도 관련이 없으며, 그렇기 때문에 이 저장소의 이름이 `ECMA/standard`가 아니라 `standard/standard`인 것입니다.

'standard'라는 단어는 '웹 표준' 외에도 더 많은 의미를 가지고 있습니다 :-) 예를 들어:

- 이 모듈은 우리 코드가 높은 _품질 표준(standard of quality)_을 유지하도록 돕습니다.
- 이 모듈은 새로운 기여자들이 기본적인 _스타일 표준(style standards)_을 따르도록 보장합니다.

## Is there an automatic formatter?

네! `standard --fix`를 사용하여 대부분의 문제를 자동으로 수정할 수 있습니다.

최대한의 편의를 위해 `standard --fix`는 `standard`에 내장되어 있습니다. 대부분의 문제는 수정 가능하지만, 일부 에러(예: 에러 처리 누락)는 수동으로 수정해야 합니다.

시간을 절약하기 위해, `standard`는 자동으로 수정 가능한 문제를 발견하면 "`Run standard --fix to automatically fix some problems`"라는 메시지를 출력합니다.

## How do I ignore files?

특정 경로(`node_modules/`, `coverage/`, `vendor/`, `*.min.js` 및 `.git/`과 같이 `.`으로 시작하는 파일/폴더)는 자동으로 무시됩니다.

프로젝트 루트의 `.gitignore` 파일에 있는 경로 또한 자동으로 무시됩니다.

때로는 추가 폴더나 특정 압축 파일을 무시해야 할 때가 있습니다. 이를 위해 `package.json`에 `standard.ignore` 속성을 추가하세요:

```json
"standard": {
  "ignore": [
    "**/out/",
    "/lib/select2/",
    "/lib/ckeditor/",
    "tmp.js"
  ]
}
```

## How do I disable a rule?

드문 경우지만, 규칙을 어겨야 하고 `standard`가 생성하는 에러를 숨겨야 할 때가 있습니다.

JavaScript Standard Style은 내부적으로 [ESLint](http://eslint.org/)를 사용하므로, ESLint를 직접 사용할 때와 동일한 방식으로 에러를 숨길 수 있습니다.

특정 라인의 **모든 규칙** 비활성화:

```js
file = "I know what I am doing"; // eslint-disable-line
```

또는, `"no-use-before-define"` 규칙**만** 비활성화:

```js
file = "I know what I am doing"; // eslint-disable-line no-use-before-define
```

또는, **여러 라인**에 대해 `"no-use-before-define"` 규칙 비활성화:

```js
/* eslint-disable no-use-before-define */
console.log("offending code goes here...");
console.log("offending code goes here...");
console.log("offending code goes here...");
/* eslint-enable no-use-before-define */
```

## I use a library that pollutes the global namespace. How do I prevent "variable is not defined" errors?

일부 패키지(예: `mocha`)는 함수(`describe`, `it` 등)를 전역 객체에 배치합니다 (좋지 않은 방식이죠!). 이러한 함수들은 코드 어디에서도 정의되거나 `require`되지 않았기 때문에, `standard`는 정의되지 않은 변수를 사용하고 있다고 경고합니다 (보통 이 규칙은 오타를 잡는 데 매우 유용합니다!). 하지만 이러한 전역 변수들에 대해서는 이 규칙을 비활성화하고 싶을 것입니다.

`standard`(와 코드를 읽는 사람)에게 특정 변수가 코드 내에서 전역 변수임을 알리려면, 파일 상단에 다음을 추가하세요:

```js
/* global myVar1, myVar2 */
```

파일이 수백 개라면 모든 파일에 주석을 추가하는 것은 비효율적일 수 있습니다. 이 경우 다음을 실행하세요:

```bash
$ standard --global myVar1 --global myVar2
```

또는 `package.json`에 다음을 추가하세요:

```json
{
  "standard": {
    "globals": ["myVar1", "myVar2"]
  }
}
```

_참고: `global`과 `globals`는 동일하게 작동합니다._

## How do I use experimental JavaScript (ES Next) features?

`standard`는 제안 프로세스의 'Stage 4'에 있는 언어 기능 제안을 포함하여 최신 ECMAScript 기능인 ES8 (ES2017)을 지원합니다.

실험적인 언어 기능을 지원하기 위해 `standard`는 커스텀 JavaScript 파서를 지정하는 기능을 제공합니다. 커스텀 파서를 사용하기 전에, 추가되는 복잡성이 그만한 가치가 있는지 고려해 보세요.

커스텀 파서를 사용하려면 먼저 npm에서 설치하세요:

```bash
npm install @babel/eslint-parser --save-dev
```

그런 다음 실행하세요:

```bash
$ standard --parser @babel/eslint-parser
```

또는 `package.json`에 다음을 추가하세요:

```json
{
  "standard": {
    "parser": "@babel/eslint-parser"
  }
}
```

## Can I use a JavaScript language variant, like Flow or TypeScript?

`standard`는 최신 ECMAScript 기능을 지원합니다. 하지만 Flow와 TypeScript는 언어에 새로운 문법을 추가하므로 기본적으로는 지원되지 않습니다.

TypeScript의 경우, `standard`와 매우 유사한 경험을 제공하는 공식 변형 버전인 `ts-standard`가 지원 및 유지 관리되고 있습니다.

다른 JavaScript 언어 변형의 경우, `standard`는 변경된 문법을 처리하기 위해 커스텀 JavaScript 파서와 ESLint 플러그인을 지정하는 것을 지원합니다. 언어 변형을 사용하기 전에 추가되는 복잡성이 그만한 가치가 있는지 고려해 보세요.

### TypeScript

[`ts-standard`](https://github.com/standard/ts-standard)는 TypeScript를 위해 공식적으로 지원되는 변형 버전입니다. `ts-standard`는 `standard`와 동일한 모든 규칙과 옵션을 지원하며, TypeScript 전용 규칙을 추가로 포함합니다. `ts-standard`는 `tsconfig.json` 설정을 통해 일반 `javascript` 파일까지 린팅할 수 있습니다.

```bash
npm install ts-standard --save-dev
```

그런 다음 실행하세요 (`tsconfig.json`이 작업 디렉토리에 있는 경우):

```bash
$ ts-standard
```

또는 `package.json`에 다음을 추가하세요:

```json
{
  "ts-standard": {
    "project": "./tsconfig.json"
  }
}
```

_참고: 테스트 파일과 같은 추가 파일을 린팅에 포함하려면 대신 `tsconfig.eslint.json` 파일을 생성하여 사용하세요._

수백 개의 ESLint 규칙을 개별적으로 설정하고 싶다면, [`eslint-config-standard-with-typescript`](https://github.com/standard/eslint-config-standard-with-typescript)와 함께 eslint를 직접 사용하여 변경 사항을 추가할 수 있습니다.

### Flow

Flow를 사용하려면 파서로 `@babel/eslint-parser`를, 플러그인으로 `eslint-plugin-flowtype`을 사용하여 `standard`를 실행해야 합니다.

```bash
npm install @babel/eslint-parser eslint-plugin-flowtype --save-dev
```

그런 다음 실행하세요:

```bash
$ standard --parser @babel/eslint-parser --plugin flowtype
```

또는 `package.json`에 다음을 추가하세요:

```json
{
  "standard": {
    "parser": "@babel/eslint-parser",
    "plugins": ["flowtype"]
  }
}
```

_참고: `plugin`과 `plugins`는 동일하게 작동합니다._

## What about Mocha, Jest, Jasmine, QUnit, etc?

테스트 파일에서 mocha를 지원하려면 테스트 파일 상단에 다음을 추가하세요:

```js
/* eslint-env mocha */
```

또는 다음을 실행하세요:

```bash
$ standard --env mocha
```

여기서 `mocha`는 `jest`, `jasmine`, `qunit`, `phantomjs` 등으로 대체될 수 있습니다. 전체 목록은 ESLint의 [specifying environments](https://eslint.org/docs/latest/use/configure/language-options#specifying-environments) 문서를 확인하세요. 이러한 환경에서 사용 가능한 전역 변수 목록은 [globals](https://github.com/sindresorhus/globals/blob/master/globals.json) npm 모듈을 확인하세요.

_참고: `env`와 `envs`는 동일하게 작동합니다._

## What about Web Workers and Service Workers?

web worker 파일 상단에 다음을 추가하세요:

```js
/* eslint-env worker */
```

이렇게 하면 `standard`(와 코드를 읽는 사람)에게 web worker 코드에서 `self`가 전역 변수임을 알릴 수 있습니다.

Service worker의 경우에는 대신 다음을 추가하세요:

```js
/* eslint-env serviceworker */
```

## What is the difference between warnings and errors?

`standard`는 모든 규칙 위반을 에러로 처리하며, 이는 `standard`가 0이 아닌(에러) 종료 코드로 종료됨을 의미합니다.

하지만 가끔 대다수의 `standard` 사용자에게 영향을 주는 규칙을 변경하는 새로운 메이저 버전을 출시할 수 있습니다 (예: `var`에서 `let`/`const`로 전환). 이는 이점이 비용보다 크다고 판단될 때, 그리고 해당 규칙이 [자동 수정 가능](#is-there-an-automatic-formatter)할 때만 수행합니다.

이런 경우, 규칙 변경 사항이 '경고(warning)'로만 표시되는 '전환 기간'을 둡니다. 경고는 `standard`가 0이 아닌 종료 코드를 반환하게 하지 않습니다. 하지만 경고 메시지는 여전히 콘솔에 출력됩니다. 전환 기간 동안 `standard --fix`를 사용하면 다음 메이저 버전을 준비할 수 있도록 코드가 업데이트됩니다.

천천히 그리고 신중하게 접근하는 것이 `standard`가 추구하는 방향입니다. 우리는 일반적으로 새로운 언어 기능의 사용을 강제하는 데 매우 보수적입니다. `standard` 사용이 가볍고 즐겁기를 바라기에, 방해가 될 수 있는 변경 사항을 만드는 데 신중을 기하고 있습니다. 언제나 그렇듯, 필요한 경우 언제든지 [규칙을 비활성화](#how-do-i-disable-a-rule)할 수 있습니다.

## Can I check code inside of Markdown or HTML files?

Markdown 파일 내부의 코드를 검사하려면 [`standard-markdown`](https://www.npmjs.com/package/standard-markdown)을 사용하세요.

또는 Markdown, HTML 및 여러 다른 유형의 언어 파일 내부의 코드를 검사할 수 있는 ESLint 플러그인이 있습니다:

Markdown 파일 내부의 코드를 검사하려면 ESLint 플러그인을 사용하세요:

```bash
$ npm install eslint-plugin-markdown
```

그런 다음 코드 블록 내에 나타나는 JS를 검사하려면 다음을 실행하세요:

```bash
$ standard --plugin markdown '**/*.md'
```

HTML 파일 내부의 코드를 검사하려면 ESLint 플러그인을 사용하세요:

```bash
$ npm install eslint-plugin-html
```

그런 다음 `<script>` 태그 내에 나타나는 JS를 검사하려면 다음을 실행하세요:

```bash
$ standard --plugin html '**/*.html'
```

## Is there a Git `pre-commit` hook?

네! 훅(Hook)은 스타일이 적용되지 않은 코드가 저장소에 들어오는 것을 방지하는 아주 좋은 방법입니다. 더 이상 pull request에서 스타일 피드백을 줄 필요가 없습니다!

선택지가 있습니다...

### 직접 훅 설치하기

```bash
#!/bin/bash

# Ensure all JavaScript files staged for commit pass standard code style
function xargs-r() {
  # Portable version of "xargs -r". The -r flag is a GNU extension that
  # prevents xargs from running if there are no input files.
  if IFS= read -r -d $'\n' path; then
    echo "$path" | cat - | xargs "$@"
  fi
}
git diff --name-only --cached --relative | grep '\.jsx\?$' | sed 's/[^[:alnum:]]/\\&/g' | xargs-r -E '' -t standard
if [[ $? -ne 0 ]]; then
  echo 'JavaScript Standard Style errors were detected. Aborting commit.'
  exit 1
fi
```

### `pre-commit` 훅 사용하기

[pre-commit](https://pre-commit.com/) 라이브러리를 사용하면 저장소의 `.pre-commit-config.yaml` 설정 파일 내에 훅을 선언할 수 있어 팀 전체에서 더 쉽게 유지 관리할 수 있습니다.

pre-commit 사용자는 `.pre-commit-config.yaml` 파일에 `standard`를 추가하기만 하면 `.js`, `.jsx`, `.mjs`, `.cjs` 파일을 자동으로 수정할 수 있습니다:

```yaml
- repo: https://github.com/standard/standard
  rev: master
  hooks:
    - id: standard
```

또는 더 고급 스타일 설정을 위해 eslint 훅 내에서 `standard`를 사용하세요:

```yaml
- repo: https://github.com/pre-commit/mirrors-eslint
  rev: master
  hooks:
    - id: eslint
      files: \.[jt]sx?$ # *.js, *.jsx, *.ts and *.tsx
      types: [file]
      additional_dependencies:
        - eslint@latest
        - eslint-config-standard@latest
        # and whatever other plugins...
```

## How do I make the output all colorful and pretty?

기본 출력은 단순하고 명료하지만, 더 화려한 것을 좋아하신다면 [snazzy](https://www.npmjs.com/package/snazzy)를 설치하세요:

```bash
$ npm install snazzy
```

그런 다음 실행하세요:

```bash
$ standard | snazzy
```

또한 [standard-tap](https://www.npmjs.com/package/standard-tap), [standard-json](https://www.npmjs.com/package/standard-json), [standard-reporter](https://www.npmjs.com/package/standard-reporter), [standard-summary](https://www.npmjs.com/package/standard-summary)도 있습니다.

## Is there a Node.js API?

네!

### `async standard.lintText(text, [opts])`

제공된 소스 `text`를 린팅합니다. `opts` 객체를 제공할 수 있습니다:

```js
{
  // unique to lintText
  filename: '',         // path of file containing the text being linted

// common to lintText and lintFiles
  cwd: '',              // current working directory (default: process.cwd())
  fix: false,           // automatically fix problems
  extensions: [],       // file extensions to lint (has sane defaults)
  globals: [],          // custom global variables to declare
  plugins: [],          // custom eslint plugins
  envs: [],             // custom eslint environment
  parser: '',           // custom js parser (e.g. babel-eslint)
  usePackageJson: true, // use options from nearest package.json?
  useGitIgnore: true    // use file ignore patterns from .gitignore?
}
```

모든 옵션은 선택 사항이지만, 일부 ESLint 플러그인은 `filename` 옵션이 필요합니다.

현재 작업 디렉토리에서 `package.json`이 발견되면 추가 옵션이 로드될 수 있습니다. 자세한 내용은 아래를 참조하세요.

결과(`results`)를 반환하거나 에러(`Error`)로 거부되는 `Promise`를 반환합니다.

`results` 객체는 다음 속성을 포함합니다:

```js
const results = {
  results: [
    {
      filePath: "",
      messages: [{ ruleId: "", message: "", line: 0, column: 0 }],
      errorCount: 0,
      warningCount: 0,
      output: "", // fixed source code (only present with {fix: true} option)
    },
  ],
  errorCount: 0,
  warningCount: 0,
};
```

### `async standard.lintFiles(files, [opts])`

제공된 `files` glob을 린팅합니다. `opts` 객체를 제공할 수 있습니다:

```js
{
  // unique to lintFiles
  ignore: [],           // file globs to ignore (has sane defaults)

현재 작업 디렉토리에서 `package.json`이 발견되면 추가 옵션이 로드될 수 있습니다. 자세한 내용은 아래를 참조하세요.

`ignore`와 `files` 패턴 모두 현재 작업 디렉토리를 기준으로 해석됩니다.

결과(`results`)를 반환하거나 에러(`Error`)로 거부되는 `Promise`를 반환합니다 (위와 동일).

## How do I contribute to StandardJS?

기여를 환영합니다! [issues](https://github.com/standard/standard/issues)나 [PRs](https://github.com/standard/standard/pulls)를 확인하고, 원하는 내용이 없다면 직접 만들어 주세요.

이야기를 나누고 싶으신가요? [Discord에서 기여자들과 함께하세요](https://discord.gg/Jxjejujpmc).

다음은 `standard` 생태계의 중요한 패키지들입니다:

- **[standard](https://github.com/standard/standard)** - 이 저장소
  - **[standard-engine](https://github.com/standard/standard-engine)** - 임의의 eslint 규칙을 위한 cli 엔진
  - **[eslint-config-standard](https://github.com/standard/eslint-config-standard)** - standard를 위한 eslint 규칙
  - **[eslint-config-standard-jsx](https://github.com/standard/eslint-config-standard-jsx)** - standard (JSX)를 위한 eslint 규칙
  - **[eslint](https://github.com/eslint/eslint)** - standard를 구동하는 linter
- **[snazzy](https://github.com/standard/snazzy)** - standard를 위한 예쁜 터미널 출력
- **[standard-www](https://github.com/standard/standard-www)** - https://standardjs.com 의 코드
- **[semistandard](https://github.com/standard/semistandard)** - 세미콜론을 사용하는 standard (꼭 필요하시다면)
- **[standardx](https://github.com/standard/standardx)** - 커스텀 수정 사항이 적용된 standard

또한 많은 **[에디터 플러그인](#are-there-text-editor-plugins)**, **[`standard`를 사용하는 npm 패키지 목록](https://github.com/standard/standard-packages)**, 그리고 **[`standard` 생태계의 멋진 패키지 목록](https://github.com/standard/awesome-standard)**이 있습니다.

## Security Policies and Procedures

`standard` 팀과 커뮤니티는 `standard`의 모든 보안 버그를 진지하게 다룹니다. 이슈 보고 방법은 [보안 정책 및 절차](https://github.com/standard/.github/blob/master/SECURITY.md) 문서를 참조하세요.

## License

[MIT](LICENSE). Copyright (c) [Feross Aboukhadijeh](https://feross.org).

standard

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README