Flask模块化应用：Blueprints架构、启动配置与路由最佳实践

/TestProj/
├── .flaskenv             # Flask环境变量配置
├── TestProj.py          # 应用启动入口
├── config.py            # 全局配置
├── __init__.py          # 主应用工厂函数
└── /test_app/           # 模块化应用（Blueprint）
     ├── __init__.py      # Blueprint定义
     ├── views.py         # Blueprint视图函数
     ├── /static/         # Blueprint静态文件
     └── /templates/      # Blueprint模板

# /TestProj/__init__.py
from flask import Flask
from .test_app import test_app # 导入Blueprint实例

def create_app(test_config=None):
    """
    创建并配置Flask应用实例。
    """
    app = Flask(__name__)

    # 可以根据需要加载配置
    if test_config:
        app.config.from_mapping(test_config)
    else:
        # 默认配置，例如从config.py加载
        app.config.from_pyfile('config.py', silent=True)

    # 注册Blueprint
    # sub_domain参数可用于为Blueprint指定子域名
    app.register_blueprint(test_app, subdomain='test')

    # 其他应用级别的配置或路由可以在这里添加

    return app

# /TestProj/test_app/__init__.py
from flask import Blueprint

# 定义一个名为 'test' 的Blueprint
# __name__ 用于定位资源（如模板和静态文件）
# template_folder 和 static_folder 指定了Blueprint的资源路径
test_app = Blueprint('test', __name__,
                     template_folder='templates',
                     static_folder='static')

# 导入视图，确保视图函数被注册到此Blueprint
from . import views

# /TestProj/test_app/views.py
from . import test_app
from flask import render_template
from random import randint

@test_app.route('/')
def test_app_index():
    """
    test_app Blueprint的根路由。
    """
    return 'Hello from Test App!'

@test_app.route('/random')
def get_random_number():
    """
    一个示例路由，返回随机数。
    """
    return f'Random number: {randint(1, 100)}'

# /TestProj.py (位于项目根目录，与/TestProj文件夹同级)
from TestProj import create_app

# 调用create_app工厂函数，创建Flask应用实例
# 可以在这里传入配置，例如：app = create_app({'DEBUG': True})
app = create_app()

# 注意：这里不需要运行 app.run()，因为 flask run 命令会处理

.flaskenv
TestProj.py            # 新增文件
/TestProj/
├── config.py
├── __init__.py
└── /test_app/
     ├── __init__.py
     ├── views.py
     ├── /static
     └── /templates

# .flaskenv
FLASK_APP=TestProj.py  # 指向你的应用启动文件
FLASK_DEBUG=1          # 启用调试模式，便于开发

flask run

# /TestProj/main/__init__.py (假设你创建了一个名为 main 的新目录)
from flask import Blueprint, render_template

main_bp = Blueprint('main', __name__, template_folder='templates')

@main_bp.route('/')
def index():
    return render_template('index.html') # 或者直接返回 'Welcome to the main page!'

# /TestProj/__init__.py
from flask import Flask
from .test_app import test_app
from .main import main_bp # 导入主Blueprint

def create_app(test_config=None):
    app = Flask(__name__)
    # ... 其他配置 ...

    app.register_blueprint(test_app, subdomain='test')
    app.register_blueprint(main_bp) # 注册主Blueprint

    return app

# /TestProj/__init__.py
from flask import Flask
from .test_app import test_app

def create_app(test_config=None):
    app = Flask(__name__)
    # ... 其他配置 ...

    app.register_blueprint(test_app, subdomain='test')

    # 直接在应用实例上定义根路由
    @app.route('/')
    def main_index():
        return 'Welcome to the main application!'

    return app