还在为Flask项目该新建几个文件、文件夹放哪而头疼吗？据观察，超过70%的Flask初学者都曾因混乱的目录结构，在项目规模扩大时陷入维护地狱！
本文为你清晰梳理Flask项目在不同规模（小型、中型、大型）下的标准目录结构，并提供实际开发环境的配置建议。你将学到：
- 小型单文件应用的极简组织法
- 中型项目“应用工厂模式”的标准布局
- 大型项目如何进行模块化（蓝图）拆分
- 实际开发中如何管理配置、依赖与部署文件
文末提供一个可直接复制使用的中型项目模板。
目录 📚
一、单刀直入：小型项目结构
二、井井有条：中型项目结构
三、分而治之：大型项目结构
四、精益求精：实际开发环境要点
五、实战模板：一个开箱即用的目录
一、单刀直入：小型项目结构 🎯
当你有一个简单的想法，比如做个计数器、留言板，或者只想快速验证某个功能时，“一个文件搞定一切”是最佳选择。这能让你专注于逻辑，而非结构。
mini_app/
├── app.py # 所有代码都在这里：路由、逻辑、甚至简单HTML
├── requirements.txt # 项目依赖（flask）
└── .gitignore在app.py里，你可能会直接写HTML字符串或使用Jinja2模板。这种方式优势在于简单直观，但缺点同样明显：一旦功能增多，文件会迅速膨胀到难以阅读和维护。所以，它仅适用于不超过5个路由、无需复杂模型的微型应用。
二、井井有条：中型项目结构 🏗️
这是Flask最经典、最推荐的项目结构，适用于大多数Web应用（如博客、后台管理系统）。其核心是“应用工厂模式”（Application Factory），将创建App的逻辑独立出来，使配置、扩展初始化、蓝图注册变得清晰。
medium_project/
├── app/ # 应用核心包
│ ├── __init__.py # 应用工厂所在地
│ ├── models.py # 数据模型定义
│ ├── routes/ # 路由控制器（可存放多个视图文件）
│ │ ├── __init__.py
│ │ ├── auth.py # 认证相关路由
│ │ └── main.py # 主要页面路由
│ ├── static/ # 静态资源（CSS, JS, 图片）
│ │ ├── css/
│ │ └── js/
│ ├── templates/ # Jinja2模板
│ │ ├── base.html
│ │ ├── index.html
│ │ └── auth/
│ └── extensions.py # 集中初始化Flask扩展（如SQLAlchemy, Login）
├── migrations/ # 数据库迁移脚本（如使用Flask-Migrate）
├── tests/ # 单元测试
├── config.py # 配置文件（开发、测试、生产）
├── requirements.txt # 依赖列表
├── .env # 环境变量（切勿提交！）
├── .gitignore
└── run.py # 启动脚本（用于本地开发）关键文件解析：
- app/__init__.py：这是心脏。它定义一个 create_app(config_name) 函数，根据传入的配置名（如‘development’）创建Flask app实例，并完成扩展初始化、蓝图注册等所有设置工作。
- extensions.py：将 db = SQLAlchemy() 等扩展对象定义在此处但不初始化，避免循环导入。在工厂函数中统一初始化。
- config.py：使用类来组织不同环境的配置，通过环境变量切换，保证安全性。
- run.py：一个极简的启动入口，通常只有两行：从app包导入工厂函数，然后 app = create_app('development')。
这个结构平衡了清晰度和复杂度，是团队协作和项目成长的坚实基础。
三、分而治之：大型项目结构 🚀
当项目变成一个平台，包含用户、商品、订单、后台等多个相对独立的子系统时，就需要“蓝图”（Blueprint）进行更彻底的模块化。每个功能模块成为一个独立的包，拥有自己的路由、模板、静态文件甚至模型。
large_project/
├── app/
│ ├── __init__.py # 应用工厂
│ ├── extensions.py
│ ├── common/ # 公共组件（如工具函数、表单、装饰器）
│ ├── static/ # 全局静态资源
│ ├── templates/ # 全局模板
│ │ └── layout.html
│ └── modules/ # 核心！功能模块目录
│ ├── auth/ # 认证模块
│ │ ├── __init__.py
│ │ ├── routes.py
│ │ ├── models.py
│ │ └── templates/ # 模块专属模板
│ │ └── auth/
│ ├── admin/ # 后台管理模块
│ └── api/v1/ # API模块（可版本化）
│ ├── __init__.py
│ └── user.py
├── config/
│ ├── __init__.py
│ ├── development.py
│ └── production.py # 配置也模块化
├── scripts/ # 部署或管理脚本
├── requirements/
│ ├── base.txt # 通用依赖
│ ├── dev.txt # 开发依赖
│ └── prod.txt # 生产依赖
└── run.py这种结构的精髓在于：
- 高内聚，低耦合：每个模块只关心自己的功能，通过蓝图接口与主应用交互。
- 易于团队分工：不同团队可以负责不同的模块，并行开发。
- 便于复用和剥离：一个成熟的模块可以相对容易地移植到其他项目。
在应用工厂中，你需要遍历 modules 目录，动态或显式地注册每一个蓝图。
四、精益求精：实际开发环境要点 🛠️
好的结构是骨架，而实际开发环境是血肉。以下几点能让你的项目更健壮：
- 虚拟环境是必须的：永远不要污染系统Python环境。使用 venv 或 pipenv 创建隔离环境。
- 依赖管理：使用 pip freeze > requirements.txt 生成依赖清单。对于大型项目，可以像上面一样拆分为 base.txt、dev.txt（包含测试、调试工具）、prod.txt。
- 环境变量与配置：敏感信息（如SECRET_KEY, 数据库密码）必须通过 .env 文件加载（使用 python-dotenv），并将 .env 加入 .gitignore。在 config.py 中通过 os.getenv() 读取。
- 启动与部署：开发时用 flask run 或 python run.py。生产环境务必使用 Gunicorn 或 uWSGI 搭配 Nginx。项目根目录应包含 Dockerfile 和 docker-compose.yml（如需容器化）。
- 日志：在应用工厂中配置好日志，区分不同级别和输出文件，便于线上排查问题。
五、实战模板：一个开箱即用的目录 🎁
这里提供一个基于中型项目结构的、可直接复制使用的模板，包含基础配置和注释：
# 文件：config.py
import os
from dotenv import load_dotenvload_dotenv() # 加载.env文件中的环境变量class Config:SECRET_KEY = os.getenv('SECRET_KEY', 'a-default-dev-key')SQLALCHEMY_TRACK_MODIFICATIONS = Falseclass DevelopmentConfig(Config):DEBUG = TrueSQLALCHEMY_DATABASE_URI = os.getenv('DEV_DATABASE_URL', 'sqlite:///dev.db')class ProductionConfig(Config):SQLALCHEMY_DATABASE_URI = os.getenv('DATABASE_URL')# 其他生产环境配置...config = {'development': DevelopmentConfig,'production': ProductionConfig,'default': DevelopmentConfig
}# 文件：app/__init__.py
from flask import Flask
from .extensions import db, login_manager
from .routes.main import main_bp
from .routes.auth import auth_bp
import osdef create_app(config_name=None):app = Flask(__name__)# 加载配置if config_name is None:config_name = os.getenv('FLASK_CONFIG', 'default')from config import configapp.config.from_object(config[config_name])# 初始化扩展db.init_app(app)login_manager.init_app(app)# 注册蓝图app.register_blueprint(main_bp)app.register_blueprint(auth_bp, url_prefix='/auth')return app# 文件：app/extensions.py
from flask_sqlalchemy import SQLAlchemy
from flask_login import LoginManager# 先创建扩展对象，但不绑定app
db = SQLAlchemy()
login_manager = LoginManager()
login_manager.login_view = 'auth.login'你可以直接复制这个框架，然后填充你的模型、视图和业务逻辑。
喜欢本文？点赞👍收藏⭐，关注我，一起学习更多有用的知识，完善你的技能树！