[MacOS for Python]MacOS+VS Code+Python 설정!

MacOS에서 Python 개발을 위해 VS Code 설정 익히기

macOS 환경에서 Visual Studio Code(이하 VS Code)를 설치하고, Python 개발 환경을 구축한 뒤 간단한 예제 프로그램을 실행하는 과정을 정리한 글입니다. 

---

1. 시작하기

macOS에서 프로그래밍을 시작하려고 할 때 가장 많이 사용하는 에디터 중 하나가 VS Code입니다. 설치가 간단하고, Python뿐만 아니라 여러 언어를 지원하기 때문에 많은 개발자들이 사용하는 툴입니다.
이 글에서는 VS Code 설치부터 Python 개발 환경 설정, 그리고 간단한 예제 코드를 실행하는 방법까지 순서대로 설명합니다.

---

2. 사전 준비 사항

• macOS를 실행 중인 Mac (버전은 Big Sur 이상 권장)
• 관리자 권한(macOS에 프로그램 설치 시 비밀번호를 요구하는 경우가 있음)

만약 기존에 Python이나 VS Code가 설치되어 있다면, 일부 과정을 건너뛰어도 무방합니다.

---

3. Python 설치하기

macOS에 기본적으로 Python 2.x 버전이 포함되어 있는 경우가 있습니다. 하지만 이미 Python 2.x는 공식 지원이 종료되어 Python 3 버전을 사용하는 것이 권장됩니다.
Python 설치 방법은 여러 가지가 있지만, 여기서는 가장 많이 사용하는 두 가지 방법을 소개합니다.

 

원하는 방법을 1가지만 선택해서 진행하면 됩니다. 

 

3.1. Python 공식 사이트에서 다운로드

• Python.org 다운로드 페이지에 접속합니다.

 

Download Python

 

• 페이지에서 macOS용 최신 버전의 Python 3.x 설치 프로그램을 다운로드합니다.
• 글 작성 시점 기준 최신 버전은 3.13.x일 수 있습니다. 다만 설치하는 시점에 따라 최신 버전이 다를 수 있고 필요에 따라서는 최신 버전 보다는 낮을 버전을 선택할 수도 있으므로 설치에 필요한 절차를 참고하시고 버전은 크게 고려하지 않아도 됩니다.

 

• 다운로드한 .pkg 파일을 더블클릭하여 설치 마법사를 실행합니다.

설치 과정을 완료한 뒤, 터미널을 열어 아래 명령어를 입력해 Python이 정상 설치되었는지 확인합니다.

python3 --version

설치가 정상적으로 되었다면, 버전 정보가 출력됩니다. (예: Python 3.11.2)

 

 

3.2. Homebrew를 통한 설치 (선택 사항)

Homebrew는 macOS에서 패키지(프로그램)를 간편하게 설치/관리할 수 있는 패키지 매니저입니다.

 

• 만약 Homebrew가 설치되어 있지 않다면, 터미널을 열고 다음 명령어를 입력해 Homebrew를 설치합니다. 입력 명령어는 Homebrew 사이트에서 복사하면 편하게 설치할 수 있습니다.

 

Homebrew

 

빨간색 box 내용을 복사하여 사용

• 복사한 내용을 터미널에 붙여 넣기 하면 설치할 수 있습니다. 

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

 

• Homebrew 설치가 완료된 후 터미널을 새로 열고, Python 3을 설치합니다.

brew install python3

 

• 설치 완료 후 아래 명령어로 버전을 확인합니다. 

 

python3 --version

 

어떤 방법을 사용해도 macOS에서 Python 3 버전이 정상적으로 동작하면 됩니다.

---

4. VS Code 설치하기

VS Code는 무료로 사용할 수 있으며, 공식 홈페이지에서 쉽게 다운로드할 수 있습니다.

• VS Code 공식 다운로드 페이지에 접속합니다.

 

Download Visual Studio Code - Mac, Linux, Windows

 

 

• macOS용 VS Code를 다운로드합니다. (Apple Silicon 칩(M1, M2 등) 사용 시 ARM 버전을 다운로드해도 좋고, Intel 칩이면 Intel 버전을 받으시면 됩니다.)
• 다운로드된 .zip 파일 또는 .dmg 파일을 열어 Visual Studio Code.app을 응용 프로그램(Applications) 폴더로 드래그하여 설치합니다.
• 설치가 완료되면, Launchpad나 응용 프로그램(Applications) 폴더에서 VS Code 아이콘을 클릭하여 실행할 수 있습니다.

 

• 처음 실행 시, “다운로드한 앱을 실행하시겠습니까?” 라는 경고가 뜰 수 있는데, [열기] 버튼을 눌러 진행하면 됩니다.

---

5. VS Code에서 Python 개발 환경 설정하기

5.1. Python 확장(Extension) 설치

1. VS Code를 실행합니다.
2. 왼쪽 사이드바에서 확장(Extensions) 아이콘(바퀴 모양/사각형 아이콘)을 클릭하거나, Shift + Command + X 단축키를 누릅니다.
3. 검색창에 “Python”을 입력하여 Microsoft가 제공하는 Python 확장을 찾아 설치합니다.
   • 확장을 설치하면 Python 문법 강조, 자동 완성, 디버깅 기능 등을 VS Code에서 바로 사용할 수 있습니다.

5.2. Python 환경 선택

Python 확장을 설치하면, VS Code 하단 혹은 좌측 하단에 Python Interpreter를 선택하는 메뉴가 나타납니다. 현재 시스템에 여러 버전의 Python이 설치되어 있거나 가상 환경(venv)을 사용할 경우 올바른 인터프리터를 선택해야 합니다.

1. VS Code 왼쪽 하단 상태 표시줄의 Python 버전(또는 “Select Interpreter”)을 클릭합니다.
2. 사용할 Python 버전(예: “Python 3.11.2 64-bit”)을 선택합니다.
3. 만약 가상 환경을 사용한다면, 해당 경로를 정확히 지정해야 합니다.

---

6. 간단한 Python 예제 실행하기

6.1. 새 프로젝트/폴더 열기

• VS Code 상단 메뉴에서 **File -> Open Folder…**를 선택합니다.
• 작업하고 싶은 폴더(예: ~/Documents/Projects/python-test)를 선택하여 엽니다.

6.2. ‘Hello World’ 코드 작성

• 폴더를 연 상태에서 VS Code의 왼쪽 Explorer에서 main.py 라는 파일을 새로 만듭니다.
• 아래 예시 코드를 입력합니다.

print("Hello World!")

• 파일을 저장(Command + S)합니다.

6.3. 코드 실행 방법

방법 1) VS Code 내장 터미널 사용

1. VS Code 상단 메뉴에서 View -> Terminal을 클릭하거나 `Ctrl + `` 단축키를 사용해 터미널 창을 엽니다.
2. 터미널이 열리면 현재 디렉토리(main.py가 있는 경로)로 이동해 있는지 확인합니다.
3. 아래 명령어를 입력하여 Python 코드를 실행합니다.
   bash

   복사편집

   python3 main.py
4. 터미널에 Hello World!가 출력되면 성공적으로 실행된 것입니다.

방법 2) VS Code의 Run 기능 사용

1. main.py 파일을 열어둔 상태에서 오른쪽 상단에 있는 Run(▷ 아이콘) 또는 Debug(버그 아이콘)를 클릭합니다.
2. 만약 환경이 제대로 설정되어 있지 않다면, Run and Debug 패널에서 “Python File” 또는 “Add Configuration”을 선택해 Python 콘피그를 생성해야 할 수 있습니다.
3. 설정 후 다시 Run 아이콘을 누르면, VS Code 내장 디버거가 실행되어 Debug Console에 결과가 표시됩니다.

---

7. 가상 환경(venv) 설정 (선택)

Python 프로젝트에서는 패키지 충돌을 방지하고 프로젝트마다 독립적인 패키지 버전을 유지하기 위해 가상 환경을 자주 사용합니다.

• 터미널에서 폴더를 연 뒤 아래 명령어를 입력하여 가상 환경을 생성합니다.

python3 -m venv venv

 

• 생성된 가상 환경을 활성화합니다.

source venv/bin/activate

• VS Code에 다시 돌아와서 Python Interpreter(버전 선택하는 부분)에서 새로 만든 venv를 선택합니다.
• 이렇게 설정해두면, 해당 프로젝트에서는 venv 안에 설치된 패키지만 사용하게 됩니다.
• 가상 환경을 비활성화하려면 아래 명령어를 입력합니다.

deactivate

---

8. 추가 팁

• pip 업그레이드: 패키지 설치 프로그램인 pip를 최신 버전으로 유지하면 좋습니다.

python3 -m pip install --upgrade pip

 

• 패키지 설치: 필요에 따라 패키지를 설치합니다.

pip install requests

• 확장(Extension) 추가: Python 외에도 Pylint, Black, isort 등 다양한 포맷터/린터 관련 확장을 설치하면 더욱 편리합니다.
• 단축키 숙지: VS Code에는 커맨드 팔레트(Command + Shift + P) 등을 통해 편리하게 기능을 실행할 수 있습니다.

---

9. 마치며

지금까지 macOS 환경에서 VS Code를 설치하고, Python 3을 연동해 간단한 프로그램을 실행해 보았습니다. VS Code는 다양한 확장 기능을 통해 개발 편의성을 높일 수 있으므로, 본인에게 맞는 세팅을 찾아 꾸준히 학습하고 사용하는 것이 좋습니다.

VS Code와 Python을 사용하면 웹 개발부터 데이터 분석, 머신러닝까지 폭넓은 분야를 자유롭게 탐구할 수 있습니다. 이 글이 macOS에서의 프로그래밍 환경 구축에 도움이 되었길 바랍니다.