Python Flask 기본 설정 및 설치 방법

Flask는 파이썬 기반의 경량 웹 프레임워크로, 빠르고 간단하게 웹 애플리케이션을 구축할 수 있습니다. Django보다 구조가 자유롭고, 배우기 쉬워서 개인 프로젝트나 MVP 개발에 자주 사용됩니다.

1. 사전 준비 사항

파이썬 설치 확인

Flask는 Python으로 작동하므로, 먼저 Python이 설치되어 있어야 합니다.

python --version
# 또는
python3 --version

만약 설치되어 있지 않다면 https://www.python.org/downloads/ 에서 Python을 설치하세요.

2. 가상환경(Virtual Environment) 설정 (권장)

가상환경은 프로젝트별로 독립적인 Python 환경을 구성하는 방법입니다.

# 1. 프로젝트 디렉터리 생성
mkdir flask_project
cd flask_project

# 2. 가상환경 생성
python -m venv venv

# 3. 가상환경 활성화 (운영체제별)
# Windows
venv\Scripts\activate

# macOS/Linux
source venv/bin/activate

가상환경이 활성화되면 프롬프트 앞에 (venv) 가 표시됩니다.

3. Flask 설치

pip install Flask

설치 확인:

python -m flask --version

4. 첫 번째 Flask 애플리케이션 만들기

프로젝트 루트에 app.py 파일을 만듭니다.

# app.py

from flask import Flask

app = Flask(__name__)

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

5. Flask 앱 실행 방법

방법 1: 직접 실행

python app.py

이 경우, 아래와 같은 코드가 필요합니다:

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

방법 2: FLASK_APP 환경변수 사용 (Flask 2.x 이상 권장 방식)

# 환경변수 설정
# Windows
set FLASK_APP=app.py
set FLASK_ENV=development

# macOS/Linux
export FLASK_APP=app.py
export FLASK_ENV=development

# 서버 실행
flask run

기본적으로 http://127.0.0.1:5000/ 에서 앱이 실행됩니다.

6. 디렉토리 구조 예시

flask_project/
│
├── venv/               # 가상환경 폴더
├── app.py              # Flask 애플리케이션 코드
├── requirements.txt    # 의존성 목록 (옵션)

requirements.txt 생성 방법:

pip freeze > requirements.txt

7. 개발을 위한 추가 패키지 (선택)

Flask-RESTful – REST API 설계
Flask-WTF – 폼 처리
Flask-SQLAlchemy – ORM
Flask-Login – 사용자 인증

pip install Flask-RESTful Flask-WTF Flask-SQLAlchemy Flask-Login

Python Flask