ThinkPython - 让 Python Web 开发更简单 🐍

📌 核心标语

像 ThinkPHP 一样简单易用，享受 FastAPI 的高性能

🎯 一句话介绍

ThinkPython 是一款基于 FastAPI 的企业级 Python Web 框架，专为有 PHP/Java 背景的开发者设计，零学习成本迁移，开箱即用。

---

✨ 核心亮点

1. 零学习成本，秒上手

• 如果你用过 ThinkPHP、Spring Boot，你会感觉非常熟悉
• 三层架构（Controller / Service / Model）清晰分层
• 路由自动注册，无需手动配置

2. 一条命令生成 CRUD 代码

• 配置好数据库后，python think.py make-crud user
• 自动生成 Model、Controller、Service 三层完整代码
• 包含字段类型、注释、Pydantic 验证，开箱即用

3. 企业级功能内置

• JWT 认证：全局中间件 + 白名单，配置一次即可
• 多数据库：MySQL / PostgreSQL / SQLite / MSSQL 一键切换
• 多缓存：Redis / Memory / Memcached 灵活选择
• Excel 工具：内置导入导出，支持样式、自动列宽
• 文件工具：内置上传下载，支持格式验证、UUID 命名

4. 高性能

• 基于 FastAPI + Uvicorn，异步支持
• 性能是传统 Flask 框架的 10-100 倍
• 原生支持 async/await，轻松应对高并发

5. 灵活扩展

• 单/多模块切换：小项目用单模块，大项目用多模块
• 完整 CLI 工具：类似 ThinkPHP 的 think 命令
• 生产就绪：内置日志、异常处理、统一响应格式

---

📊 技术栈

组件	技术	版本要求
Web 框架	FastAPI	>= 0.115
异步服务器	Uvicorn	>= 0.32
ORM	SQLAlchemy	>= 2.0
数据验证	Pydantic	>= 2.10
认证	PyJWT	>= 2.9
Excel 处理	openpyxl	>= 3.1

---

🚀 快速开始（3 步搞定）

# 1. 克隆项目
git clone https://gitee.com/hongxinge/think-python.git
cd think-python
pip install -r requirements.txt

# 2. 启动（零配置，默认 SQLite + 内存缓存）
python think.py run

# 3. 访问文档
浏览器打开 http://localhost:8000/docs

---

💡 适用场景

场景	推荐理由
新手学习	零配置启动，结构清晰，文档完善
快速原型	CLI 工具一键生成代码，专注业务逻辑
中小项目	轻量级架构，SQLite + Memory 开箱即用
企业项目	JWT 认证、多数据库、多模块支持
API 服务	FastAPI 高性能，原生异步，自动生成 API 文档

---

📈 性能对比

框架	请求/秒	延迟 (ms)	学习曲线
Flask	~2,000	~50	低
Django	~1,500	~80	高
ThinkPython	~20,000	~5	低
FastAPI	~20,000	~5	中

基于简单 GET 请求的基准测试数据

---

🎓 面向人群

• PHP 开发者转 Python：ThinkPHP 的使用者会感觉如回家一般
• Java Spring Boot 开发者：熟悉的三层架构，减少学习成本
• Python 新手：结构简单，文档完善，3 分钟上手
• 全栈开发者：快速搭建 API，前端分离架构的理想选择

---

📚 文档与教程

文档	说明
README	项目简介、快速开始、功能特性
5 分钟创建 API	从零开始创建完整 CRUD 接口
数据库配置	MySQL / PostgreSQL / SQLite 配置
认证机制	JWT 认证、免验证路由配置
make-crud	一键生成 CRUD 三层代码
多模块模式	项目拆分与模块管理
Excel 工具	Excel 导入导出使用指南

---

🏗️ 项目结构

ThinkPython/
├── app/                          # 应用目录（写代码主要区域）
│   ├── common/                   # 公共模块（跨模块共享代码）
│   ├── single/                   # 单模块模式（默认）
│   ├── admin/                    # 后台管理模块
│   └── api/                      # API 模块
├── config/                       # 配置目录（数据库、缓存、认证）
├── core/                         # 核心框架层
├── helpers/                      # 助手函数
├── utils/                        # 工具类（Excel、文件）
├── think.py                      # CLI 命令行工具
└── main.py                       # 应用入口

---

🔧 CLI 工具速查

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          # 列出所有路由

---

📦 统一响应格式

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

---

⭐ 为什么选择 ThinkPython？

痛点	ThinkPython 解决方案
Flask 太灵活，结构不清晰	强制三层架构，规范代码组织
Django 太重，学习成本高	轻量级设计，3 分钟上手
FastAPI 缺少项目模板	完整项目结构，开箱即用
每次新项目都要搭框架	脚手架工具，一键生成
认证配置繁琐	全局中间件 + 白名单，配置一次

---

🤝 开源协议

ThinkPython 采用 MIT License 开源协议：

• ✅ 完全免费
• ✅ 可商用
• ✅ 可修改
• ✅ 无限制

---

📮 联系方式

• Gitee: https://gitee.com/hongxinge/think-python
• • Github: https://github.com/hongxinge/ThinkPython
• Stars: ⭐ 欢迎 Star & Fork
• Issues: 欢迎提交 Issue 和 PR
• 协议: MIT License

---

🎉 立即体验

git clone https://gitee.com/hongxinge/think-python.git
cd think-python
pip install -r requirements.txt
python think.py run

3 分钟，开启你的 Python Web 高效开发之旅！

---

ThinkPython - 让 Python Web 开发更简单 🐍
基于 FastAPI 的企业级 Python Web 框架
MIT License · 完全免费 · 开箱即用