CodeGym /행동 /Python SELF KO /첫 번째 프로젝트

첫 번째 프로젝트

Python SELF KO

레벨 3 , 레슨 2

사용 가능

8.1 IDE의 구조 분석

자, 이제 새 프로젝트를 만들었어. 여기서 뭐가 보이는지 알아보자.

1. 프로젝트의 폴더 및 파일 트리:

여기에는 우리 프로젝트 폴더의 내용이 표시돼 — pythonProject.

2. 현재 열려 있는 파일:

이건 그냥 main.py 파일의 내용이야, 코드의 문법이 강조 표시돼.

3. 상단 메뉴:

오른쪽 상단에 유용한 버튼들:

“녹색 삼각형” — 프로젝트 실행 버튼.
“벌레” — 디버그 모드 실행 버튼.
“돋보기” — 프로젝트 검색.
“톱니바퀴” — 설정.

4. 왼쪽에 보이는 사이드 메뉴:

여기에 몇 가지 유용한 버튼이 있어, 특히 우리가 관심을 가질 버튼은 Terminal 버튼.

5. 상태 바:

상태 바의 왼쪽에는 현재 열려 있는 파일의 경로가 표시되어. 오른쪽에는 그 인코딩: CRLF, UTF-8.

맨 오른쪽에는 현재 Python 버전 — Python 3.12.x이 표시돼, 이 프로젝트가 실행될 Python 버전인데, 여러 버전의 Python이 설치되어 있고 다른 버전에서 작동하는 프로젝트가 있을 때 가끔 여기 보는 게 유용해.

8.2 프로젝트 분석

일반적인 프로젝트는 왼쪽 패널에 표시되는 파일들로 구성됩니다. 이 파일들은 조건부로 4부분으로 나눌 수 있습니다.

Python 코드 파일. 이러한 파일은 .py 확장자를 가지며 PyCharm은 이를 파란색과 노란색 아이콘으로 표시합니다. 현재 우리 프로젝트에는 이러한 파일이 하나만 있습니다 — main.py

정적 파일. 데이터는 포함하지만 코드는 포함하지 않는 파일을 이렇게 부릅니다. 텍스트 파일, 이미지, 미디어 파일 등이 될 수 있습니다. 현재 우리 프로젝트에는 없습니다.

Python 가상 환경. .venv(Virtual Environment의 약자)라는 이름의 폴더에는 Python 파일과 몇 가지 서비스 유틸리티가 포함되어 있습니다. 패키지 관리자 pip도 사용하려는 타사 라이브러리를 여기에 다운로드합니다.

타사 라이브러리 (External libraries). 현재 우리 프로젝트에는 없지만, 다운로드하면 PyCharm이 반드시 여기에 표시합니다.

8.3 가상 환경 `.venv`

가상 환경에 대해 좀 더 자세히 이야기해 봅시다. .venv는 Python 프로젝트를 위해 가볍고 격리된 다양한 가상 환경을 생성할 수 있는 기능을 제공하는 Python의 모듈입니다. 이는 시스템 라이브러리로부터 격리하여 프로젝트 종속성을 관리할 수 있게 해주는 도구입니다. 프로젝트를 위한 격리된 방이라고 상상해 보세요. 그곳에서 프로젝트는 집안의 다른 거주자를 방해하지 않고 개인 장난감과 도구를 보관할 수 있습니다.

기술적으로는 간단하게 작동합니다. 프로젝트 폴더 내에 Python 인터프리터의 복사본과 라이브러리를 위한 별도의 공간이 생성됩니다. 이는 한 프로젝트를 위해 특정 버전의 라이브러리를 설치하더라도 이전 버전이 필요한 다른 프로젝트를 망치지 않도록 보장합니다. 가상 환경 사용은 끝없는 버전 충돌에서 구해주는 좋은 매너입니다.

PyCharm에서 환경 관리

PyCharm은 일반적으로 이를 스스로 처리하고 모든 것을 자동으로 생성합니다. 하지만 실수로 필요한 폴더를 삭제했거나 단순히 백지상태에서 다시 시작하고 싶을 때가 있습니다. 이러한 설정을 수동으로 관리할 수 있는 것은 유용한 기술입니다.

환경 생성

오른쪽 하단 모서리에 Python 연결 상태가 표시됩니다. 거기에 Python 3.XX와 같은 문구가 보이면 설치가 성공적으로 완료된 것입니다. 개발 환경이 인터프리터를 인식하고 명령을 실행할 준비가 되었습니다.

만약 No interpreter라고 쓰여 있다면, 그 문구를 클릭하세요.

나타나는 메뉴에서 Add New Interpreter를 선택한 다음 Add Local Interpreter를 선택합니다.
왼쪽 설정에서 Environment를 선택합니다. 중앙에서 Generate New에 체크 표시가 되어 있는지 확인하세요.
OK를 누릅니다. 에디터는 새로운 .venv 폴더를 생성하고 프로젝트를 즉시 그쪽으로 전환합니다. 이제 불필요한 쓰레기가 없는 완전히 깨끗한 시스템을 갖게 되었습니다.

오래된 것 또는 불필요한 것 삭제

때로는 실험이 막다른 골목에 다다르고, 환경을 고치려고 노력하는 것보다 삭제하는 것이 더 쉽습니다. 방법은 다음과 같습니다:

오른쪽 하단 모서리의 Python 버전을 다시 클릭하고 Interpreter Settings 항목을 선택합니다.
상단에서 Python Interpreter 필드를 찾습니다. 목록을 펼치고 Show All 항목을 선택합니다.
PyCharm이 알고 있는 모든 환경의 목록이 표시됩니다. 제거하려는 환경을 선택하고 목록 위 메뉴에서 마이너스 버튼을 누릅니다.
중요한 점은, PyCharm은 단순히 이 환경에 대해 «잊어버리고» 사용을 중단한다는 것입니다. 디스크 공간을 물리적으로 확보하려면 일반 탐색기를 통해 프로젝트 폴더로 이동하여 .venv 폴더를 수동으로 삭제해야 합니다.

두 번째 환경 생성

오류: «Already contains Python»

인터프리터 추가 메뉴로 들어가서 Generate new를 선택하면 PyCharm이 빨간색 경고를 표시하고 OK 버튼을 차단할 수 있습니다. 이는 에디터가 습관적으로 이미 첫 번째 환경이 차지하고 있는 동일한 .venv 폴더에 새 환경을 생성하려고 시도하기 때문에 발생합니다. 두 개의 서로 다른 라이브러리 세트가 하나의 폴더에 공존할 수 없습니다.

해결 방법

새로운 «샌드박스»에 고유한 이름을 부여하기만 하면 됩니다. 방법은 다음과 같습니다:

이전에 했던 것처럼 Add Local Interpreter 메뉴를 엽니다.
Generate new 항목을 선택합니다.
Location 필드를 보세요. 아마도 그곳의 경로는 표준 이름인 \.venv로 끝날 것입니다.
커서를 줄 끝에 놓고 아무 숫자나 추가하세요. 경로 끝을 \.venv_2로 변경하고 Enter를 누릅니다.
빨간색 글씨가 즉시 사라집니다. OK를 누릅니다.

이제 프로젝트에는 설정이 다른 두 개의 폴더가 물리적으로 존재하게 되며, PyCharm은 자동으로 새 버전으로 전환합니다.

환경 간 전환 방법

환경을 능숙하게 다루는 능력은 중요한 기술입니다. 하지만 여기에는 함정이 있습니다: PyCharm이 항상 이전 환경을 자동으로 기억하는 것은 아닙니다.

두 번째 환경을 생성했는데 첫 번째 환경이 메뉴에서 사라지는 경우가 종종 발생합니다. .venv 폴더가 여전히 프로젝트에 있는데도 말이죠. 이 경우 PyCharm에 이전 Python을 어디서 찾아야 하는지 알려주기만 하면 됩니다. .venv_2에서 .venv로 전환하는 예:

모서리의 Python 버전을 클릭하고 Add New Interpreter -> Add Local Interpreter를 선택합니다.
나타나는 창에서 점을 Select Existing 항목으로 전환합니다.
Python Path 필드에서 오른쪽의 폴더 아이콘을 클릭합니다.
이제 이전 폴더(.venv)에서 Python 실행 파일을 찾아야 합니다. 경로를 따라가세요: 당신의_프로젝트 -> .venv -> Scripts (Windows용) 또는 bin (macOS/Linux용).
이 폴더 안에서 python 파일을 선택하고 OK를 누릅니다.