[Python] 🛠️ Mac에서 Flask 개발 환경 세팅하기

개발 환경: Mac + VS Code(Cursor AI)

목표: Flask 프로젝트 시작을 위한 환경 세팅

안녕! 요즘 이것저것 개발 공부하면서 Flask를 시작하게 됐는데,

환경 세팅 과정에서 헤맨 것도 좀 있고, 나중에 다시 보려고 정리해 두면 좋을 것 같아서 글을 써본다.

참고로 나는 Mac 기준으로 세팅했기 때문에, Windows랑은 조금 다를 수 있어!

사용하는 에디터는 VS Code...지만 사실 Cursor AI라는 확장형 에디터를 쓰고 있음 ㅎㅎ

🐣 Flask가 뭐야?

Flask는 파이썬으로 만든 마이크로 웹 프레임워크다.

말 그대로 작고 가볍지만, 필요한 기능은 확장해서 붙일 수 있는 구조라 유연한 편이다.

나처럼 웹 프레임워크 처음 써보는 사람한테도 꽤 친절하달까?

💡 Flask의 특징 요약

가볍다: 기본 기능만 있고 나머지는 직접 붙이도록 되어 있음.
빠르다: 복잡한 설정 없이 금방 실행 가능!
유연하다: ORM, 로그인, 세션 같은 기능은 필요할 때 추가.
템플릿 엔진 사용(Jinja2): HTML을 동적으로 만들 수 있음.
Werkzeug 기반: 안정적인 HTTP 처리 지원.

🔧 개발 환경 세팅하기 (Mac 기준)

이제 본격적으로 환경을 만들어보자!

✅ 1. Python 설치 확인

Mac은 기본적으로 Python이 깔려 있지만, 혹시 모르니 먼저 버전 확인!

python3 --version

만약 없거나 버전이 너무 낮다면 공식 Python 사이트에서 설치하면 된다.

✅ 2. 프로젝트 폴더 만들고 가상환경 생성

가상환경은 프로젝트마다 독립된 환경을 만들어주는 도구다.

이거 안 하면 나중에 패키지 충돌로 머리 쥐난다…

python3 -m venv venv

이러면 venv라는 폴더가 생기면서 가상환경이 만들어진다.

✅ 3. 가상환경 활성화

source venv/bin/activate

터미널 앞에 (venv) 이렇게 뜨면 성공!

이제부터는 여기에만 패키지들이 설치된다.

✅ 4. Flask 설치

pip install flask

설치 완료되면 아래 명령어로 잘 깔렸는지 확인해보자:

flask --version

버전 정보가 뜨면 오케이!

💻 VS Code 설정 (with Cursor)

나는 Cursor AI라는 VS Code 확장판(?)을 쓰는데, VS Code 설정법이랑 거의 똑같다.

프로젝트 폴더 열기
좌측 하단 Python 인터프리터 클릭
./venv/bin/python 선택!

.vscode/settings.json 파일에 이렇게 설정되면 됨:

{
  "python.pythonPath": "venv/bin/python"
}

🚀 첫 번째 Flask 앱 만들어보기

이제 진짜 서버 돌려보자!

루트 폴더에 app.py 파일 하나 만들고, 아래처럼 코드를 작성한다:

from flask import Flask

app = Flask(__name__)

@app.route("/")
def home():
    return "Hello, Flask!"

if __name__ == "__main__":
    app.run(debug=True)

실행은 이렇게:

python app.py

## 혹은 
flask run

브라우저 열고 http://127.0.0.1:5000 들어가면

“Hello, Flask!” 라는 텍스트가 반겨줄 거다 😎

✅ 마무리하며

생각보다 세팅은 간단한 편이었는데,

처음 할 땐 뭐부터 해야 할지 몰라서 살짝 멘붕 올 수도 있다.

이 글이 누군가에겐 작은 도움이 되었으면 좋겠음!

dev Devyne