[2026] Flask 기초 | Python 웹 프레임워크 시작하기

· 20분 읽기 · 수정 중급 튜토리얼
[2026] Flask 기초 | Python 웹 프레임워크 시작하기

이 글의 핵심

Flask 기초의 핵심 개념과 실무 포인트를 정리합니다.

들어가며

”가장 쉬운 Python 웹 프레임워크”

Flask는 간단하고 유연한 마이크로 웹 프레임워크입니다.

실무 활용 사례: 데이터 분석, 웹 개발, 자동화 프로젝트에서 실제로 사용한 패턴과 코드를 바탕으로 정리했습니다. 초보자가 흔히 겪는 오류와 해결법을 포함합니다.

실무에서 느낀 Python의 매력

처음 Python을 배울 때는 “이게 정말 프로그래밍 언어인가?” 싶을 정도로 간결했습니다. C++에서 10줄로 작성하던 코드가 Python에서는 2~3줄로 끝나는 경우가 많았죠. 특히 데이터 분석 프로젝트를 진행하면서 Pandas와 NumPy의 강력함을 체감했습니다. 엑셀로 몇 시간 걸리던 작업이 Python 스크립트로는 몇 초 만에 끝나는 걸 보고 동료들이 놀라워했던 기억이 납니다. 하지만 처음부터 순탄하지만은 않았습니다. 들여쓰기 하나 잘못해서 몇 시간을 헤맨 적도 있고, 가상환경 설정이 꼬여서 프로젝트 전체를 다시 시작한 적도 있습니다. 이런 시행착오를 겪으며 깨달은 건, 환경 설정을 처음부터 제대로 하는 것이 얼마나 중요한지였습니다. 이 글에서는 제가 겪은 실수들을 바탕으로, 여러분이 같은 시행착오를 겪지 않도록 실전 팁을 담았습니다.

1. Flask 시작하기

설치

pip install flask

Hello World

Flask(__name__)는 요청이 들어오면 어느 함수가 응답할지 연결해 주는 소형 공장을 만드는 단계입니다. @app.route('/')는 “주소 /로 오면 아래 함수를 실행해 문자열을 돌려준다”는 표지판을 붙이는 것과 같습니다. 아래 코드는 python를 사용한 구현 예제입니다. 필요한 모듈을 import하고, 함수를 통해 로직을 구현합니다. 각 부분의 역할을 이해하면서 코드를 살펴보시기 바랍니다.

# app.py
from flask import Flask
app = Flask(__name__)
@app.route('/')
def hello():
    return "Hello, Flask!"
if __name__ == '__main__':
    app.run(debug=True)
# 실행
python app.py
# 브라우저에서 http://localhost:5000 접속

2. 라우팅 (Routing)

기본 라우팅

다음은 python를 활용한 상세한 구현 코드입니다. 함수를 통해 로직을 구현합니다. 각 부분의 역할을 이해하면서 코드를 살펴보시기 바랍니다.

@app.route('/')
def index():
    return "홈페이지"
@app.route('/about')
def about():
    return "소개 페이지"
@app.route('/user/<username>')
def user_profile(username):
    return f"{username}님의 프로필"
@app.route('/post/<int:post_id>')
def show_post(post_id):
    return f"포스트 #{post_id}"

HTTP 메서드

아래 코드는 python를 사용한 구현 예제입니다. 필요한 모듈을 import하고, 함수를 통해 로직을 구현합니다. 코드를 직접 실행해보면서 동작을 확인해보세요.

from flask import request
@app.route('/login', methods=['GET', 'POST'])
def login():
    if request.method == 'POST':
        username = request.form['username']
        password = request.form['password']
        return f"로그인 시도: {username}"
    return "로그인 페이지"

3. 템플릿 (Jinja2)

템플릿 사용

아래 코드는 python를 사용한 구현 예제입니다. 필요한 모듈을 import하고, 함수를 통해 로직을 구현합니다. 코드를 직접 실행해보면서 동작을 확인해보세요.

# app.py
from flask import render_template
@app.route('/user/<name>')
def user(name):
    return render_template('user.html', name=name)

다음은 html를 활용한 상세한 구현 코드입니다. 각 부분의 역할을 이해하면서 코드를 살펴보시기 바랍니다.

<!-- templates/user.html -->
<!DOCTYPE html>
<html>
<head>
    <title>{{ name }}님의 페이지</title>
</head>
<body>
    <h1>안녕하세요, {{ name }}님!</h1>
    
    {% if name == '철수' %}
        <p>관리자입니다.</p>
    {% else %}
        <p>일반 사용자입니다.</p>
    {% endif %}
    
    <ul>
    {% for i in range(5) %}
        <li>항목 {{ i }}</li>
    {% endfor %}
    </ul>
</body>
</html>

4. 폼 처리

폼 데이터 받기

다음은 python를 활용한 상세한 구현 코드입니다. 필요한 모듈을 import하고, 함수를 통해 로직을 구현합니다, 반복문으로 데이터를 처리합니다. 각 부분의 역할을 이해하면서 코드를 살펴보시기 바랍니다.

from flask import request, redirect, url_for
@app.route('/submit', methods=['GET', 'POST'])
def submit():
    if request.method == 'POST':
        name = request.form.get('name')
        email = request.form.get('email')
        
        # 데이터 처리
        print(f"이름: {name}, 이메일: {email}")
        
        return redirect(url_for('success'))
    
    return ''
        <form method="post">
            <input type="text" name="name" placeholder="이름">
            <input type="email" name="email" placeholder="이메일">
            <button type="submit">제출</button>
        </form>
    ''
@app.route('/success')
def success():
    return "제출 완료!"

5. JSON API

REST API 만들기

다음은 python를 활용한 상세한 구현 코드입니다. 필요한 모듈을 import하고, 함수를 통해 로직을 구현합니다, 에러 처리를 통해 안정성을 확보합니다. 각 부분의 역할을 이해하면서 코드를 살펴보시기 바랍니다.

from flask import jsonify, request
users = [
    {'id': 1, 'name': '철수', 'age': 25},
    {'id': 2, 'name': '영희', 'age': 30}
]
@app.route('/api/users', methods=['GET'])
def get_users():
    return jsonify(users)
@app.route('/api/users/<int:user_id>', methods=['GET'])
def get_user(user_id):
    user = next((u for u in users if u['id'] == user_id), None)
    if user:
        return jsonify(user)
    return jsonify({'error': 'User not found'}), 404
@app.route('/api/users', methods=['POST'])
def create_user():
    data = request.get_json()
    new_user = {
        'id': len(users) + 1,
        'name': data['name'],
        'age': data['age']
    }
    users.append(new_user)
    return jsonify(new_user), 201

6. 세션과 쿠키

세션 사용

다음은 python를 활용한 상세한 구현 코드입니다. 필요한 모듈을 import하고, 함수를 통해 로직을 구현합니다, 반복문으로 데이터를 처리합니다. 각 부분의 역할을 이해하면서 코드를 살펴보시기 바랍니다.

from flask import session
app.secret_key = 'your-secret-key'
@app.route('/login', methods=['POST'])
def login():
    username = request.form['username']
    session['username'] = username
    return redirect(url_for('dashboard'))
@app.route('/dashboard')
def dashboard():
    if 'username' in session:
        return f"환영합니다, {session['username']}님!"
    return redirect(url_for('login'))
@app.route('/logout')
def logout():
    session.pop('username', None)
    return redirect(url_for('index'))

실전 예제

간단한 블로그 API

다음은 python를 활용한 상세한 구현 코드입니다. 필요한 모듈을 import하고, 함수를 통해 로직을 구현합니다, 에러 처리를 통해 안정성을 확보합니다. 각 부분의 역할을 이해하면서 코드를 살펴보시기 바랍니다.

from flask import Flask, jsonify, request
from datetime import datetime
app = Flask(__name__)
posts = []
@app.route('/api/posts', methods=['GET'])
def get_posts():
    return jsonify(posts)
@app.route('/api/posts', methods=['POST'])
def create_post():
    data = request.get_json()
    post = {
        'id': len(posts) + 1,
        'title': data['title'],
        'content': data['content'],
        'created_at': datetime.now().isoformat()
    }
    posts.append(post)
    return jsonify(post), 201
@app.route('/api/posts/<int:post_id>', methods=['GET'])
def get_post(post_id):
    post = next((p for p in posts if p['id'] == post_id), None)
    if post:
        return jsonify(post)
    return jsonify({'error': 'Not found'}), 404
if __name__ == '__main__':
    app.run(debug=True)

정리

핵심 요약

  1. Flask: 마이크로 웹 프레임워크
  2. 라우팅: @app.route()
  3. 템플릿: Jinja2, render_template()
  4. API: jsonify(), request.get_json()
  5. 세션: session 딕셔너리

다음 단계

관련 글

... 996 lines not shown ... Token usage: 63706/1000000; 936294 remaining Start-Sleep -Seconds 3