timonweb/django-tailwind

这是什么？

核心功能

• 01在 Django 项目中一键生成可直接使用的 Tailwind 应用。
• 02独立二进制模式无需安装 Node.js。
• 03CSS、Tailwind 配置和 Django 模板支持热重载。
• 04一条命令同时启动 Django 与 Tailwind 开发服务器。
• 05可选集成 DaisyUI 预置组件。
• 06提供安装 Tailwind 插件的管理命令。

适用场景

• 在无需 JavaScript 构建流程的情况下，为现有 Django 网站添加 Tailwind 样式。
• 借助工具类和实时重载快速原型化 Django 模板。
• 在没有或不便安装 Node.js 的机器上开发 Django 项目。

快速上手

1. 1

   安装带推荐扩展的 django-tailwind

   pip install 'django-tailwind[cookiecutter,honcho,reload]'
2. 2

   在 settings.py 的 INSTALLED_APPS 中添加 "tailwind"

3. 3

   创建 Tailwind 应用

   python manage.py tailwind init
4. 4

   安装 Tailwind CSS 依赖

   python manage.py tailwind install

使用前须知

• !需要 Python 3.11 或更高版本以及 Django 5.2 或更高版本。
• !npm 安装模式需要 Node.js 22 或更高版本。

标签

常见问题

django-tailwind 是什么？

为 Django 项目集成 Tailwind CSS 的应用，支持无需 Node.js 的独立二进制模式。 django-tailwind 用于在 Django 项目中接入 Tailwind CSS。`tailwind init` 命令会生成一个默认名为 theme 的 Django 应用，其中包含 Tailwind 的配置和 CSS 文件；`tailwind install` 和 `tailwind dev` 分别负责安装依赖和开发调试。

django-tailwind 可以免费使用吗？用的什么许可证？

django-tailwind 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

django-tailwind 还在维护吗？

活跃维护中。django-tailwind 最近一次提交是在 2026年10月15日。

django-tailwind 适合用来做什么？

在无需 JavaScript 构建流程的情况下，为现有 Django 网站添加 Tailwind 样式。 借助工具类和实时重载快速原型化 Django 模板。 在没有或不便安装 Node.js 的机器上开发 Django 项目。

django-tailwind 怎么安装和运行？

安装带推荐扩展的 django-tailwind: pip install 'django-tailwind[cookiecutter,honcho,reload]' 在 settings.py 的 INSTALLED_APPS 中添加 "tailwind" 创建 Tailwind 应用: python manage.py tailwind init 安装 Tailwind CSS 依赖: python manage.py tailwind install

在哪里获取 django-tailwind？

源代码和安装说明在 GitHub 上：https://github.com/timonweb/django-tailwind