Chapter 1-3 Python 코드 포매터 Black 설치 및 설정 가이드

2025. 5. 23. 10:24·Fastapi
목차
  1. 🧹 Python 코드 포매터 Black 설치 및 설정 가이드
  2. 🧾 Black이란?
  3. ⚙️ 설치 방법
  4. ▶️ Black 실행 방법
  5. 🛠️ Black 설정 (pyproject.toml)
  6. 🧑‍💻 PyCharm 연동 팁
  7. 🔁 Recap

🧹 Python 코드 포매터 Black 설치 및 설정 가이드

🧾 Black이란?

  • Black은 **Python 코드 자동 정렬 도구(formatter)**입니다.
  • 수십 명이 협업하는 실무 환경에서 일관된 코드 스타일을 유지하도록 도와주는 중요한 도구입니다.
  • 작성한 코드를 PEP 8 및 자체 포맷 기준에 맞게 자동으로 정리해줍니다.

🔗 공식 깃허브: https://github.com/psf/black


⚙️ 설치 방법

poetry add --group=dev black==24.10.0
  • 개발 환경 전용으로 --group=dev 옵션을 사용
  • 설치 후 pyproject.toml에 자동 등록됨

▶️ Black 실행 방법

  1. 프로젝트 루트 디렉터리에서 실행:
poetry run black .
  1. 포매팅 예시
print("Life is Toooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooo Short")

실행하면 자동으로 줄바꿈되어 가독성 있게 포맷됩니다.


🛠️ Black 설정 (pyproject.toml)

[tool.black]
line-length = 120
  • [tool.black]은 섹션 단위로 설정을 지정합니다.
  • line-length = 120 : 줄 바꿈 기준을 120자로 설정 (요즘 모니터 기준 최적화)

📘 공식문서: https://black.readthedocs.io/en/stable/usage_and_configuration/the_basics.html#configuration-via-a-file


🧑‍💻 PyCharm 연동 팁

  • PyCharm의 Code Style 설정에서 Hard wrap at 120으로 지정하면, IDE 상에서도 동일한 라인 길이 기준으로 줄바꿈이 적용됩니다.

🔁 Recap

  • ✅ black은 협업 시 코드 스타일을 통일시켜주는 필수 도구입니다.
  • ✅ poetry를 이용해 손쉽게 설치 및 그룹별 관리 가능
  • ✅ pyproject.toml 하나로 다양한 설정 통합 가능
  • ✅ line-length 기본값을 120자로 설정해 가독성을 높일 수 있음
  • ✅ 설치 후에는 꼭 git commit을 잊지 말고 기록하세요 🙂

'Fastapi' 카테고리의 다른 글

Chapter 2-1 Pytest 설치 및 단위 테스트 입문 가이드  (0) 2025.05.23
Chapter 1-6 Mypy 설치 및 정적 타입 검사 가이드  (0) 2025.05.23
Chapter 1-5 Git 기본 세팅 및 커밋 가이드  (0) 2025.05.23
Chapter 1-2 Poetry 설치 가이드  (0) 2025.05.23
Chapter 1-1 Meetifyr - 간편한 약속 일정 조율 웹사이트 리뷰  (0) 2025.05.23
  1. 🧹 Python 코드 포매터 Black 설치 및 설정 가이드
  2. 🧾 Black이란?
  3. ⚙️ 설치 방법
  4. ▶️ Black 실행 방법
  5. 🛠️ Black 설정 (pyproject.toml)
  6. 🧑‍💻 PyCharm 연동 팁
  7. 🔁 Recap
'Fastapi' 카테고리의 다른 글
  • Chapter 1-6 Mypy 설치 및 정적 타입 검사 가이드
  • Chapter 1-5 Git 기본 세팅 및 커밋 가이드
  • Chapter 1-2 Poetry 설치 가이드
  • Chapter 1-1 Meetifyr - 간편한 약속 일정 조율 웹사이트 리뷰
Chansman
Chansman
안녕하세요! 코딩을 시작한 지 얼마 되지 않은 초보 개발자 찬스맨입니다. 이 블로그는 제 학습 기록을 남기고, 다양한 코딩 실습을 통해 성장하는 과정을 공유하려고 합니다. 초보자의 눈높이에 맞춘 실습과 팁, 그리고 개발하면서 겪은 어려움과 해결 과정을 솔직하게 풀어내려 합니다. 함께 성장하는 개발자 커뮤니티가 되기를 바랍니다.
  • Chansman
    찬스맨의 프로그래밍 스토리
    Chansman
  • 전체
    오늘
    어제
    • 분류 전체보기 (787) N
      • Python (32)
      • 프로젝트 (110) N
      • 과제 (25)
      • Database (40)
      • 멘토링 (11)
      • 특강 (37)
      • 기술블로그 (41)
      • 기술블로그-Fastapi편 (33)
      • 기술블로그-Django편 (153)
      • 기술블로그-Flask편 (36)
      • AI 분석 (5)
      • HTML & CSS (31)
      • JavaScript (17)
      • AWS_Cloud (21)
      • 웹스크래핑과 데이터 수집 (14)
      • Flask (42)
      • Django (77)
      • Fastapi (16)
      • 연예 (14)
  • 블로그 메뉴

    • 홈
    • 태그
    • 방명록
  • 링크

  • 공지사항

  • 인기 글

  • 태그

    classaction
    self-growth
    lawsuitculture
    life reflection
    RM
    chatgpterror
    smartphonedurability
    trumpmuskclash
    global politics
    뷔
    gpterror
    newpoliticalparty
    btsjungkook
    travel ban
    titaniumcase
    youngprofessionals
    btsreunion
    btsdischarge
    hotcoffeecase
    americanlaw
    homebartrend
    chinanightlife
    livebroadcast
    college reunions
    bts
    americaparty
    urbantrends
    btscomeback
    basalcellcarcinoma
    remittance
  • 최근 댓글

  • 최근 글

  • hELLO· Designed By정상우.v4.10.3
Chansman
Chapter 1-3 Python 코드 포매터 Black 설치 및 설정 가이드

개인정보

  • 티스토리 홈
  • 포럼
  • 로그인
상단으로

티스토리툴바

단축키

내 블로그

내 블로그 - 관리자 홈 전환
Q
Q
새 글 쓰기
W
W

블로그 게시글

글 수정 (권한 있는 경우)
E
E
댓글 영역으로 이동
C
C

모든 영역

이 페이지의 URL 복사
S
S
맨 위로 이동
T
T
티스토리 홈 이동
H
H
단축키 안내
Shift + /
⇧ + /

* 단축키는 한글/영문 대소문자로 이용 가능하며, 티스토리 기본 도메인에서만 동작합니다.