Python 개발 환경 설치 가이드 for macOS(VSCode + Python + uv + FastAPI)

여기서 설치할 것은 네 가지입니다.

• VSCode - 코드를 쓰는 메모장 (개발자용 편집기)
• Python - 프로그래밍 언어
• uv - 파이썬 도우미. 설치와 가상환경을 대신 처리해줍니다
• FastAPI - 나만의 웹 서버를 만드는 도구

1. VSCode 설치

1. 인터넷 브라우저에서 code.visualstudio.com 접속

혹은 그냥 구글에 vscode 라고 검색해서 가장 위의 사이트로 이동해 주세요.

2. Download for MacOS 클릭

3. 다운로드된 파일을 더블클릭한 뒤, VSCode를 오른쪽 어플리케이션 폴더로 옮깁니다.

4. 스포트라이트에서 실행

5. 설치 완료

2. Python 설치

1. 브라우저에서 python.org/downloads 접속

2. 노란 버튼 Download Python 3.x 클릭 후 받은 파일 실행

3. 계속을 눌러 끝까지 설치 (암호를 물어보면 맥 로그인 암호 입력)

3. uv 설치

1. 아래 한 줄을 통째로 복사해서 터미널에 붙여넣고 Enter

shell

curl -LsSf https://astral.sh/uv/install.sh | sh

클릭하면 복사됩니다복사됨!

2. 설치가 끝나면 다시 터미널을 열고 설치가 잘되었는지 확인합니다.

shell

uv --version

클릭하면 복사됩니다복사됨!

4. FastAPI 설치하기

1. 설치 하기전에 우선 폴더를 하나 만들어야 합니다.
터미널을 열고 아래 명령어를 차례대로 입력합니다.

javascript

mkdir -p ~/desktop/fastapi-pjt && cd ~/desktop/fastapi-pjt

클릭하면 복사됩니다복사됨!

javascript

uv init

클릭하면 복사됩니다복사됨!

2. uv add fastapi를 입력해서 FastAPI를 설치합니다.

문제가 생겼다면

• python이 아니라 python3라고 입력해보세요.
• uv를 찾을 수 없다고 나옴 → VSCode 혹은 터미널을 완전히 껐다가 다시 켜세요
• 그래도 안 되면 → 안 되는 화면을 캡처해서 그대로 질문해 주세요. 오류 메시지가 최고의 힌트입니다