基于 FastAPI 的企业级 Python Web 框架
像 ThinkPHP 一样简单易用，享受 FastAPI 的高性能

快速开始 • 功能特性 • 项目结构 • 配置说明 • 文档中心 • 常见问题

✅ 零学习成本 - 如果你用过 ThinkPHP、Spring Boot，你会感觉非常熟悉
✅ 快速开发 - 一条命令生成 CRUD 三层代码，专注业务逻辑
✅ 生产就绪 - 内置日志、异常处理、缓存、JWT 认证等企业级功能
✅ 灵活扩展 - 支持多种数据库、多种缓存，小项目大项目都能胜任

# GitHub
git clone https://github.com/hongxinge/ThinkPython.git
cd ThinkPython

# 或 Gitee（国内镜像，更快）
git clone https://gitee.com/hongxinge/think-python.git
cd think-python

pip install -r requirements.txt

python think.py run

🎉 零配置启动：默认使用 SQLite + 内存缓存，无需修改任何配置！

ThinkPython/
├── app/                          # 应用目录（你主要在这里写代码）
│   ├── common/                   # 公共模块（跨模块共享代码）
│   ├── single/                   # 单模块模式（默认）
│   ├── admin/                    # 后台管理模块（多模块）
│   └── api/                      # API 模块（多模块）
├── config/                       # 配置目录
├── core/                         # 核心框架层
├── helpers/                      # 助手函数
├── router/                       # 路由管理（自动注册）
├── middleware/                   # 中间件
├── utils/                        # 工具类（Excel、文件）
├── uploads/                      # 上传文件目录
├── think.py                      # CLI 命令行工具
├── main.py                       # 应用入口
└── requirements.txt              # 依赖包列表

所有配置通过 .env 文件管理（从 .env.example 复制）：

⚠️ 安全提醒：生产环境务必修改 JWT_SECRET 为强密钥！

python think.py run                  # 启动服务器
python think.py make-crud user       # 根据数据库表结构生成 CRUD 三层代码
python think.py make-controller User # 创建控制器
python think.py make-model User      # 创建数据模型
python think.py make-service User    # 创建服务层
python think.py make-module order    # 创建新模块
python think.py db-migrate           # 数据库迁移
python think.py list-routes          # 列出所有路由

💡 make-crud：配置好数据库后，一条命令 python think.py make-crud user 即可根据 user 表结构自动生成 Model、Controller、Service 三层完整代码，包含字段类型、注释、Pydantic 验证等，详见 make-crud 文档。

完整教程已移至 docs/ 目录，按需查阅：

{
  "code": 200,
  "message": "success",
  "data": {}
}

修改 .env：

MODULE_MODE=multi
ENABLED_MODULES=admin,api

默认在 ./data/database.db，会自动创建。

在控制器中配置白名单：

class AuthController(BaseController):
    SKIP_AUTH_ROUTES = ["POST /auth/login", "POST /auth/register"]

详见 认证机制文档。

DB_ECHO=True

ThinkPython 支持多种部署方式，按需选择：

完整的部署配置示例请参考 deploy/ 目录，包含 Dockerfile、docker-compose.yml、Gunicorn 配置、Nginx 配置等。

ThinkPython 采用 MIT License 开源协议，完全免费，可商用。

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/your-feature)
3. 提交改动 (git commit -m 'Add your feature')
4. 推送分支 (git push origin feature/your-feature)
5. 提交 Pull Request

ThinkPython - 让 Python Web 开发更简单 🐍