Windows Python 개발 환경 설정

몇 분 Windows Python 환경을 준비합니다. winget을 사용하여 명령줄에서 설치하거나 수동으로 설정합니다. 다음이 필요합니다.

  • Python – 현재 안정적인 Python 런타임(3.14 이상)
  • Visual Studio Code – 가볍고 강력한 코드 편집기
  • Python 확장 for Visual Studio Code – Python 언어 지원, 디버깅, 린팅 등 기능을 추가합니다.
  1. Windows 터미널 PowerShell을 열고 Python 설치합니다.

    winget install Python.Python.3.14
    
  2. Visual Studio Code 설치:

    winget install Microsoft.VisualStudioCode
    
  3. PowerShell을 닫고 다시 연 다음 Python 설치되어 있는지 확인합니다.

    python --version
    
  4. VS Code를 열고 VS Code Marketplace에서 Python 확장 설치합니다.

이제 Python 개발 준비가 되었습니다.

자주 묻는 질문

pip 설치를 사용하여 패키지를 설치하는 데 문제가 있습니다.

설치가 실패하는 여러 가지 이유가 있습니다. 대부분의 경우 올바른 솔루션은 패키지 개발자에게 문의하는 것입니다.

문제의 일반적인 원인은 수정할 수 있는 권한이 없는 위치에 설치하려고 하는 것입니다. 예를 들어 기본 설치 위치에는 관리 권한이 필요할 수 있지만 기본적으로 Python 관리자 권한이 없습니다. 가장 좋은 솔루션은 가상 환경을 만들고 거기에 설치하는 것입니다.

일부 패키지에는 C 또는 C++ 컴파일러를 설치해야 하는 네이티브 코드가 포함됩니다. 일반적으로 패키지 개발자는 미리 컴파일된 버전을 게시해야 하지만 그렇지 않은 경우가 많습니다. 이러한 패키지 중 일부는 Visual Studio C++ 옵션을 선택하는 경우 작동할 수 있지만 대부분의 경우 패키지 개발자에게 문의해야 합니다.

StackOverflow에 대한 토론 수행

WSL을 사용하여 pip 설치 문제

Linux용 Windows 하위 시스템(WSL 또는 WSL2)에 pip가 있는 패키지(예: Flask)를 설치하는 경우(예: python3 -m pip install flask) 다음과 같은 오류가 발생할 수 있습니다.

WARNING: Retrying (Retry(total=4, connect=None, read=None, redirect=None, status=None))
after connection broken by 'NewConnectionError('<urllib3.connection.VerifiedHTTPSConnection
object at 0x7f655471da30>: Failed to establish a new connection: [Errno -3]
Temporary failure in name resolution')': /simple/flask/

Aftermarket 방화벽을 실행하지 않는 한 가능한 솔루션은 단순히 pip를 다시 설치하는 것입니다.

sudo apt -y purge python3-pip
sudo python3 -m pip uninstall pip
sudo apt -y install python3-pip --fix-missing
py.exe란 무엇입니까?

여러 유형의 Python 프로젝트에서 작업 중이므로 컴퓨터에 여러 버전의 Python 설치될 수 있습니다. 이러한 모든 python 명령을 사용하므로 사용 중인 Python 버전이 명확하지 않을 수 있습니다. 표준으로서 python3 명령을 사용하거나 특정 버전을 선택하려면 python3.7를 사용하는 것이 좋습니다.

py.exe 시작 관리자 설치한 Python 최신 버전을 자동으로 선택합니다. 특정 버전을 선택하거나 py -3.7 사용할 수 있는 버전을 확인하는 등의 py --list 명령을 사용할 수도 있습니다. HOWEVER py.exe 시작 관리자는 python.org 설치된 Python 버전을 사용하는 경우에만 작동합니다. Microsoft Store Python 설치하는 경우 py 명령은 포함되지 않습니다. Linux, macOS, WSL 및 Microsoft Store 버전의 Python 경우 python3(또는 python3.7) 명령을 사용해야 합니다.

python.exe를 실행하면 왜 Microsoft Store가 열리나요?

새 사용자가 Python을 쉽게 설치할 수 있도록, 우리는 Microsoft Store에 게시된 최신 커뮤니티 패키지 버전으로 직접 이동할 수 있는 Windows 바로가기를 추가했습니다. 이 패키지는 관리자 권한 없이 쉽게 설치할 수 있으며 기본 pythonpython3 명령을 실제 패키지로 바꿉니다.

명령줄 인수를 사용하여 바로 가기 실행 파일을 실행하면 Python 설치되지 않았음을 나타내는 오류 코드가 반환됩니다. 이는 의도되지 않았을 때 배치 파일 및 스크립트가 스토어 앱을 열지 못하도록 하기 위한 것입니다.

python.org 설치 관리자를 사용하여 Python 설치하고 "PATH에 추가" 옵션을 선택하면 새 python 명령이 바로 가기보다 우선합니다. 다른 설치 관리자는 기본 제공 바로 가기보다 python 우선 순위로 추가할 수 있습니다.

시작에서 "앱 실행 별칭 관리"를 열고, "앱 설치 관리자" Python 항목을 찾고, "끄기"로 전환하여 Python 설치하지 않고 바로 가기를 사용하지 않도록 설정할 수 있습니다.

파일 경로를 복사하여 붙여넣을 때 왜 Python에서 작동하지 않나요?

Python 문자열은 특수 문자에 이스케이프 시퀀스를 사용합니다. 예를 들어 문자열에 새 줄 문자를 삽입하려면 다음을 입력 \n합니다. Windows 파일 경로는 백슬라이시를 사용하므로 일부 부분이 특수 문자로 변환될 수 있습니다.

경로를 Python 문자열로 붙여넣려면 r 접두사를 추가합니다. 이는 문자열이며 raw "(경로에서 마지막 백슬래시를 제거해야 할 수 있습니다)를 제외하고 이스케이프 문자는 사용되지 않음을 나타냅니다. 따라서 경로는 다음과 같이 표시될 수 있습니다. r"C:\Users\MyName\Documents\Document.txt"

Python 경로로 작업할 때 표준 pathlib 모듈을 사용하는 것이 좋습니다. 이렇게 하면 문자열을 슬래시 또는 백슬래시를 사용하든 관계없이 경로 조작을 일관되게 수행할 수 있는 풍부한 Path 개체로 변환하여 다양한 운영 체제에서 코드가 더 잘 작동하도록 할 수 있습니다.

PYTHONPATH란?

PYTHONPATH 환경 변수는 Python 모듈을 가져올 수 있는 디렉터리 목록을 지정하는 데 사용됩니다. 실행할 때 변수를 sys.path 검사하여 항목을 가져올 때 검색할 디렉터리를 확인할 수 있습니다.

명령 프롬프트에서 이 변수를 설정하려면 다음 set PYTHONPATH=list;of;paths을 사용합니다.

PowerShell에서 이 변수를 설정하려면 Python 시작하기 직전에 $env:PYTHONPATH='list;of;paths' 사용합니다.

환경 변수 설정을 통해 이 변수를 전역적으로 설정하는 것은 권장되지 않습니다. 그 이유는, 사용자가 의도한 Python 버전이 아닌 다른 버전에서 사용될 수 있기 때문입니다.

패키징 및 배포에 대한 도움말은 어디에서 찾을 수 있나요?

Docker: VSCode 확장을 사용하면 Dockerfile 및 docker-compose.yml 템플릿을 사용하여 신속하게 패키지 및 배포할 수 있습니다(프로젝트에 적합한 Docker 파일 생성).

AKS(Azure Kubernetes Service) 사용하면 요청 시 리소스 크기를 조정하면서 컨테이너화된 애플리케이션을 배포하고 관리할 수 있습니다.

다른 컴퓨터에서 작업해야 하는 경우 어떻게 해야 하나요?

VS Code에는 GitHub 또는 Microsoft 계정 사용하여 컴퓨터 간에 설정, 키 바인딩, 확장 등을 공유할 수 있는 기본 제공 Settings Sync가 있습니다. 확장이 필요하지 않습니다.

PyCharm, Atom, Sublime Text, Emacs 또는 Vim을 사용하는 데 익숙한 경우 어떻게 하나요?

VSCode 확장 Keymaps는 사용자 환경을 편안하게 구성하는 데 도움을 줄 수 있습니다.

Mac 바로 가기 키는 어떻게 Windows 바로 가기 키에 매핑하나요?

키보드 단추와 시스템 바로 가기 중 일부는 Windows 컴퓨터와 Macintosh 간에 약간 다릅니다. 이 Mac to Windows 전환 가이드 기본 사항을 다룹니다.

VS Code에서 Python 사용하는 방법에 대해 자세히 알아볼 수 있나요?
  • VS Code에서 Python 편집하기 : 동작을 맞춤 설정하는 방법을 비롯해 VS Code에서의 Python 자동 완성 및 IntelliSense 지원을 활용하는 방법에 대해 자세히 알아보세요. 또는 끄기만 하면 됩니다.
  • Python: Linting은 코드를 분석하여 잠재적인 오류를 분석하는 프로그램을 실행하는 프로세스입니다. VS Code가 Python 제공하는 다양한 형태의 Linting 지원 및 설정 방법에 대해 알아봅니다.
  • Python 디버깅: 디버깅은 컴퓨터 프로그램에서 오류를 식별하고 제거하는 프로세스입니다. 이 문서에서는 VS Code를 사용하여 Python 대한 디버깅을 초기화 및 구성하는 방법, 중단점을 설정 및 유효성 검사하고, 로컬 스크립트를 연결하고, 다양한 앱 유형 또는 원격 컴퓨터에서 디버깅을 수행하고, 몇 가지 기본적인 문제 해결 방법을 설명합니다.
  • 유니트 테스트 Python: 단위 테스트의 의미를 설명하는 몇 가지 배경, 예제 연습, 테스트 프레임워크 사용, 테스트 만들기 및 실행, 테스트 디버깅 및 테스트 구성 설정을 설명합니다.