mypy 실행과 형식 오류 수정
mypy를 구성하고 오류를 해석하며 코드베이스에 점진적으로 형식을 지정합니다.
mypy 실행과 형식 오류 수정은(는) CoddyKit의 무료 Python Academy 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Python Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Python Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
mypy 설치 및 실행
pip로 mypy를 설치한 다음 파일이나 패키지에 대해 실행합니다. 코드를 실행하지 않고 타입 오류를 보고합니다.
# pip install mypy
# Check a single file:
# mypy script.py
# Check a package:
# mypy mypackage/
# Strict mode (recommended for new code):
# mypy --strict script.py첫 mypy 오류
mypy는 호환되지 않는 타입, 누락된 반환값 및 주석이 없는 함수 인수를 감지합니다.
# script.py
def add(a, b): # mypy: Missing type annotation
return a + b
result: int = add("hello", 1) # str, not int
# mypy output:
# error: Returning Any from function declared to return "int"--strict 플래그
--strict는 누락된 주석, Any 사용, 타입이 지정되지 않은 가져오기 등 여러 추가 검사를 활성화합니다. 처음에는 사용하지 말고 점진적으로 추가하십시오.
# Most important strict flags individually:
# --disallow-untyped-defs
# --disallow-any-generics
# --warn-return-any
# --no-implicit-reexport
# Or all at once:
# mypy --strict mypackage/오류 무시
특정 오류를 억제하려면 줄 끝에 # type: ignore를 추가합니다. 꼭 필요한 경우에만 사용하고 이유를 설명하는 주석을 함께 작성하십시오.
import third_party # type: ignore[import] # no stub available
x: int = get_dynamic_value() # type: ignore[assignment]mypy.ini / pyproject.toml 구성
매번 플래그를 전달하지 않아도 되도록 mypy 설정을 mypy.ini 또는 pyproject.toml에 저장합니다.
# mypy.ini
[mypy]
python_version = 3.11
strict = True
ignore_missing_imports = True
[mypy-third_party.*]
ignore_errors = True증분 모드
mypy는 실행 사이에 결과를 캐시합니다. 변경된 파일만 다시 검사하므로 이후 실행이 빨라집니다.
# First run:
# mypy mypackage/ — full analysis, ~5 s
# Second run (nothing changed):
# mypy mypackage/ — Success: no issues in 0 source files (0.3 s)흔한 오류: 호환되지 않는 타입
가장 자주 발생하는 오류는 잘못된 타입의 값을 할당하거나 전달하는 것입니다.
# error: Incompatible types in assignment
# (expression has type "str", variable has type "int")
count: int = 0
count = "five" # error
# Fix:
count = 5흔한 오류: 인수 타입 불일치
함수에 잘못된 타입의 인수를 전달하는 오류입니다.
def greet(name: str) -> str:
return f"Hello, {name}"
# error: Argument 1 to "greet" has incompatible type "int"
greet(42) # error
# Fix:
greet(str(42))흔한 오류: 예기치 않은 None 반환
None이 아닌 값을 반환한다고 선언된 함수에 None을 반환하는 코드 경로가 있는 경우입니다.
# error: Missing return statement
def find(items: list[int], target: int) -> int:
for item in items:
if item == target:
return item
# Missing: no return if not found!
# Fix:
def find2(items: list[int], target: int) -> int | None:
for item in items:
if item == target:
return item
return Noneisinstance를 사용한 타입 좁히기
분기 내부에서 유니언 타입을 좁히려면 isinstance를 사용합니다. mypy는 이를 이해하고 타입의 범위를 좁힙니다.
def process(value: int | str) -> str:
if isinstance(value, int):
return str(value * 2) # mypy knows value is int here
return value.upper() # mypy knows value is str herecast 사용
typing.cast(Type, value)은 런타임 동작 없이 mypy에 값을 지정된 타입으로 취급하라고 알립니다. mypy보다 자신이 더 잘 알고 있을 때만 사용하십시오.
from typing import cast
def get_value() -> object:
return 42
result = cast(int, get_value()) # mypy treats result as int
print(result + 1) # 43빠른 확인
줄에 # type: ignore를 추가하면 어떤 일이 발생합니까?
복습
mypy script.py를 실행하여 타입을 검사합니다. 호환되지 않는 할당, 인수 불일치 및 누락된 반환값을 수정합니다. 유니언 타입을 좁힐 때는 isinstance를 사용하고, # type: ignore는 꼭 필요한 경우에만 사용하며, mypy.ini에서 mypy를 구성합니다. --strict는 점진적으로 활성화하십시오.
자주 묻는 질문
“mypy 실행과 형식 오류 수정” 강의는 무료인가요?
네 — “mypy 실행과 형식 오류 수정” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Python Academy 강의 전체를 잠금 해제할 수 있습니다. Python Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“mypy 실행과 형식 오류 수정”에서 뭘 배우나요?
mypy를 구성하고 오류를 해석하며 코드베이스에 점진적으로 형식을 지정합니다. 브라우저에서 직접 실행하는 실습 코드로 Python Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Python Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Python Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.
“mypy 실행과 형식 오류 수정” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Python Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Python Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.