Cookiecutter：用一个命令从模板生成整个项目

Cookiecutter：用一个命令从模板生成整个项目

开发新项目时，重复的配置和目录结构总是让人头疼。Cookiecutter 就是专门解决这个问题的工具，它在 GitHub 上有近 2.5 万 Star，是很多开发者的项目脚手架首选。

这工具是干什么的

简单说，Cookiecutter 是一个命令行工具，能根据预设模板一键生成完整的项目结构。比如你想新建一个 Python 包，不用手动创建 setup.py、tests/、src/ 这些目录和文件，运行一条命令，填几个参数，项目骨架就出来了。

它的模板来源很灵活。可以用 GitHub 上的远程模板，也可以用本地的模板目录。社区已经积累了大量现成的模板，覆盖 Python 包、Django 项目、Pytest 插件等各种场景。

用法足够简单

安装只需要一行命令，通过 uv 工具链直接装：

uv tool install cookiecutter

使用模板也很直接。以 cookiecutter-pypackage 为例：

uvx cookiecutter gh:audreyfeldroy/cookiecutter-pypackage

运行后它会依次问你项目名称、作者、版本号等信息，回答完就自动在当前目录生成完整的项目结构。整个过程不到一分钟。

如果你更喜欢在 Python 代码里调用，也可以直接 import：

from cookiecutter.main import cookiecutter
cookiecutter('cookiecutter-pypackage/')

模板机制是怎么工作的

一个 Cookiecutter 模板本质上就是一个目录，里面放了一个 cookiecutter.json 文件。这个 JSON 文件定义了所有变量和默认值，比如项目名、作者邮箱、许可证类型等。

模板目录里的文件和文件夹名可以用变量占位，比如 {{cookiecutter.project_name}}/。生成项目时，这些占位符会被替换成你输入的实际值。

更实用的是钩子机制。模板作者可以在生成项目前后插入脚本，自动执行 git init、安装依赖等操作，把初始化流程也自动化了。

为什么它值得用

第一，省时间。每次新建项目都要重复相同的目录结构和配置文件，用模板一键生成能省掉大量重复劳动。

第二，标准化。团队内部可以维护统一的项目模板，保证所有人生成的项目结构一致，代码规范、测试配置都在模板里提前定好。

第三，门槛低。用这工具不需要懂 Python，命令行交互很友好，按提示回答几个问题就行。当然，如果你要编写自己的模板，还是需要了解一些基本规则的。

实际使用中要注意的

Cookiecutter 的模板生态很丰富，但质量参差不齐。选模板时建议先看下 Star 数和最近更新时间，优先选社区维护活跃的。

另外，模板变量设计直接影响使用体验。好的模板会提供合理的默认值，问题描述也清晰。如果你打算写自己的模板，建议多参考几个热门项目的 cookiecutter.json 设计。

这工具支持 Windows、Mac、Linux 三个平台，兼容 Python 3.10 到 3.14。对经常需要从零搭建项目的开发者来说，它能切实减少重复工作。