python-development-python-scaffold

Python 项目脚手架

技能概述

快速生成生产级 Python 项目结构，支持 FastAPI、Django、CLI 工具和 Python 库等多种项目类型，使用 uv 等现代工具自动化项目初始化。

适用场景

快速启动 API 项目

从零开始搭建 FastAPI 或 Django 应用，自动生成完整的项目目录结构、配置文件、路由设置和数据库模型，大幅减少手动配置时间。

开发 Python CLI 工具

创建命令行应用程序，内置 typer 和 rich 支持，自动配置入口点和命令行参数解析，快速构建用户友好的终端工具。

构建可复用 Python 库

搭建可发布的 Python 包，包含类型提示文件（py.typed）、测试配置和发布设置，确保库项目符合 PyPI 最佳实践。

核心功能

智能项目类型识别

根据需求自动选择合适的项目模板：FastAPI 适用于 REST API 和异步应用，Django 适合需要后台管理的全栈 Web 应用，Library 模板面向可复用包开发。

现代开发工具集成

预配置 uv 作为包管理器，集成 ruff 进行代码检查和格式化，设置 pytest 测试框架，包含 pydantic-settings 环境配置管理，开箱即用。

完整项目结构生成

生成标准化的目录布局，包含源代码、测试、配置文件、环境变量示例、Makefile 和 README，确保项目符合 Python 社区最佳实践。

常见问题

Python 项目脚手架是什么？

Python 项目脚手架是一种自动化工具，用于快速生成标准化的 Python 项目结构。它会创建合理的目录布局、配置文件、测试设置和开发工具配置，让开发者跳过重复的初始化工作，直接进入业务逻辑开发。

如何用 uv 快速创建 Python 项目？

使用 uv init <project-name> 命令即可初始化新项目，然后运行 uv venv 创建虚拟环境。脚手架会自动生成 pyproject.toml 配置文件，包含项目依赖和开发工具设置。相比传统的 pip + venv 方式，uv 速度更快且配置更简洁。

FastAPI 和 Django 项目模板有什么区别？

FastAPI 模板专注于异步 API 开发，目录结构包含 api、core、schemas 和 services 分层，适合微服务和 RESTful API。Django 模板则包含完整的 MTV 架构配置，内置 ORM 和管理后台，更适合需要数据库管理功能的传统 Web 应用。

不支持哪些项目类型？

本脚手架专注于 Python 后端项目，不包含前端框架（如 React、Vue）的配置。对于数据科学项目、机器学习模型部署或 Jupyter Notebook 工作流，建议使用专门的科学计算模板工具。