[에러 해결] [cs50] import “cs50” could not be resolved 원인과 해결 방법

Python 개발 중 VS Code에서 import "cs50" could not be resolved 경고 또는 에러를 만나 당황하셨나요? 특히 하버드 CS50 강좌를 수강하며 cs50 라이브러리를 사용하려 할 때 자주 발생하는 문제입니다. 이 글에서는 해당 에러의 명확한 원인을 분석하고, 단계별 해결 방법을 제시하며, 앞으로 유사한 문제를 예방하기 위한 팁을 공유합니다.

1. 에러 발생 상황

사용자는 VS Code에서 Python 프로그램을 작성 중 from cs50 import get_string과 같은 코드를 사용했습니다. 문제는 cs50 모듈을 가져오는 부분에서 import "cs50" could not be resolved라는 경고/에러 메시지가 발생했다는 것입니다. 대문자 CS50으로 변경해 보았지만, 해결되지 않았습니다. 이 에러는 주로 VS Code의 Python 확장 프로그램이 현재 프로젝트에서 cs50 모듈을 찾을 수 없을 때 나타납니다.

from cs50 import get_string # <-- 여기서 "import "cs50" could not be resolved" 에러 발생

s = get_string("Do you agree? ")
print(f"You agreed: {s}")

2. 명확한 발생 원인

import "cs50" could not be resolved 에러는 대부분 다음과 같은 두 가지 주요 원인 중 하나로 인해 발생합니다.

2.1. cs50 라이브러리가 현재 Python 환경에 설치되지 않음

cs50은 Python 표준 라이브러리가 아니므로, 사용하려면 pip를 통해 명시적으로 설치해야 합니다. 만약 설치되어 있지 않다면, 인터프리터는 해당 모듈을 찾을 수 없습니다.

2.2. VS Code가 잘못된 Python 인터프리터를 사용 중

여러 Python 버전 또는 가상 환경(Virtual Environment)을 사용하는 경우, cs50이 설치된 환경과 VS Code가 현재 사용하도록 설정된 Python 인터프리터가 다를 수 있습니다. VS Code는 활성화된 인터프리터의 site-packages 디렉토리에서 모듈을 찾습니다.

3. 해결 방법 및 코드 예시

이 문제를 해결하기 위해 다음 단계들을 순서대로 시도해 보세요.

3.1. cs50 라이브러리 설치 확인 및 설치

가장 먼저 cs50 라이브러리가 현재 사용 중인 Python 환경에 설치되어 있는지 확인하고, 설치되어 있지 않다면 설치합니다. VS Code 터미널(Terminal > New Terminal)을 열고 다음 명령어를 실행합니다.

pip install cs50

만약 pip가 Python 2와 Python 3 환경에서 모두 작동한다면 pip3를 사용하는 것이 더 안전합니다.

pip3 install cs50

설치 후 VS Code를 다시 시작하거나, 현재 Python 파일의 에디터를 닫았다가 다시 열어보세요.

3.2. VS Code의 Python 인터프리터 설정 확인

cs50이 올바르게 설치되었다 하더라도, VS Code가 다른 Python 환경을 참조하고 있다면 여전히 에러가 발생할 수 있습니다.

• VS Code 하단 상태바(Status Bar)의 왼쪽을 보면 현재 선택된 Python 인터프리터가 표시됩니다. 이를 클릭하여 변경할 수 있습니다.
• 또는 Ctrl+Shift+P (macOS: Cmd+Shift+P)를 눌러 Command Palette를 열고 Python: Select Interpreter를 검색하여 선택합니다.
• cs50 라이브러리를 설치한 Python 환경(예: Python 3.x.x (venv) 또는 Python 3.x.x)을 선택합니다. 올바른 인터프리터를 선택하면 문제가 해결되는 경우가 많습니다.

3.3. 가상 환경(Virtual Environment) 사용 권장

프로젝트마다 독립적인 환경을 구축하는 것은 파이썬 개발의 좋은 습관입니다. 새로운 프로젝트를 시작할 때는 가상 환경을 만들고, 그 안에 필요한 라이브러리들을 설치하는 것을 권장합니다.

가상 환경 생성 및 활성화:

# 프로젝트 폴더로 이동
cd my_cs50_project

# 가상 환경 생성 (.venv는 환경 이름, 원하는 이름으로 변경 가능)
python3 -m venv .venv 

# 가상 환경 활성화
# Windows:
.\.venv\Scripts\activate
# macOS/Linux:
source ./.venv/bin/activate

활성화된 가상 환경에 cs50 설치:

pip install cs50

VS Code에서 이 가상 환경의 인터프리터를 선택합니다 (3.2 단계 참조).

4. 향후 예방을 위한 팁

• 항상 가상 환경 사용: 프로젝트별로 격리된 가상 환경을 사용하면 라이브러리 충돌을 방지하고 의존성 관리가 용이해집니다.
• VS Code 인터프리터 설정 확인 습관화: 새로운 프로젝트를 열거나, 문제가 발생했을 때 가장 먼저 VS Code가 올바른 Python 인터프리터를 사용하고 있는지 확인하는 습관을 들이세요.
• 터미널 환경과 VS Code 동기화: pip install 명령을 실행하는 터미널이 VS Code에서 선택한 Python 인터프리터와 동일한 환경을 사용하는지 항상 확인하세요. 가상 환경을 활성화한 터미널에서 설치하는 것이 가장 좋습니다.
• 에러 메시지 검색: import "cs50" could not be resolved와 같은 에러 메시지는 매우 구체적이므로, 구글에 직접 검색하면 빠르게 해결책을 찾을 수 있습니다.

cs50 import 에러는 주로 라이브러리 미설치 또는 잘못된 인터프리터 설정에서 비롯됩니다. 위의 단계들을 따르면 대부분의 경우 쉽게 해결할 수 있습니다. 이 글이 여러분의 개발 여정에 도움이 되었기를 바랍니다. 질문이 있다면 언제든지 댓글을 남겨주세요!