다음을 통해 공유


Windows에서 Python 개발 환경 설정

Windows에서 몇 분 안에 Python 환경을 준비합니다. 수동으로 설정하거나 winget을 사용하여 모든 것을 자동화합니다. 다음이 필요합니다.

  • Python 3.13 – 최신 Python 런타임
  • Visual Studio Code – 가볍고 강력한 코드 편집기
  • Visual Studio Code용 Python 확장 – Python 언어 지원, 디버깅, Linting 등을 추가합니다.

아래 WinGet 구성 파일 은 위에 나열된 모든 항목을 자동으로 설치합니다.

시작하기:

  1. Windows 터미널에서 PowerShell을 열고 다음 명령을 실행합니다.

    winget configure -f https://aka.ms/python-config
    
  2. 구성이 시작되면 터미널 창에 설치 단계와 필수 설치가 표시됩니다. 검토한 다음 [Y] 예 또는 [N] 아니요를 선택하여 계속합니다.

  3. 필요한 워크로드가 설치됩니다. python --version를 실행하여 설치를 확인하세요.

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

자주 묻는 질문

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

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

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

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

StackOverflow에 대한 토론 수행

WSL을 사용하여 pip 설치 문제

Linux용 Windows 하위 시스템(WSL 또는 WSL2)에 pip가 있는 패키지(예 python3 -m pip install flask: 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 명령을 사용할 수도 있습니다. 그러나 python.org 설치된 Python 버전을 사용하는 경우에만 py.exe 시작 관리자가 작동합니다. 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) 를 사용하면 요청 시 리소스 크기를 조정하면서 컨테이너화된 애플리케이션을 배포하고 관리할 수 있습니다.

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

설정 동기화 를 사용하면 GitHub를 사용하여 여러 설치에서 VS Code 설정을 동기화할 수 있습니다. 다른 컴퓨터에서 작업하는 경우 이러한 컴퓨터 간에 환경을 일관되게 유지하는 데 도움이 됩니다.

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

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

Mac 바로 가기 키는 Windows 바로 가기 키에 매핑하는 방법

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

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