如何让Tailwind的@apply指令在Django静态CSS文件中生效？

@apply 指令需要经过Tailwind编译器处理才能生效，直接放在未编译的静态CSS文件里无法被识别，按以下步骤排查修复：

• 将自定义CSS纳入Tailwind编译流程
  找到django-tailwind生成的主题应用（默认是theme）里的入口CSS文件（一般为src/styles.css），先导入Tailwind基础类，再引入你的自定义静态CSS：

  @tailwind base;
  @tailwind components;
  @tailwind utilities;
  
  /* 根据你的项目路径调整导入路径，确保能定位到自定义CSS文件 */
  @import "../../../static/css/你的自定义样式文件.css";
  

• 检查@apply的写法规范
  @apply必须用在自定义CSS类内部，不能直接全局使用：

  /* 正确示例 */
  .custom-btn {
    @apply bg-green-600 hover:bg-green-700 text-white rounded-lg px-4 py-2;
  }
  
  /* 错误示例：直接全局使用@apply不会生效 */
  @apply text-red-500;
  

• 重新编译Tailwind样式
  在项目根目录运行编译命令，让Tailwind处理你的自定义CSS：

  python manage.py tailwind build
  

  开发阶段可以用tailwind start实时监听文件变化并自动编译：

  python manage.py tailwind start
  

• 模板中引用编译后的CSS文件
  不要直接引用原始的静态CSS，要引用编译后的文件（默认在主题应用的static/css/dist/styles.css路径下）：

  {% load static %}
  <link rel="stylesheet" href="{% static 'css/dist/styles.css' %}">
  

• 验证配置正确性
  检查settings.py里的TAILWIND_APP_NAME是否正确指向你的主题应用：

  TAILWIND_APP_NAME = 'theme'
  

内容的提问来源于stack exchange，提问作者Cesar