콘텐츠로 이동

CLI

Biome의 공식 CLI입니다. 프로젝트 상태를 확인하거나 개별 파일을 검사하기 위해 사용할 수 있습니다.

사용법: biome COMANDO ...

사용 가능한 옵션:

  • -h, --help — 도움말 정보 출력
  • -V, --version — 버전 정보 출력

사용 가능한 명령어:

  • version — Biome의 버전 정보를 표시합니다.
  • rage — 디버깅을 위한 정보를 출력합니다.
  • start — Biome의 서버 덱몬 프로세스를 시작합니다.
  • stop — Biome의 서버 덱몬 프로세스를 중단합니다.
  • check — 지정된 파일들에 대해 포맷터, 린터 및 임포트 정렬을 실행합니다.
  • lint — 일련의 파일에 여러 가지 검사를 실행합니다.
  • format — 일련의 파일에 대해 포맷터를 실행합니다.
  • ci — CI 환경에서 사용하는 명령어입니다. 지정된 파일들에 대해 포맷터, 린터 및 임포트 정렬을 실행합니다.
  • init — 새로운 Biome 프로젝트를 생성합니다. 기본값을 포함한 설정 파일을 생성합니다.
  • lsp-proxy — stdin/stdout을 통해 언어 서버 프로토콜의 서버 역할을 수행합니다.
  • migrate — 최종 변경 시 설정을 업데이트합니다.
  • search — 실험적: 프로젝트 내에서 Grit 패턴을 검색합니다.
  • explain — CLI의 다양한 측면에 대한 문서를 표시합니다.
  • clean — 덱몬이 생성한 로그를 삭제합니다.

Biome의 버전 정보를 표시합니다.

사용법: biome version

모든 명령어에 적용되는 전역 옵션

  • --colors=<off|force> — 마크업 포맷팅 모드 설정: “off”는 모든 내용을 일반 텍스트로 출력하며, “force”는 출력 콘솔이 호환되지 않는 것으로 판단되더라도 ANSI를 사용하여 마크업을 강제 포맷팅합니다.

  • --use-server — 실행 중인 Biome 덱몬 서버 인스턴스에 연결합니다.

  • --verbose — 추가 진단 정보를 출력하고, 일부 진단은 더 많은 정보를 표시합니다. 또한 처리된 파일과 수정된 파일 목록도 출력합니다.

  • --config-path=PATH — 설정 파일 경로 또는 biome.json 또는 biome.jsonc를 찾기 위한 디렉터리 경로를 설정합니다. 이 값을 사용하면 기본 설정 파일 해결 기능이 비활성화됩니다.

  • --max-diagnostics=<none|<NUMBER>> — 표시되는 진단 수를 제한합니다. “none”으로 지정되면 제한이 해제됩니다. [기본값: 20]

  • --skip-errors — 문법 오류가 있는 파일을 무시하고 오류 진단을 발생시키지 않습니다.

  • --no-errors-on-unmatched — 명령어 실행 중 처리된 파일이 없을 경우 발생할 수 있는 오류를 무시합니다.

  • --error-on-warnings — 일부 진단에서 경고가 발생하면, Biome가 오류 코드로 종료되도록 합니다.

  • --reporter=<json|json-pretty|github|junit|summary|gitlab> — 진단 및 요약 메시지를 전달하는 방식을 변경할 수 있습니다.

  • --log-level=<none|debug|info|warn|error> — 로그 수준입니다. 가장 자세한 순서부터 가장 간략한 순서까지: debug, info, warn, error.

    none은 어떤 로그도 표시하지 않습니다.

    [기본값: none]

  • --log-kind=<pretty|compact|json> — 로그의 형식입니다. [기본값: pretty]

  • --diagnostic-level=<info|warn|error> — 표시할 진단 수준입니다. 낮은 수준에서 높은 수준 순서: info, warn, error. --diagnostic-level=error를 전달하면, 오직 오류를 포함한 진단만 출력됩니다. [기본값: info]

사용 가능한 옵션:

  • -h, --help — 도움말 정보 출력

디버깅을 위한 정보를 출력합니다.

사용법: biome rage [--daemon-logs] [--formatter] [--linter]

모든 명령어에 적용되는 전역 옵션

  • --colors=<off|force> — 마크업 포맷팅 모드 설정: “off”는 모든 내용을 일반 텍스트로 출력하며, “force”는 출력 콘솔이 호환되지 않는 것으로 판단되더라도 ANSI를 사용하여 마크업을 강제 포맷팅합니다.

  • --use-server — 실행 중인 Biome 덱몬 서버 인스턴스에 연결합니다.

  • --verbose — 추가 진단 정보를 출력하고, 일부 진단은 더 많은 정보를 표시합니다. 또한 처리된 파일과 수정된 파일 목록도 출력합니다.

  • --config-path=PATH — 설정 파일 경로 또는 biome.json 또는 biome.jsonc를 찾기 위한 디렉터리 경로를 설정합니다. 이 값을 사용하면 기본 설정 파일 해결 기능이 비활성화됩니다.

  • --max-diagnostics=<none|<NUMBER>> — 표시되는 진단 수를 제한합니다. “none”으로 지정되면 제한이 해제됩니다. [기본값: 20]

  • --skip-errors — 문법 오류가 있는 파일을 무시하고 오류 진단을 발생시키지 않습니다.

  • --no-errors-on-unmatched — 명령어 실행 중 처리된 파일이 없을 경우 발생할 수 있는 오류를 무시합니다.

  • --error-on-warnings — 일부 진단에서 경고가 발생하면, Biome가 오류 코드로 종료되도록 합니다.

  • --reporter=<json|json-pretty|github|junit|summary|gitlab> — 진단 및 요약 메시지를 전달하는 방식을 변경할 수 있습니다.

  • --log-level=<none|debug|info|warn|error> — 로그 수준입니다. 가장 자세한 순서부터 가장 간략한 순서까지: debug, info, warn, error.

    none은 어떤 로그도 표시하지 않습니다.

    [기본값: none]

  • --log-kind=<pretty|compact|json> — 로그의 형식입니다. [기본값: pretty]

  • --diagnostic-level=<info|warn|error> — 표시할 진단 수준입니다. 낮은 수준에서 높은 수준 순서: info, warn, error. --diagnostic-level=error를 전달하면, 오직 오류를 포함한 진단만 출력됩니다. [기본값: info]

사용 가능한 옵션:

  • --daemon-logs — Biome 덱몬 서버 로그를 출력합니다.
  • --formatter — 적용된 포맷터 옵션을 출력합니다.
  • --linter — 적용된 린터 옵션을 출력합니다.
  • -h, --help — 도움말 정보 출력

Biome의 덱몬 서버 프로세스를 시작합니다.

사용법: biome start [--config-path=PATH]

사용 가능한 옵션:

  • --log-prefix-name=STRING — 로그 파일 이름에 적용되는 접두사를 변경할 수 있습니다. 환경 변수 BIOME_LOG_PREFIX_NAME 사용 [기본값: server.log]
  • --log-path=PATH — 로그 파일 저장 폴더를 변경할 수 있습니다. 환경 변수 BIOME_LOG_PATH 사용
  • --config-path=PATH — 설정 파일에 대한 사용자 정의 파일 경로 또는 biome.json 또는 biome.jsonc를 찾기 위한 사용자 정의 디렉터리 경로를 설정할 수 있습니다. 환경 변수 BIOME_CONFIG_PATH 사용
  • -h, --help — 도움말 정보 출력

Biome의 덱몬 서버 프로세스를 중단합니다.

사용법: biome stop

사용 가능한 옵션:

  • -h, --help — 도움말 정보 출력

지정된 파일들에 대해 포맷터, 린터 및 임포트 정렬을 실행합니다.

사용법: biome check [--write] [--unsafe] [--assists-enabled=<true|false>] [--staged] [--changed] [--since=REF] [PATH]…

biome.json 파일 내부의 구성

  • --vcs-enabled=<true|false> — Biome가 VCS 클라이언트와 통합될지 여부

  • --vcs-client-kind=<git> — 클라이언트 유형입니다.

  • --vcs-use-ignore-file=<true|false> — Biome가 VCS 무시 파일을 사용할지 여부. [true]이면, Biome는 무시 파일에 지정된 파일을 무시합니다.

  • --vcs-root=PATH — Biome가 VCS 파일을 검색해야 할 폴더입니다. 기본적으로, Biome는 biome.json이 발견된 폴더를 사용합니다.

    Biome가 구성 설정을 찾을 수 없으면, 현재 작업 디렉터리를 사용하려고 시도합니다. 현재 작업 디렉터리가 찾을 수 없으면, Biome는 VCS 통합을 사용하지 않으며 진단이 발생합니다.

  • --vcs-default-branch=BRANCH — 프로젝트의 기본 브랜치

  • --files-max-size=NUMBER — 소스 파일의 최대 허용 크기(바이트 단위). 이 한도를 초과하는 파일은 성능 문제로 인해 무시됩니다. 기본값은 1 MiB입니다.

  • --files-ignore-unknown=<true|false> — Biome가 알지 못하는 파일을 다룰 때 진단을 발생시키지 않도록 합니다.

  • --use-editorconfig=<true|false>.editorconfig 파일을 사용하여 포맷터를 구성합니다. biome.json의 구성은 .editorconfig의 구성을 우선합니다. 기본값: false.

  • --indent-style=<tab|space> — 들여쓰기 스타일입니다.

  • --indent-size=NUMBER — 들여쓰기 크기, 기본값 2 (노티스됨, indent-width 사용)

  • --indent-width=NUMBER — 들여쓰기 크기, 기본값 2

  • --line-ending=<lf|crlf|cr> — 줄 끝 유형입니다.

  • --line-width=NUMBER — 줄 너비 최대값입니다. 기본값은 80입니다.

  • --attribute-position=<multiline|auto> — HTMLish 언어에서 속성 위치 스타일입니다. 기본값은 자동입니다.

  • --bracket-spacing=<true|false> — 객체 리터럴에서 괄호 사이에 공백을 넣을지 여부입니다. 기본값은 참입니다.

  • --jsx-quote-style=<double|single> — JSX에서 사용하는 따옴표 유형입니다. 기본값은 이중입니다.

  • --quote-properties=<preserve|as-needed> — 객체의 속성을 인용할 때의 방식입니다. 기본값은 필요 시입니다.

  • --trailing-comma=<all|es5|none> — 여러 줄로 나누어진 쉼표로 구분된 구문 구조에서 가능한 곳에 트레일링 콤마를 출력합니다. 기본값은 “all”입니다.

  • --trailing-commas=<all|es5|none> — 여러 줄로 나누어진 쉼표로 구분된 구문 구조에서 가능한 곳에 트레일링 콤마를 출력합니다. 기본값은 “all”입니다.

  • --semicolons=<always|as-needed> — 포맷터가 모든 문장에 세미콜론을 출력할지, 아니면 ASI로 인해 필요한 경우에만 출력할지 여부입니다.

  • --arrow-parentheses=<always|as-needed> — 화살표 함수에 불필요한 괄호를 추가할지 여부입니다. 기본값은 “always”입니다.

  • --bracket-same-line=<true|false> — 다중 줄 태그의 닫는 괄호를 마지막 줄 끝에 감싸거나, 다음 줄에 별도로 두는지 여부입니다. 기본값은 거짓입니다.

  • --javascript-formatter-enabled=<true|false> — JavaScript 파일(그리고 그 상위 언어)의 포맷터를 제어합니다.

  • --javascript-formatter-indent-style=<tab|space> — JavaScript 파일(그리고 그 상위 언어)에 적용되는 들여쓰기 스타일입니다.

  • --javascript-formatter-indent-size=NUMBER — JavaScript 파일(그리고 그 상위 언어)에 적용되는 들여쓰기 크기입니다. 기본값은 2입니다.

  • --javascript-formatter-indent-width=NUMBER — JavaScript 파일(그리고 그 상위 언어)에 적용되는 들여쓰기 크기입니다. 기본값은 2입니다.

  • --javascript-formatter-line-ending=<lf|crlf|cr> — JavaScript 파일(그리고 그 상위 언어)에 적용되는 줄 끝 유형입니다.

  • --javascript-formatter-line-width=NUMBER — JavaScript 파일(그리고 그 상위 언어)에 적용되는 줄 너비 최대값입니다. 기본값은 80입니다.

  • --quote-style=<double|single> — 자바스크립트 코드에서 사용하는 따옴표 유형입니다. 기본값은 이중입니다.

  • --javascript-attribute-position=<multiline|auto> — JSX 요소에서 속성 위치 스타일입니다. 기본값은 자동입니다.

  • --javascript-linter-enabled=<true|false> — 자바스크립트 파일(그리고 그 상위 언어)의 린터를 제어합니다.

  • --javascript-assists-enabled=<true|false> — 자바스크립트 파일(그리고 그 상위 언어)의 보조 기능을 제어합니다.

  • --json-formatter-enabled=<true|false> — JSON 파일(그리고 그 상위 언어)의 포맷터를 제어합니다.

  • --json-formatter-indent-style=<tab|space> — JSON 파일(그리고 그 상위 언어)에 적용되는 들여쓰기 스타일입니다.

  • --json-formatter-indent-width=NUMBER — JSON 파일(그리고 그 상위 언어)에 적용되는 들여쓰기 크기입니다. 기본값은 2입니다.

  • --json-formatter-indent-size=NUMBER — JSON 파일(그리고 그 상위 언어)에 적용되는 들여쓰기 크기입니다. 기본값은 2입니다.

  • --json-formatter-line-ending=<lf|crlf|cr> — JSON 파일(그리고 그 상위 언어)에 적용되는 줄 끝 유형입니다.

  • --json-formatter-line-width=NUMBER — JSON 파일(그리고 그 상위 언어)에 적용되는 줄 너비 최대값입니다. 기본값은 80입니다.

  • --json-formatter-trailing-commas=<none|all> — 여러 줄로 나누어진 쉼표로 구분된 구문 구조에서 가능한 곳에 트레일링 콤마를 출력합니다. 기본값은 “none”입니다.

  • --json-linter-enabled=<true|false> — JSON(그리고 그 상위 언어) 파일의 린터를 제어합니다.

  • --json-assists-enabled=<true|false> — JSON(그리고 그 상위 언어) 파일의 보조 기능을 제어합니다.

  • --css-formatter-enabled=<true|false> — CSS(그리고 그 상위 언어) 파일의 포맷터를 제어합니다.

  • --css-formatter-indent-style=<tab|space> — CSS 파일(그리고 그 상위 언어)에 적용되는 들여쓰기 스타일입니다.

  • --css-formatter-indent-width=NUMBER — CSS 파일(그리고 그 상위 언어)에 적용되는 들여쓰기 크기입니다. 기본값은 2입니다.

  • --css-formatter-line-ending=<lf|crlf|cr> — CSS 파일(그리고 그 상위 언어)에 적용되는 줄 끝 유형입니다.

  • --css-formatter-line-width=NUMBER — CSS 파일(그리고 그 상위 언어)에 적용되는 줄 너비 최대값입니다. 기본값은 80입니다.

  • --css-formatter-quote-style=<double|single> — CSS 코드에서 사용하는 따옴표 유형입니다. 기본값은 이중입니다.

  • --css-linter-enabled=<true|false> — CSS 파일의 린터를 제어합니다.

  • --css-assists-enabled=<true|false> — CSS 파일에 대한 보조 기능을 제어합니다.

  • --graphql-formatter-enabled=<true|false> — GraphQL 파일의 포맷터를 제어합니다.

  • --graphql-formatter-indent-style=<tab|space> — GraphQL 파일에 적용되는 들여쓰기 스타일입니다.

  • --graphql-formatter-indent-width=NUMBER — GraphQL 파일에 적용되는 들여쓰기 크기입니다. 기본값은 2입니다.

  • --graphql-formatter-line-ending=<lf|crlf|cr> — GraphQL 파일에 적용되는 줄 끝 유형입니다.

  • --graphql-formatter-line-width=NUMBER — GraphQL 파일에 적용되는 줄 너비 최대값입니다. 기본값은 80입니다.

  • --graphql-formatter-quote-style=<double|single> — GraphQL 코드에서 사용하는 따옴표 유형입니다. 기본값은 이중입니다.

  • --graphql-linter-enabled=<true|false> — GraphQL 파일의 린터를 제어합니다.

  • --assists-enabled=<true|false> — Biome가 LSP를 통해 보조 기능을 활성화할지 여부입니다.

모든 명령어에 적용되는 전역 옵션

  • --colors=<off|force> — 마크업 포맷팅 모드 설정: “off”는 모든 내용을 일반 텍스트로 출력하며, “force”는 출력 콘솔이 호환되지 않는 것으로 판단되더라도 ANSI를 사용하여 마크업을 강제 포맷팅합니다.

  • --use-server — 실행 중인 Biome 덱몬 서버 인스턴스에 연결합니다.

  • --verbose — 추가 진단 정보를 출력하고, 일부 진단은 더 많은 정보를 표시합니다. 또한 처리된 파일과 수정된 파일 목록도 출력합니다.

  • --config-path=PATH — 설정 파일 경로 또는 biome.json 또는 biome.jsonc를 찾기 위한 디렉터리 경로를 설정합니다. 이 값을 사용하면 기본 설정 파일 해결 기능이 비활성화됩니다.

  • --max-diagnostics=<none|<NUMBER>> — 표시되는 진단 수를 제한합니다. “none”으로 지정되면 제한이 해제됩니다. [기본값: 20]

  • --skip-errors — 문법 오류가 있는 파일을 무시하고 오류 진단을 발생시키지 않습니다.

  • --no-errors-on-unmatched — 명령어 실행 중 처리된 파일이 없을 경우 발생할 수 있는 오류를 무시합니다.

  • --error-on-warnings — 일부 진단에서 경고가 발생하면, Biome가 오류 코드로 종료되도록 합니다.

  • --reporter=<json|json-pretty|github|junit|summary|gitlab> — 진단 및 요약 메시지를 전달하는 방식을 변경할 수 있습니다.

  • --log-level=<none|debug|info|warn|error> — 로그 수준입니다. 가장 자세한 순서부터 가장 간략한 순서까지: debug, info, warn, error.

    none은 어떤 로그도 표시하지 않습니다.

    [기본값: none]

  • --log-kind=<pretty|compact|json> — 로그의 형식입니다. [기본값: pretty]

  • --diagnostic-level=<info|warn|error> — 표시할 진단 수준입니다. 낮은 수준에서 높은 수준 순서: info, warn, error. --diagnostic-level=error를 전달하면, 오직 오류를 포함한 진단만 출력됩니다. [기본값: info]

사용 가능한 위치 인수:

  • PATH — 단일 파일, 단일 경로 또는 경로 목록

사용 가능한 옵션:

  • --write — 안전한 수정 사항을 작성하고, 포맷팅 및 임포트 정렬을 수행합니다.

  • --unsafe — 안전하지 않은 수정 사항을 허용하며, --write 또는 --fix와 함께 사용해야 합니다.

  • --fix--write의 별칭이며, 안전한 수정 사항을 작성하고, 포맷팅 및 임포트 정렬을 수행합니다.

  • --apply--write의 별칭이며, 안전한 수정 사항을 작성하고, 포맷팅 및 임포트 정렬을 수행합니다 (노티스됨, --write 사용).

  • --apply-unsafe--write --unsafe의 별칭이며, 안전하고 불안전한 수정 사항을 작성하고, 포맷팅 및 임포트 정렬을 수행합니다 (노티스됨, --write --unsafe 사용).

  • --formatter-enabled=<true|false> — 포맷터 검사를 활성화 또는 비활성화할 수 있습니다.

  • --linter-enabled=<true|false> — 린터 검사를 활성화 또는 비활성화할 수 있습니다.

  • --organize-imports-enabled=<true|false> — 임포트 정렬을 활성화 또는 비활성화할 수 있습니다.

  • --assists-enabled=<true|false> — 보조 기능을 활성화 또는 비활성화할 수 있습니다.

  • --stdin-file-path=PATHstdin을 통해 코드를 포맷팅하고, 결과를 stdout에 출력하고자 할 때 사용합니다.

    파일이 디스크에 존재할 필요는 없습니다. 중요한 것은 파일 확장자입니다. 확장자를 기반으로, Biome는 어떻게 코드를 분석해야 할지 알고 있습니다.

    예시: echo 'let a;' | biome check --stdin-file-path=file.js

  • --stagedtrue로 설정되면, 준비된(커밋할 준비가 된) 파일들만 린팅됩니다. 이 옵션은 로컬 작업 시 사용해야 합니다.

  • --changedtrue로 설정되면, 기본 브랜치(defaultBranch)와 비교했을 때 변경된 파일들만 린팅됩니다. 이 옵션은 CI 환경에서 사용해야 합니다.

  • --since=REF--changed 옵션을 사용하고, biome.jsondefaultBranch가 정의되어 있지 않을 때, 비교할 기준 브랜치를 지정하기 위해 사용합니다.

  • -h, --help — 도움말 정보 출력

일련의 파일에 대해 여러 가지 검사를 실행합니다.

사용법: biome lint [--write] [--unsafe] [--only=<GROUP|RULE>]… [--skip=<GROUP|RULE>]… [--staged] [--changed] [--since=REF] [PATH]…

Biome를 소프트웨어 VCS와 통합하기 위한 속성 집합.

  • --vcs-enabled=<true|false> — Biome가 VCS 클라이언트와 통합될지 여부

  • --vcs-client-kind=<git> — 클라이언트 유형입니다.

  • --vcs-use-ignore-file=<true|false> — Biome가 VCS 무시 파일을 사용할지 여부. [true]이면, Biome는 무시 파일에 지정된 파일을 무시합니다.

  • --vcs-root=PATH — Biome가 VCS 파일을 검색해야 할 폴더입니다. 기본적으로, Biome는 biome.json이 발견된 폴더를 사용합니다.

    Biome가 구성 설정을 찾을 수 없으면, 현재 작업 디렉터리를 사용하려고 시도합니다. 현재 작업 디렉터리가 찾을 수 없으면, Biome는 VCS 통합을 사용하지 않으며 진단이 발생합니다.

  • --vcs-default-branch=BRANCH — 프로젝트의 기본 브랜치

파일 시스템 설정

  • --files-max-size=NUMBER — 소스 파일의 최대 허용 크기(바이트 단위). 이 한도를 초과하는 파일은 성능 문제로 인해 무시됩니다. 기본값은 1 MiB입니다.
  • --files-ignore-unknown=<true|false> — Biome가 알지 못하는 파일을 다룰 때 진단을 발생시키지 않도록 합니다.

자바스크립트 린터 전용 옵션

  • --javascript-linter-enabled=<true|false> — 자바스크립트 파일(그리고 그 상위 언어)의 린터를 제어합니다.

JSON 린터 전용 옵션

  • --json-linter-enabled=<true|false> — JSON 파일(그리고 그 상위 언어)의 린터를 제어합니다.

모든 명령어에 적용되는 전역 옵션

  • --colors=<off|force> — 마크업 포맷팅 모드 설정: “off”는 모든 내용을 일반 텍스트로 출력하며, “force”는 출력 콘솔이 호환되지 않는 것으로 판단되더라도 ANSI를 사용하여 마크업을 강제 포맷팅합니다.

  • --use-server — 실행 중인 Biome 덱몬 서버 인스턴스에 연결합니다.

  • --verbose — 추가 진단 정보를 출력하고, 일부 진단은 더 많은 정보를 표시합니다. 또한 처리된 파일과 수정된 파일 목록도 출력합니다.

  • --config-path=PATH — 설정 파일 경로 또는 biome.json 또는 biome.jsonc를 찾기 위한 디렉터리 경로를 설정합니다. 이 값을 사용하면 기본 설정 파일 해결 기능이 비활성화됩니다.

  • --max-diagnostics=<none|<NUMBER>> — 표시되는 진단 수를 제한합니다. none으로 지정되면 제한이 해제됩니다. [기본값: 20]

  • --skip-errors — 문법 오류가 있는 파일을 무시하고 오류 진단을 발생시키지 않습니다.

  • --no-errors-on-unmatched — 명령어 실행 중 처리된 파일이 없을 경우 발생할 수 있는 오류를 무시합니다.

  • --error-on-warnings — 일부 진단에서 경고가 발생하면, Biome가 오류 코드로 종료되도록 합니다.

  • --reporter=<json|json-pretty|github|junit|summary|gitlab> — 진단 및 요약 메시지를 전달하는 방식을 변경할 수 있습니다.

  • --log-level=<none|debug|info|warn|error> — 로그 수준입니다. 가장 자세한 순서부터 가장 간략한 순서까지: debug, info, warn, error.

    none은 어떤 로그도 표시하지 않습니다.

    [기본값: none]

  • --log-kind=<pretty|compact|json> — 로그의 형식입니다. [기본값: pretty]

  • --diagnostic-level=<info|warn|error> — 표시할 진단 수준입니다. 낮은 수준에서 높은 수준 순서: info, warn, error. --diagnostic-level=error를 전달하면, 오직 오류를 포함한 진단만 출력됩니다. [기본값: info]

사용 가능한 위치 인수:

  • PATH — 단일 파일, 단일 경로 또는 경로 목록

사용 가능한 옵션:

  • --write — 안전한 수정 사항을 작성합니다.

  • --unsafe — 안전하지 않은 수정 사항을 허용하며, --write 또는 --fix와 함께 사용해야 합니다.

  • --fix--write의 별칭이며, 안전한 수정 사항을 작성합니다.

  • --apply--write의 별칭이며, 안전한 수정 사항을 작성합니다 (노티스됨, --write 사용).

  • --apply-unsafe--write --unsafe의 별칭이며, 안전하고 불안전한 수정 사항을 작성합니다 (노티스됨, --write --unsafe 사용).

  • --only=<GROUP|RULE> — 주어진 규칙 또는 규칙 그룹만 실행합니다. 만약 규칙의 중요도가 off라면, 추천 규칙인 경우 중요도는 error로, 그렇지 않은 경우는 warn로 설정됩니다.

    예시: biome lint --only=correctness/noUnusedVariables --only=suspicious

  • --skip=<GROUP|RULE> — 주어진 규칙 또는 규칙 그룹을 무시하고, 규칙의 중요도를 off로 설정합니다. 이 옵션은 --only보다 우선 순위가 높습니다.

    예시: biome lint --skip=correctness/noUnusedVariables --skip=suspicious

  • --stdin-file-path=PATHstdin을 통해 코드를 포맷팅하고, 결과를 stdout에 출력하고자 할 때 사용합니다.

    파일이 디스크에 존재할 필요는 없습니다. 중요한 것은 파일 확장자입니다. 확장자를 기반으로, Biome는 어떻게 코드를 분석해야 할지 알고 있습니다.

    예시: echo 'let a;' | biome lint --stdin-file-path=file.js

  • --stagedtrue로 설정되면, 준비된(커밋할 준비가 된) 파일들만 린팅됩니다.

  • --changedtrue로 설정되면, 기본 브랜치(defaultBranch)와 비교했을 때 변경된 파일들만 린팅됩니다.

  • --since=REF--changed 옵션을 사용하고, biome.jsondefaultBranch가 정의되어 있지 않을 때, 비교할 기준 브랜치를 지정하기 위해 사용합니다.

  • -h, --help — 도움말 정보 출력

일련의 파일에 대해 포맷터를 실행합니다.

사용법: biome format [--write] [--staged] [--changed] [--since=REF] [PATH]…

모든 파일에 적용되는 일반 옵션

  • --use-editorconfig=<true|false>.editorconfig 파일을 사용하여 포맷터를 구성합니다. biome.json의 구성은 .editorconfig의 구성보다 우선합니다. 기본값: false.
  • --indent-style=<tab|space> — 들여쓰기 스타일입니다.
  • --indent-size=NUMBER — 들여쓰기 크기, 기본값 2 (노티스됨, indent-width 사용)
  • --indent-width=NUMBER — 들여쓰기 크기, 기본값 2
  • --line-ending=<lf|crlf|cr> — 줄 끝 유형입니다.
  • --line-width=NUMBER — 줄 너비 최대값입니다. 기본값은 80입니다.
  • --attribute-position=<multiline|auto> — HTMLish 언어에서 속성 위치 스타일입니다. 기본값은 자동입니다.
  • --bracket-spacing=<true|false> — 객체 리터럴에서 괄호 사이에 공백을 넣을지 여부입니다. 기본값은 참입니다.

자바스크립트 파일 전용 포맷팅 옵션

  • --jsx-quote-style=<double|single> — JSX에서 사용하는 따옴표 유형입니다. 기본값은 이중입니다.
  • --quote-properties=<preserve|as-needed> — 객체의 속성을 인용할 때의 방식입니다. 기본값은 필요 시입니다.
  • --trailing-comma=<all|es5|none> — 여러 줄로 나누어진 쉼표로 구분된 구문 구조에서 가능한 곳에 트레일링 콤마를 출력합니다. 기본값은 “all”입니다.
  • --trailing-commas=<all|es5|none> — 여러 줄로 나누어진 쉼표로 구분된 구문 구조에서 가능한 곳에 트레일링 콤마를 출력합니다. 기본값은 “all”입니다.
  • --semicolons=<always|as-needed> — 포맷터가 모든 문장에 세미콜론을 출력할지, 아니면 ASI로 인해 필요한 경우에만 출력할지 여부입니다.
  • --arrow-parentheses=<always|as-needed> — 화살표 함수에 불필요한 괄호를 추가할지 여부입니다. 기본값은 “always”입니다.
  • --bracket-same-line=<true|false> — 다중 줄 태그의 닫는 괄호를 마지막 줄 끝에 감싸거나, 다음 줄에 별도로 두는지 여부입니다. 기본값은 거짓입니다.
  • --javascript-formatter-enabled=<true|false> — 자바스크립트 파일(그리고 그 상위 언어)의 포맷터를 제어합니다.
  • --javascript-formatter-indent-style=<tab|space> — 자바스크립트 파일(그리고 그 상위 언어)에 적용되는 들여쓰기 스타일입니다.
  • --javascript-formatter-indent-size=NUMBER — 자바스크립트 파일(그리고 그 상위 언어)에 적용되는 들여쓰기 크기입니다. 기본값은 2입니다.
  • --javascript-formatter-indent-width=NUMBER — 자바스크립트 파일(그리고 그 상위 언어)에 적용되는 들여쓰기 크기입니다. 기본값은 2입니다.
  • --javascript-formatter-line-ending=<lf|crlf|cr> — 자바스크립트 파일(그리고 그 상위 언어)에 적용되는 줄 끝 유형입니다.
  • --javascript-formatter-line-width=NUMBER — 자바스크립트 파일(그리고 그 상위 언어)에 적용되는 줄 너비 최대값입니다. 기본값은 80입니다.
  • --quote-style=<double|single> — 자바스크립트 코드에서 사용하는 따옴표 유형입니다. 기본값은 이중입니다.
  • --javascript-attribute-position=<multiline|auto> — JSX 요소에서 속성 위치 스타일입니다. 기본값은 자동입니다.
  • --bracket-spacing=<true|false> — 객체 리터럴에서 괄호 사이에 공백을 넣을지 여부입니다. 기본값은 참입니다.

Biome를 소프트웨어 VCS와 통합하기 위한 속성 집합.

  • --vcs-enabled=<true|false> — Biome가 VCS 클라이언트와 통합될지 여부

  • --vcs-client-kind=<git> — 클라이언트 유형입니다.

  • --vcs-use-ignore-file=<true|false> — Biome가 VCS 무시 파일을 사용할지 여부. [true]이면, Biome는 무시 파일에 지정된 파일을 무시합니다.

  • --vcs-root=PATH — Biome가 VCS 파일을 검색해야 할 폴더입니다. 기본적으로, Biome는 biome.json이 발견된 폴더를 사용합니다.

    Biome가 구성 설정을 찾을 수 없으면, 현재 작업 디렉터리를 사용하려고 시도합니다. 현재 작업 디렉터리가 찾을 수 없으면, Biome는 VCS 통합을 사용하지 않으며 진단이 발생합니다.

  • --vcs-default-branch=BRANCH — 프로젝트의 기본 브랜치

파일 시스템 설정

  • --files-max-size=NUMBER — 소스 파일의 최대 허용 크기(바이트 단위). 이 한도를 초과하는 파일은 성능 문제로 인해 무시됩니다. 기본값은 1 MiB입니다.
  • --files-ignore-unknown=<true|false> — 알지 못하는 파일을 다룰 때 진단을 발생시키지 않도록 합니다.

모든 명령어에 적용되는 전역 옵션

  • --colors=<off|force> — 마크업 포맷팅 모드 설정: “off”는 모든 내용을 일반 텍스트로 출력하며, “force”는 출력 콘솔이 호환되지 않는 것으로 판단되더라도 ANSI를 사용하여 마크업을 강제 포맷팅합니다.

  • --use-server — 실행 중인 Biome 덱몬 서버 인스턴스에 연결합니다.

  • --verbose — 추가 진단 정보를 출력하고, 일부 진단은 더 많은 정보를 표시합니다. 또한 처리된 파일과 수정된 파일 목록도 출력합니다.

  • --config-path=PATH — 설정 파일 경로 또는 biome.json 또는 biome.jsonc를 찾기 위한 디렉터리 경로를 설정합니다. 이 값을 사용하면 기본 설정 파일 해결 기능이 비활성화됩니다.

  • --max-diagnostics=<none|<NUMBER>> — 표시되는 진단 수를 제한합니다. none으로 지정되면 제한이 해제됩니다. [기본값: 20]

  • --skip-errors — 문법 오류가 있는 파일을 무시하고 오류 진단을 발생시키지 않습니다.

  • --no-errors-on-unmatched — 명령어 실행 중 처리된 파일이 없을 경우 발생할 수 있는 오류를 무시합니다.

  • --error-on-warnings — 일부 진단에서 경고가 발생하면, Biome가 오류 코드로 종료되도록 합니다.

  • --reporter=<json|json-pretty|github|junit|summary|gitlab> — 진단 및 요약 메시지를 전달하는 방식을 변경할 수 있습니다.

  • --log-level=<none|debug|info|warn|error> — 로그 수준입니다. 가장 자세한 순서부터 가장 간략한 순서까지: debug, info, warn, error.

    none은 어떤 로그도 표시하지 않습니다.

    [기본값: none]

  • --log-kind=<pretty|compact|json> — 로그의 형식입니다. [기본값: pretty]

  • --diagnostic-level=<info|warn|error> — 표시할 진단 수준입니다. 낮은 수준에서 높은 수준 순서: info, warn, error. --diagnostic-level=error를 전달하면, 오직 오류를 포함한 진단만 출력됩니다. [기본값: info]

사용 가능한 위치 인수:

  • PATH — 단일 파일, 단일 경로 또는 경로 목록.

사용 가능한 옵션:

  • --json-formatter-enabled=<true|false> — JSON 파일(그리고 그 상위 언어)의 포맷터를 제어합니다.

  • --json-formatter-indent-style=<tab|space> — JSON 파일(그리고 그 상위 언어)에 적용되는 들여쓰기 스타일입니다.

  • --json-formatter-indent-width=NUMBER — JSON 파일(그리고 그 상위 언어)에 적용되는 들여쓰기 크기입니다. 기본값은 2입니다.

  • --json-formatter-indent-size=NUMBER — JSON 파일(그리고 그 상위 언어)에 적용되는 들여쓰기 크기입니다. 기본값은 2입니다.

  • --json-formatter-line-ending=<lf|crlf|cr> — JSON 파일(그리고 그 상위 언어)에 적용되는 줄 끝 유형입니다.

  • --json-formatter-line-width=NUMBER — JSON 파일(그리고 그 상위 언어)에 적용되는 줄 너비 최대값입니다. 기본값은 80입니다.

  • --json-formatter-trailing-commas=<none|all> — 여러 줄로 나누어진 쉼표로 구분된 구문 구조에서 가능한 곳에 트레일링 콤마를 출력합니다. 기본값은 “none”입니다.

  • --stdin-file-path=PATHstdin을 통해 코드를 포맷팅하고, 결과를 stdout에 출력하고자 할 때 사용합니다.

    파일이 디스크에 존재할 필요는 없습니다. 중요한 것은 파일 확장자입니다. 확장자를 기반으로, Biome는 어떻게 코드를 포맷팅해야 할지 알고 있습니다.

    예시: echo 'let a;' | biome format --stdin-file-path=file.js

  • --write — 포맷팅된 파일을 파일 시스템에 쓰기합니다.

  • --fix--write의 별칭이며, 포맷팅된 파일을 파일 시스템에 씁니다.

  • --stagedtrue로 설정되면, 준비된(커밋할 준비가 된) 파일들만 린팅됩니다.

  • --changedtrue로 설정되면, 기본 브랜치(defaultBranch)와 비교했을 때 변경된 파일들만 린팅됩니다.

  • --since=REF--changed 옵션을 사용하고, biome.jsondefaultBranch가 정의되어 있지 않을 때, 비교할 기준 브랜치를 지정하기 위해 사용합니다.

  • -h, --help — 도움말 정보 출력

CI 환경에서 사용할 명령어입니다. 지정된 파일들에 대해 포맷터, 린터 및 임포트 정렬을 실행합니다.

파일은 수정되지 않으며, 명령어는 읽기 전용 작업입니다.

사용법: biome ci [--formatter-enabled=<true|false>] [--linter-enabled=<true|false>] [--organize-imports-enabled=<true|false>] [--assists-enabled=<true|false>] [--changed] [--since=REF] [PATH]…

biome.json 파일 내부의 구성

  • --vcs-enabled=<true|false> — Biome가 VCS 클라이언트와 통합될지 여부

  • --vcs-client-kind=<git> — 클라이언트 유형입니다.

  • --vcs-use-ignore-file=<true|false> — Biome가 VCS 무시 파일을 사용할지 여부. [true]이면, Biome는 무시 파일에 지정된 파일을 무시합니다.

  • --vcs-root=PATH — Biome가 VCS 파일을 검색해야 할 폴더입니다. 기본적으로, Biome는 biome.json이 발견된 폴더를 사용합니다.

    Biome가 구성 설정을 찾을 수 없으면, 현재 작업 디렉터리를 사용하려고 시도합니다. 현재 작업 디렉터리가 찾을 수 없으면, Biome는 VCS 통합을 사용하지 않으며 진단이 발생합니다.

  • --vcs-default-branch=BRANCH — 프로젝트의 기본 브랜치

  • --files-max-size=NUMBER — 소스 파일의 최대 허용 크기(바이트 단위). 이 한도를 초과하는 파일은 성능 문제로 인해 무시됩니다. 기본값은 1 MiB입니다.

  • --files-ignore-unknown=<true|false> — 알지 못하는 파일을 다룰 때 진단을 발생시키지 않도록 합니다.

  • --use-editorconfig=<true|false>.editorconfig 파일을 사용하여 포맷터를 구성합니다. biome.json의 구성은 .editorconfig의 구성보다 우선합니다. 기본값: false.

  • --indent-style=<tab|space> — 들여쓰기 스타일입니다.

  • --indent-size=NUMBER — 들여쓰기 크기, 기본값 2 (노티스됨, indent-width 사용)

  • --indent-width=NUMBER — 들여쓰기 크기, 기본값 2

  • --line-ending=<lf|crlf|cr> — 줄 끝 유형입니다.

  • --line-width=NUMBER — 줄 너비 최대값입니다. 기본값은 80입니다.

  • --attribute-position=<multiline|auto> — HTMLish 언어에서 속성 위치 스타일입니다. 기본값은 자동입니다.

  • --bracket-spacing=<true|false> — 객체 리터럴에서 괄호 사이에 공백을 넣을지 여부입니다. 기본값은 참입니다.

  • --jsx-quote-style=<double|single> — JSX에서 사용하는 따옴표 유형입니다. 기본값은 이중입니다.

  • --quote-properties=<preserve|as-needed> — 객체의 속성을 인용할 때의 방식입니다. 기본값은 필요 시입니다.

  • --trailing-comma=<all|es5|none> — 여러 줄로 나누어진 쉼표로 구분된 구문 구조에서 가능한 곳에 트레일링 콤마를 출력합니다. 기본값은 “all”입니다.

  • --trailing-commas=<all|es5|none> — 여러 줄로 나누어진 쉼표로 구분된 구문 구조에서 가능한 곳에 트레일링 콤마를 출력합니다. 기본값은 “all”입니다.

  • --semicolons=<always|as-needed> — 포맷터가 모든 문장에 세미콜론을 출력할지, 아니면 ASI로 인해 필요한 경우에만 출력할지 여부입니다.

  • --arrow-parentheses=<always|as-needed> — 화살표 함수에 불필요한 괄호를 추가할지 여부입니다. 기본값은 “always”입니다.

  • --bracket-same-line=<true|false> — 다중 줄 태그의 닫는 괄호를 마지막 줄 끝에 감싸거나, 다음 줄에 별도로 두는지 여부입니다. 기본값은 거짓입니다.

  • --javascript-formatter-enabled=<true|false> — 자바스크립트 파일(그리고 그 상위 언어)의 포맷터를 제어합니다.

  • --javascript-formatter-indent-style=<tab|space> — 자바스크립트 파일(그리고 그 상위 언어)에 적용되는 들여쓰기 스타일입니다.

  • --javascript-formatter-indent-size=NUMBER — 자바스크립트 파일(그리고 그 상위 언어)에 적용되는 들여쓰기 크기입니다. 기본값은 2입니다.

  • --javascript-formatter-indent-width=NUMBER — 자바스크립트 파일(그리고 그 상위 언어)에 적용되는 들여쓰기 크기입니다. 기본값은 2입니다.

  • --javascript-formatter-line-ending=<lf|crlf|cr> — 자바스크립트 파일(그리고 그 상위 언어)에 적용되는 줄 끝 유형입니다.

  • --javascript-formatter-line-width=NUMBER — 자바스크립트 파일(그리고 그 상위 언어)에 적용되는 줄 너비 최대값입니다. 기본값은 80입니다.

  • --quote-style=<double|single> — 자바스크립트 코드에서 사용하는 따옴표 유형입니다. 기본값은 이중입니다.

  • --javascript-attribute-position=<multiline|auto> — JSX 요소에서 속성 위치 스타일입니다. 기본값은 자동입니다.

  • --javascript-linter-enabled=<true|false> — 자바스크립트 파일(그리고 그 상위 언어)의 린터를 제어합니다.

  • --javascript-assists-enabled=<true|false> — 자바스크립트 파일(그리고 그 상위 언어)의 보조 기능을 제어합니다.

  • --json-formatter-enabled=<true|false> — JSON 파일(그리고 그 상위 언어)의 포맷터를 제어합니다.

  • --json-formatter-indent-style=<tab|space> — JSON 파일(그리고 그 상위 언어)에 적용되는 들여쓰기 스타일입니다.

  • --json-formatter-indent-width=NUMBER — JSON 파일(그리고 그 상위 언어)에 적용되는 들여쓰기 크기입니다. 기본값은 2입니다.

  • --json-formatter-indent-size=NUMBER — JSON 파일(그리고 그 상위 언어)에 적용되는 들여쓰기 크기입니다. 기본값은 2입니다.

  • --json-formatter-line-ending=<lf|crlf|cr> — JSON 파일(그리고 그 상위 언어)에 적용되는 줄 끝 유형입니다.

  • --json-formatter-line-width=NUMBER — JSON 파일(그리고 그 상위 언어)에 적용되는 줄 너비 최대값입니다. 기본값은 80입니다.

  • --json-formatter-trailing-commas=<none|all> — 여러 줄로 나누어진 쉼표로 구분된 구문 구조에서 가능한 곳에 트레일링 콤마를 출력합니다. 기본값은 “none”입니다.

  • --json-linter-enabled=<true|false> — JSON(그리고 그 상위 언어) 파일의 린터를 제어합니다.

  • --json-assists-enabled=<true|false> — JSON(그리고 그 상위 언어) 파일의 보조 기능을 제어합니다.

  • --css-formatter-enabled=<true|false> — CSS(그리고 그 상위 언어) 파일의 포맷터를 제어합니다.

  • --css-formatter-indent-style=<tab|space> — CSS 파일(그리고 그 상위 언어)에 적용되는 들여쓰기 스타일입니다.

  • --css-formatter-indent-width=NUMBER — CSS 파일(그리고 그 상위 언어)에 적용되는 들여쓰기 크기입니다. 기본값은 2입니다.

  • --css-formatter-line-ending=<lf|crlf|cr> — CSS 파일(그리고 그 상위 언어)에 적용되는 줄 끝 유형입니다.

  • --css-formatter-line-width=NUMBER — CSS 파일(그리고 그 상위 언어)에 적용되는 줄 너비 최대값입니다. 기본값은 80입니다.

  • --css-formatter-quote-style=<double|single> — CSS 코드에서 사용하는 따옴표 유형입니다. 기본값은 이중입니다.

  • --css-linter-enabled=<true|false> — CSS 파일의 린터를 제어합니다.

  • --css-assists-enabled=<true|false> — CSS 파일에 대한 보조 기능을 제어합니다.

  • --graphql-formatter-enabled=<true|false> — GraphQL 파일의 포맷터를 제어합니다.

  • --graphql-formatter-indent-style=<tab|space> — GraphQL 파일에 적용되는 들여쓰기 스타일입니다.

  • --graphql-formatter-indent-width=NUMBER — GraphQL 파일에 적용되는 들여쓰기 크기입니다. 기본값은 2입니다.

  • --graphql-formatter-line-ending=<lf|crlf|cr> — GraphQL 파일에 적용되는 줄 끝 유형입니다.

  • --graphql-formatter-line-width=NUMBER — GraphQL 파일에 적용되는 줄 너비 최대값입니다. 기본값은 80입니다.

  • --graphql-formatter-quote-style=<double|single> — GraphQL 코드에서 사용하는 따옴표 유형입니다. 기본값은 이중입니다.

  • --graphql-linter-enabled=<true|false> — GraphQL 파일의 린터를 제어합니다.

  • --assists-enabled=<true|false> — Biome가 LSP를 통해 보조 기능을 활성화할지 여부입니다.

모든 명령어에 적용되는 전역 옵션

  • --colors=<off|force> — 마크업 포맷팅 모드 설정: “off”는 모든 내용을 일반 텍스트로 출력하며, “force”는 출력 콘솔이 호환되지 않는 것으로 판단되더라도 ANSI를 사용하여 마크업을 강제 포맷팅합니다.

  • --use-server — 실행 중인 Biome 덱몬 서버 인스턴스에 연결합니다.

  • --verbose — 추가 진단 정보를 출력하고, 일부 진단은 더 많은 정보를 표시합니다. 또한 처리된 파일과 수정된 파일 목록도 출력합니다.

  • --config-path=PATH — 설정 파일 경로 또는 biome.json 또는 biome.jsonc를 찾기 위한 디렉터리 경로를 설정합니다. 이 값을 사용하면 기본 설정 파일 해결 기능이 비활성화됩니다.

  • --max-diagnostics=<none|<NUMBER>> — 표시되는 진단 수를 제한합니다. none으로 지정되면 제한이 해제됩니다. [기본값: 20]

  • --skip-errors — 문법 오류가 있는 파일을 무시하고 오류 진단을 발생시키지 않습니다.

  • --no-errors-on-unmatched — 명령어 실행 중 처리된 파일이 없을 경우 발생할 수 있는 오류를 무시합니다.

  • --error-on-warnings — 일부 진단에서 경고가 발생하면, Biome가 오류 코드로 종료되도록 합니다.

  • --reporter=<json|json-pretty|github|junit|summary|gitlab> — 진단 및 요약 메시지를 전달하는 방식을 변경할 수 있습니다.

  • --log-level=<none|debug|info|warn|error> — 로그 수준입니다. 가장 자세한 순서부터 가장 간략한 순서까지: debug, info, warn, error.

    none은 어떤 로그도 표시하지 않습니다.

    [기본값: none]

  • --log-kind=<pretty|compact|json> — 로그의 형식입니다. [기본값: pretty]

  • --diagnostic-level=<info|warn|error> — 표시할 진단 수준입니다. 낮은 수준에서 높은 수준 순서: info, warn, error. --diagnostic-level=error를 전달하면, 오직 오류를 포함한 진단만 출력됩니다. [기본값: info]

사용 가능한 위치 인수:

  • PATH — 단일 파일, 단일 경로 또는 경로 목록

사용 가능한 옵션:

  • --formatter-enabled=<true|false> — 포맷터 검사를 활성화 또는 비활성화할 수 있습니다.
  • --linter-enabled=<true|false> — 린터 검사를 활성화 또는 비활성화할 수 있습니다.
  • --organize-imports-enabled=<true|false> — 임포트 정렬을 활성화 또는 비활성화할 수 있습니다.
  • --assists-enabled=<true|false> — 보조 기능을 활성화 또는 비활성화할 수 있습니다.
  • --changedtrue로 설정되면, 기본 브랜치(defaultBranch)와 비교했을 때 변경된 파일들만 린팅됩니다.
  • --since=REF--changed 옵션을 사용하고, biome.jsondefaultBranch가 정의되어 있지 않을 때, 비교할 기준 브랜치를 지정하기 위해 사용합니다.
  • -h, --help — 도움말 정보 출력

새로운 Biome 프로젝트를 생성합니다. 기본값을 포함한 설정 파일을 생성합니다.

사용법: biome init [--jsonc]

사용 가능한 옵션:

  • --jsonc — Biome가 biome.jsonc 파일을 출력하도록 지시합니다.
  • -h, --help — 도움말 정보 출력

stdin/stdout을 통해 언어 서버 프로토콜의 서버 역할을 수행합니다.

사용법: biome lsp-proxy [--config-path=PATH]

사용 가능한 옵션:

  • --log-prefix-name=STRING — 로그 파일 이름에 적용되는 접두사를 변경할 수 있습니다. 환경 변수 BIOME_LOG_PREFIX_NAME 사용 [기본값: server.log]
  • --log-path=PATH — 로그 파일 저장 폴더를 변경할 수 있습니다. 환경 변수 BIOME_LOG_PATH 사용
  • --config-path=PATH — 설정 파일에 대한 사용자 정의 파일 경로 또는 biome.json 또는 biome.jsonc를 찾기 위한 사용자 정의 디렉터리 경로를 설정할 수 있습니다. 환경 변수 BIOME_CONFIG_PATH 사용
  • -h, --help — 도움말 정보 출력

최종 변경 시 설정을 업데이트합니다.

사용법: biome migrate [--write] [COMMAND ...]

모든 명령어에 적용되는 전역 옵션

  • --colors=<off|force> — 마크업 포맷팅 모드 설정: “off”는 모든 내용을 일반 텍스트로 출력하며, “force”는 출력 콘솔이 호환되지 않는 것으로 판단되더라도 ANSI를 사용하여 마크업을 강제 포맷팅합니다.

  • --use-server — 실행 중인 Biome 덱몬 서버 인스턴스에 연결합니다.

  • --verbose — 추가 진단 정보를 출력하고, 일부 진단은 더 많은 정보를 표시합니다. 또한 처리된 파일과 수정된 파일 목록도 출력합니다.

  • --config-path=PATH — 설정 파일 경로 또는 biome.json 또는 biome.jsonc를 찾기 위한 디렉터리 경로를 설정합니다. 이 값을 사용하면 기본 설정 파일 해결 기능이 비활성화됩니다.

  • --max-diagnostics=<none|<NUMBER>> — 표시되는 진단 수를 제한합니다. none으로 지정되면 제한이 해제됩니다. [기본값: 20]

  • --skip-errors — 문법 오류가 있는 파일을 무시하고 오류 진단을 발생시키지 않습니다.

  • --no-errors-on-unmatched — 명령어 실행 중 처리된 파일이 없을 경우 발생할 수 있는 오류를 무시합니다.

  • --error-on-warnings — 일부 진단에서 경고가 발생하면, Biome가 오류 코드로 종료되도록 합니다.

  • --reporter=<json|json-pretty|github|junit|summary|gitlab> — 진단 및 요약 메시지를 전달하는 방식을 변경할 수 있습니다.

  • --log-level=<none|debug|info|warn|error> — 로그 수준입니다. 가장 자세한 순서부터 가장 간략한 순서까지: debug, info, warn, error.

    none은 어떤 로그도 표시하지 않습니다.

    [기본값: none]

  • --log-kind=<pretty|compact|json> — 로그의 형식입니다. [기본값: pretty]

  • --diagnostic-level=<info|warn|error> — 표시할 진단 수준입니다. 낮은 수준에서 높은 수준 순서: info, warn, error. --diagnostic-level=error를 전달하면, 오직 오류를 포함한 진단만 출력됩니다. [기본값: info]

사용 가능한 옵션:

  • --write — 새 설정 파일을 디스크에 씁니다.
  • --fix--write의 별칭이며, 새 설정 파일을 디스크에 씁니다.
  • -h, --help — 도움말 정보 출력

사용 가능한 명령어:

  • prettier.prettierrc/prettier.json.prettierignore 파일을 찾아, Prettier 설정을 Biome 설정 파일로 매핑합니다.
  • eslint — 작업 디렉터리에서 ESLint 설정 파일을 찾아, Biome 설정 파일을 업데이트합니다.

.prettierrc/prettier.json.prettierignore 파일을 찾아, Prettier 설정을 Biome 설정 파일로 매핑합니다.

사용법: biome migrate prettier

사용 가능한 옵션:

  • -h, --help — 도움말 정보 출력

작업 디렉터리에서 ESLint 설정 파일을 찾아, Biome 설정 파일을 업데이트합니다.

사용법: biome migrate eslint [--include-inspired] [--include-nursery]

사용 가능한 옵션:

  • --include-inspired — 영감을 받은 ESLint 규칙을 마이그레이션에 포함합니다.
  • --include-nursery — 어린이 규정(아이들이 배우는 규칙)을 마이그레이션에 포함합니다.
  • -h, --help — 도움말 정보 출력

실험적: 프로젝트 내에서 Grit 패턴을 검색합니다.

주의: GritQL은 코드 조각을 따옴표로 감싸며, 대부분의 쉘이 따옴표를 명령어 호출로 해석합니다. 이를 방지하기 위해, 쿼리에 싱글 따옴표를 사용하는 것이 좋습니다.

Terminal window
biome search '`console.log($message)`' # 모든 `console.log` 호출 찾기

사용법: biome search 패턴 [경로]…

모든 명령어에 적용되는 전역 옵션

  • --colors=<off|force> — 마크업 포맷팅 모드 설정: “off”는 모든 내용을 일반 텍스트로 출력하며, “force”는 출력 콘솔이 호환되지 않는 것으로 판단되더라도 ANSI를 사용하여 마크업을 강제 포맷팅합니다.

  • --use-server — 실행 중인 Biome 덱몬 서버 인스턴스에 연결합니다.

  • --verbose — 추가 진단 정보를 출력하고, 일부 진단은 더 많은 정보를 표시합니다. 또한 처리된 파일과 수정된 파일 목록도 출력합니다.

  • --config-path=PATH — 설정 파일 경로 또는 biome.json 또는 biome.jsonc를 찾기 위한 디렉터리 경로를 설정합니다. 이 값을 사용하면 기본 설정 파일 해결 기능이 비활성화됩니다.

  • --max-diagnostics=<none|<번호>> — 표시되는 진단 수를 제한합니다. none으로 지정되면 제한이 해제됩니다. [기본값: 20]

  • --skip-errors — 문법 오류가 있는 파일을 무시하고 오류 진단을 발생시키지 않습니다.

  • --no-errors-on-unmatched — 명령어 실행 중 처리된 파일이 없을 경우 발생할 수 있는 오류를 무시합니다.

  • --error-on-warnings — 일부 진단에서 경고가 발생하면, Biome가 오류 코드로 종료되도록 합니다.

  • --reporter=<json|json-pretty|github|junit|summary|gitlab> — 진단 및 요약 메시지를 전달하는 방식을 변경할 수 있습니다.

  • --log-level=<none|debug|info|warn|error> — 로그 수준입니다. 가장 자세한 순서부터 가장 간략한 순서까지: debug, info, warn, error.

    none은 어떤 로그도 표시하지 않습니다.

    [기본값: none]

  • --log-kind=<pretty|compact|json> — 로그의 형식입니다. [기본값: pretty]

  • --diagnostic-level=<info|warn|error> — 표시할 진단 수준입니다. 낮은 수준에서 높은 수준 순서: info, warn, error. --diagnostic-level=error를 전달하면, 오직 오류를 포함한 진단만 출력됩니다. [기본값: info]

파일 시스템 설정

  • --files-max-size=번호 — 소스 파일의 최대 허용 크기(바이트 단위). 이 한도를 초과하는 파일은 성능 문제로 인해 무시됩니다. 기본값은 1 MiB입니다.
  • --files-ignore-unknown=<참|거짓> — 알지 못하는 파일을 다룰 때 진단을 발생시키지 않도록 합니다.

Biome를 소프트웨어 VCS와 통합하기 위한 속성 집합.

  • --vcs-enabled=<참|거짓> — Biome가 VCS 클라이언트와 통합될지 여부

  • --vcs-client-kind=<git> — 클라이언트 유형입니다.

  • --vcs-use-ignore-file=<참|거짓> — Biome가 VCS 무시 파일을 사용할지 여부. [참]이면, Biome는 무시 파일에 지정된 파일을 무시합니다.

  • --vcs-root=경로 — Biome가 VCS 파일을 검색해야 할 폴더입니다. 기본적으로, Biome는 biome.json이 발견된 폴더를 사용합니다.

    Biome가 구성 설정을 찾을 수 없으면, 현재 작업 디렉터리를 사용하려고 시도합니다. 현재 작업 디렉터리가 찾을 수 없으면, Biome는 VCS 통합을 사용하지 않으며 진단이 발생합니다.

  • --vcs-default-branch=브랜치 — 프로젝트의 기본 브랜치

사용 가능한 위치 인수:

  • 패턴 — 검색할 GritQL 패턴입니다.

    참고: 현재 검색 명령어는 재작성(재귀적 표현)을 지원하지 않습니다.

  • 경로 — 단일 파일, 단일 경로 또는 경로 목록.

사용 가능한 옵션:

  • --stdin-file-path=경로stdin을 통해 코드를 검색하고, 결과를 stdout에 출력하고자 할 때 사용합니다.

    파일이 디스크에 존재할 필요는 없습니다. 중요한 것은 파일 확장자입니다. 확장자를 기반으로, Biome는 어떻게 코드를 분석해야 할지 알고 있습니다.

    예시: echo 'let a;' | biome search 'let $var' --stdin-file-path=file.js

  • -h, --help — 도움말 정보 출력

CLI의 다양한 측면에 대한 문서를 표시합니다.

Terminal window
biome explain noDebugger
Terminal window
biome explain daemon-logs

사용법: biome explain 이름

사용 가능한 위치 인수:

  • 이름 — 문서를 표시할 고유한 이름입니다.

사용 가능한 옵션:

  • -h, --help — 도움말 정보 출력

덱몬이 생성한 로그를 정리합니다.

사용법: biome clean

사용 가능한 옵션:

  • -h, --help — 도움말 정보 출력
  • 심볼릭 링크를 발견하면, CLI는 최대 3단계 깊이까지 전개합니다. 이 이상의 깊이는 오류 진단을 발생시킵니다.