Flask 헬로 월드

1 Flask 소개

Flask는 Python을 위한 경량 WSGI 웹 프레임워크입니다. 풀스택 플랫폼의 방대한 기능 없이도 라우팅, 요청/응답 처리, 템플릿(Jinja2를 통해) 및 견고한 확장 생태계와 같은 필수 기능을 제공합니다.

사람들이 Flask를 선택하는 이유:

최소한의 핵심에 다양한 확장 기능을 추가할 수 있습니다.
유연한 프로젝트 레이아웃—단일 파일부터 모듈식 애플리케이션까지.
읽기 쉽고 접근하기 쉬운 코드베이스.
Gunicorn과 같은 WSGI 서버와 함께 사용하면 프로덕션 준비가 됩니다.

환경 설정을 위해 "다음"을 클릭하세요.

2 사전 요구 사항: Python & pip

Python 3.8 이상을 설치한 후 다음 명령으로 확인하세요:

python --version

Python이 필요하신가요? python.org에서 다운로드하세요.

3 가상 환경 생성

가상 환경을 사용하여 종속성을 격리하세요.

python -m venv .venv

활성화하세요:

# macOS/Linux
source .venv/bin/activate

# Windows (Command Prompt)
.venv\Scripts\activate

활성화되면 프롬프트에 (.venv)가 표시됩니다.

4 Flask 설치

가상 환경이 활성화된 상태에서 Flask를 설치하세요.

pip install Flask

설치 확인:

pip list | grep -i flask

5 최소 Flask 앱 작성

app.py라는 파일을 만들고 다음 내용을 작성하세요:

from flask import Flask

app = Flask(__name__)

@app.get("/")
def hello():
    return "Hello from Flask!"

@app.get("/hello/")
def hello_name(name: str):
    # URL converters: string, int, float, path (default is string)
    return f"Hello, {name}!"

if __name__ == "__main__":
    # For local development only
    app.run(host="127.0.0.1", port=5000, debug=True)

라우트 데코레이터는 HTTP 메서드를 Python 함수에 매핑합니다. 꺾쇠 괄호 부분은 경로 매개변수를 캡처합니다.

6 앱 실행

개발 서버를 시작하세요:

python app.py

http://127.0.0.1:5000을 가리키는 출력을 볼 수 있습니다. 터미널은 차단되며 Ctrl+C로 중지합니다.

7 엔드포인트 테스트

브라우저를 여세요:

http://127.0.0.1:5000/ — “Hello from Flask!”
http://127.0.0.1:5000/hello/Flask — “Hello, Flask!”

curl을 사용할 수도 있습니다:

curl http://127.0.0.1:5000/
curl http://127.0.0.1:5000/hello/World

8 Flask 디버그 모드 사용

개발 중에는 debug=True를 사용하면 라이브 코드 다시 로드와 더 나은 오류 추적 기능이 활성화되어 반복 작업에 매우 유용합니다.

이전에 활성화하지 않았다면 app.py의 마지막 줄을 변경하세요:

if __name__ == "__main__":
    app.run(host="127.0.0.1", port=5000, debug=True)

참고: 프로덕션 환경에서는 내장 서버를 사용하지 마세요. 프로덕션용으로는 리버스 프록시(예: Nginx) 뒤에 실제 WSGI 서버(예: Gunicorn)를 사용하세요.

9 프로젝트 구조 (선택 사항)

프로젝트가 커짐에 따라 깔끔한 레이아웃이 도움이 됩니다:

hello-flask/
├─ app/
│  ├─ __init__.py
│  └─ routes.py
├─ requirements.txt
└─ run.py

예시 app/__init__.py:

from flask import Flask

def create_app():
    app = Flask(__name__)
    from .routes import bp
    app.register_blueprint(bp, url_prefix="/")
    return app

예시 app/routes.py:

from flask import Blueprint

bp = Blueprint("main", __name__)

@bp.get("/")
def hello():
    return "Hello from Flask!"

@bp.get("/hello/")
def hello_name(name: str):
    return f"Hello, {name}!"

예시 run.py:

from app import create_app

app = create_app()

if __name__ == "__main__":
    app.run(host="127.0.0.1", port=5000, debug=True)

pip freeze > requirements.txt로 종속성을 저장하세요.

10 다음 단계 및 일반적인 함정

템플릿: Jinja2 파일을 사용하여 render_template("index.html", name=name)을 사용하세요.
정적 파일: static/ 폴더에서 CSS/JS를 제공하세요.
구성: 비밀 정보를 코드에 넣지 마세요; 환경 변수를 사용하세요.
프로덕션: 리버스 프록시 뒤에 Gunicorn 또는 uWSGI를 사용하여 실행하세요.
Debug server는 Windows에서 git-bash + virtualenv와 함께 다시 로드되지 않습니다. 해당 환경을 활성화하려면 Command Prompt 또는 PowerShell을 사용하세요.

이제 작동하는 Flask 앱이 준비되었습니다. 여기서 템플릿, 폼, 실제 프로젝트 레이아웃을 추가할 수 있으며 핵심 아이디어는 변경되지 않습니다.

튜토리얼 진행률