astral-sh/ruff

어떤 프로젝트인가요?

핵심 기능

• 01900개 이상의 규칙으로 Python 코드를 린트하며, 다수의 Flake8 플러그인 규칙을 재구현합니다
• 02Black 호환 포매터로 코드를 포맷합니다
• 03--fix로 감지된 문제 중 상당수를 자동 수정합니다
• 04캐시를 사용해 변경되지 않은 파일을 건너뜁니다
• 05pyproject.toml 또는 ruff.toml로 설정할 수 있으며, 계층적 설정 탐색을 지원합니다

활용 사례

• Python 프로젝트에서 Flake8, Black, isort를 단일 도구로 대체하기
• pre-commit 훅이나 CI에서 린트 및 포맷 검사를 실행하기
• 디렉터리별 설정을 적용해 대규모 모노레포를 빠르게 린트하기
• VS Code 및 다른 에디터에서 피드백을 받고 코드를 자동 수정하기

빠른 시작

1. 1

   uv로 Ruff 설치(권장)

   uv tool install ruff@latest
2. 2

   pip로 Ruff 설치

   pip install ruff
3. 3

   현재 디렉터리의 모든 파일을 린트합니다

   ruff check
4. 4

   현재 디렉터리의 모든 파일을 포맷합니다

   ruff format

토픽

자주 묻는 질문

ruff은(는) 무엇인가요?

Rust로 작성된 초고속 Python 린터이자 코드 포매터로, 900개 이상의 린트 규칙과 Black 호환 포매팅을 제공합니다. Ruff는 Rust로 작성된 Python 린터이자 코드 포매터입니다. 코드의 오류, 스타일 문제, 오래된 패턴을 검사하고 그중 상당수를 자동으로 수정할 수 있습니다. Flake8과 플러그인, Black, isort, pydocstyle, pyupgrade 같은 여러 도구를 하나의 명령과 공통 설정으로 실행해 대체하는 것을 목표로 합니다.

ruff은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

ruff은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

ruff은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. ruff의 마지막 커밋은 2026년 10월 21일입니다.

ruff은(는) 어디에 사용할 수 있나요?

Python 프로젝트에서 Flake8, Black, isort를 단일 도구로 대체하기 pre-commit 훅이나 CI에서 린트 및 포맷 검사를 실행하기 디렉터리별 설정을 적용해 대규모 모노레포를 빠르게 린트하기 VS Code 및 다른 에디터에서 피드백을 받고 코드를 자동 수정하기

ruff는 어떻게 설치하나요?

uv로 Ruff 설치(권장): uv tool install ruff@latest pip로 Ruff 설치: pip install ruff 현재 디렉터리의 모든 파일을 린트합니다: ruff check 현재 디렉터리의 모든 파일을 포맷합니다: ruff format

ruff은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/astral-sh/ruff