Visual Studio Code에서 Python, Django, Pylint와 관련된 "unresolved import" 오류 해결

2024-07-27

Visual Studio Code에서 Python, Django, Pylint와 관련된 "unresolved import" 오류 해결

문제

원인

"unresolved import" 오류는 여러 가지 원인으로 발생할 수 있습니다.

모듈 설치 누락: import하려는 모듈이 설치되어 있지 않을 수 있습니다.
잘못된 import 경로: import 경로가 잘못되었거나 누락되었을 수 있습니다.
Python 버전 불일치: 사용하는 Python 버전과 설치된 모듈 버전이 일치하지 않을 수 있습니다.
VS Code 설정 문제: VS Code 설정이 Pylint와 올바르게 연결되어 있지 않을 수 있습니다.

해결 방법

모듈 설치 확인

가장 먼저 import하려는 모듈이 설치되어 있는지 확인해야 합니다. pip 또는 conda를 사용하여 모듈을 설치할 수 있습니다.

import 경로 확인

import 경로가 올바른지 확인해야 합니다. import 경로는 다음과 같은 방식으로 지정할 수 있습니다.

절대 경로: import 모듈 이름
상대 경로: from . import 모듈 이름
패키지 경로: from 패키지 이름.모듈 이름 import 모듈 이름

Python 버전 확인

사용하는 Python 버전과 설치된 모듈 버전이 일치하는지 확인해야 합니다. Python 버전을 확인하려면 다음 명령을 사용할 수 있습니다.

python --version

VS Code 설정 확인

VS Code 설정이 Pylint와 올바르게 연결되어 있는지 확인해야 합니다. VS Code 설정에서 다음 설정을 확인하십시오.

Python: linter: pylint
Python: pylintPath: Pylint 실행 파일 경로

추가 해결 방법

위의 방법으로 해결되지 않을 경우 다음과 같은 방법을 시도해 볼 수 있습니다.

VS Code 캐시 삭제: VS Code 캐시를 삭제하면 Pylint 오류가 해결될 수 있습니다.
Pylint 설정 변경: Pylint 설정을 변경하여 "unresolved import" 오류를 무시하도록 설정할 수 있습니다.
Pylint 버전 업데이트: 최신 버전의 Pylint를 사용하면 오류가 해결될 수 있습니다.

참고 자료

추가 정보

Pylint는 Python 코드의 정적 분석 도구입니다.
Django는 Python 웹 프레임워크입니다.
Visual Studio Code는 Microsoft에서 개발한 코드 편집기입니다.

한국어 자료

예제 코드

# import 경로 확인 예시

# 절대 경로
from django.contrib.auth.models import User

# 상대 경로
from .models import MyModel

# 패키지 경로
from django.db import models

추가 예제

# Pylint 설정 변경 예시

# .pylintrc 파일에 다음 내용 추가

[MESSAGES CONTROL]
unresolved-import = ignore

참고

Pylint "unresolved import" 오류 해결을 위한 대체 방법

모듈의 import 경로를 명확하게 지정하면 Pylint가 모듈을 찾는 데 도움이 될 수 있습니다. 예를 들어, 다음과 같이 import 경로를 명시할 수 있습니다.

# 절대 경로
from django.contrib.auth.models import User

# 상대 경로
from .models import MyModel

# 패키지 경로
from django.db import models as db_models

모듈 별칭 사용

import하는 모듈에 별칭을 사용하면 코드를 더욱 명확하게 작성할 수 있습니다. 예를 들어, 다음과 같이 모듈 별칭을 사용할 수 있습니다.

# 모듈 별칭 사용
import django.contrib.auth.models as auth_models

# 사용 예시
user = auth_models.User.objects.create_user(username='test', email='[email protected]', password='password')

Pylint 무시

특정 import 문에 대해 Pylint 오류를 무시할 수 있습니다. 다음과 같이 # pylint: disable=unresolved-import 주석을 사용하여 Pylint 오류를 무시할 수 있습니다.

# Pylint 오류 무시
from .models import MyModel  # pylint: disable=unresolved-import

# 사용 예시
my_model = MyModel.objects.create(name='My Model')

다른 linter 사용

Pylint 외에도 다양한 Python linter가 있습니다. PyFlakes, flake8, mypy 등 다른 linter를 사용하여 "unresolved import" 오류를 해결할 수 있습니다.

IDE/텍스트 편집기 기능 활용

PyCharm, IntelliJ IDEA, VS Code 등 대부분의 IDE/텍스트 편집기는 자동 import 기능을 제공합니다. 자동 import 기능을 활용하면 import 경로를 명확하게 지정할 수 있으며, "unresolved import" 오류를 방지할 수 있습니다.

주의 사항