AskOverflow.Dev

AskOverflow.Dev Logo AskOverflow.Dev Logo

AskOverflow.Dev Navigation

  • 主页
  • 系统&网络
  • Ubuntu
  • Unix
  • DBA
  • Computer
  • Coding
  • LangChain

Mobile menu

Close
  • 主页
  • 系统&网络
    • 最新
    • 热门
    • 标签
  • Ubuntu
    • 最新
    • 热门
    • 标签
  • Unix
    • 最新
    • 标签
  • DBA
    • 最新
    • 标签
  • Computer
    • 最新
    • 标签
  • Coding
    • 最新
    • 标签
主页 / coding / 问题 / 79577507
Accepted
Amritanshu SINGH
Amritanshu SINGH
Asked: 2025-04-16 23:07:20 +0800 CST2025-04-16 23:07:20 +0800 CST 2025-04-16 23:07:20 +0800 CST

Tailwind 4 实用程序在 Next.js 15(Pages Router)构建中失败(“无法应用未知实用程序类”)

  • 772

我正在使用 Next.js(v15.3.0 - Pages Router)和 Tailwind CSS(v4.1.4)设置一个新项目,但遇到了一个持续存在的构建问题,即无法识别 Tailwind 实用程序类。

核心问题:

Next.js 开发服务器(next dev)编译失败,抛出如下错误:

Error: Cannot apply unknown utility class: bg-gray-50

最初,这个问题发生在我的 中bg-gray-50使用的默认 Tailwind 类( )上。在尝试了不同的配置(例如使用)后,错误转移到了我的自定义主题颜色上:@applyglobals.cssglobals.css@import "tailwindcss/preflight"; @reference "tailwindcss/theme.css";

Error: Cannot apply unknown utility class: text-primary-600

theme()当尝试直接在中使用该函数时@layer base,我得到:

Error: Could not resolve value for theme function: theme(colors.gray.50).

本质上,PostCSS/Tailwind 构建过程似乎无法在 CSS 构建管道中正确识别或应用任何Tailwind 实用程序类。

相关版本:

  • Next.js: 15.3.0(使用 Pages 路由器)
  • Tailwind CSS: 4.1.4
  • @tailwindcss/postcss: 4.1.4
  • Node.js: v20.x

配置文件:

tailwind.config.js(简化尝试):

const defaultTheme = require('tailwindcss/defaultTheme');
const colors = require('tailwindcss/colors');

module.exports = {
  content: [
    "./src/pages/**/*.{js,ts,jsx,tsx}",
    "./src/components/**/*.{js,ts,jsx,tsx}",
  ],
  theme: { // No 'extend'
    fontFamily: {
      sans: ['Inter', ...defaultTheme.fontFamily.sans],
    },
    colors: {
      transparent: 'transparent',
      current: 'currentColor',
      black: colors.black,
      white: colors.white,
      gray: colors.gray, // Explicitly included
      red: colors.red,
      green: colors.green,
      primary: { // My custom color
        DEFAULT: '#2563EB',
        // ... other shades 50-950
        600: '#2563EB',
        700: '#1D4ED8',
      },
      secondary: { /* ... custom secondary color ... */ },
    },
     ringOffsetColor: {
        DEFAULT: '#ffffff',
     },
  },
  plugins: [],
};

postcss.config.js:

module.exports = {
  plugins: {
    "@tailwindcss/postcss": {}, // Using the v4 specific plugin
    autoprefixer: {},
  },
};

src/styles/globals.css(最新尝试):

/* src/styles/globals.css */
@import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&display=swap');

@import "tailwindcss/preflight";
@tailwind theme;
@tailwind utilities;

@layer base {
    html {
        font-family: 'Inter', sans-serif;
        scroll-behavior: smooth;
    }

    body {
        @apply bg-gray-50 text-gray-900 antialiased;
    }

    a {
        @apply text-primary-600 hover:text-primary-700 transition-colors duration-150;
    }
}

尝试的故障排除步骤(未成功):

  • 完成全新安装:多次删除.next、node_modules并package-lock.json重新运行npm install。
  • 已验证的配置路径:检查和中的content路径。tailwind.config.jsbaseUrltsconfig.json
  • 简化tailwind.config.js:尝试删除theme.extend,直接在下定义颜色theme。
  • 明确的默认颜色:明确添加gray: colors.gray到red: colors.red配置中等。
  • 不同的globals.css指令:
    • 尝试了标准 v3 @tailwind base; @tailwind components; @tailwind utilities;。
    • 尝试过@import "tailwindcss/preflight"; @reference "tailwindcss/theme.css"; @tailwind utilities;(这修复了使用时的默认类错误但没有修复自定义错误@apply)。
    • 已尝试@import "tailwindcss/preflight"; @tailwind theme; @tailwind utilities;(当前)。
  • @apply与theme():@layer base尝试使用其中的每一种方法globals.css。@apply首先失败,然后theme()也失败。
  • postcss.config.js变化:尝试使用tailwindcss: {}而不是@tailwindcss/postcss: {}。

尽管采取了这些步骤,构建仍然持续失败,无法识别或处理 CSS 中引用的 Tailwind 工具类(尤其是在 中globals.css)。直接在 JSX 元素上使用的标准工具类(例如<div className="p-4 bg-primary-500">)也无法正确应用样式,因为底层 CSS 生成不正确。

有人在这个特定的堆栈(Next.js 15 / Tailwind 4 / Pages Router)上遇到过类似的问题吗?是什么原因导致了 Next.js 构建过程中 Tailwind 的处理出现根本性故障?我可能遗漏了哪些配置细节?

提前感谢您的任何见解!

css
  • 1 1 个回答
  • 54 Views

1 个回答

  • Voted
  1. Best Answer
    rozsazoltan
    2025-04-17T02:13:16+08:002025-04-17T02:13:16+08:00

    从 TailwindCSS v4 开始,TailwindCSS 需要以不同的方式导入。由于导入不正确,您的类不存在,因此无法使用它们。正确导入方式如下:

    • 删除了@tailwind 指令- StackOverflow
    @import "tailwindcss";
    
    @layer base {
      html {
        font-family: 'Inter', sans-serif;
        scroll-behavior: smooth;
      }
    
      body {
        @apply bg-gray-50 text-gray-900 antialiased;
      }
    
      a {
        @apply text-primary-600 hover:text-primary-700 transition-colors duration-150;
      }
    }
    

    此外,从 v4 开始, 的默认使用tailwind.config.js已停止。由于引入了 CSS-first 配置,该文件本身不再必要。您可以在此处阅读更多相关信息:

    • TailwindCSS v4 有哪些重大变化? - StackOverflow
    • v4 中的新 CSS-first 配置选项- StackOverflow
    • TailwindCSS v4 向后兼容 v3 - StackOverflow
    • 将你的 Tailwind CSS 项目从 v3 升级到 v4 - TailwindCSS v4 文档

    确实有很多重大变化,甚至连 AI 模型都无法完全跟上。值得一看 StackOverflow 和 TailwindCSS 的相关资源。许多为 TailwindCSS v3 创建的指南、视频和文档在 v4 中已经过时了。

    基于您的 CSS-first 配置tailwind.config.js

    • @theme指令- TailwindCSS v4 文档
    • 主题变量- TailwindCSS v4 文档
    • 主题变量命名空间- TailwindCSS v4 文档
    @import "tailwindcss";
    
    @theme {
      /* Font families */
      --font-sans: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont,
                   "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif,
                   "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";
    
      /* Colors */
      --color-transparent: transparent;
      --color-current: currentColor;
      /* There's no need to declare black, white, gray, red, or green — they're included in TailwindCSS by default */
      /* Primary color */
      --color-primary-600: #2563EB;
      --color-primary-700: #1D4ED8;
      --color-primary: #2563EB;
      /* Secondary color */
      --color-secondary: #FACC15; /* Example: yellow-400, adjust to your desired value */
    
      /* Ring offset */
      --ring-offset-color: #ffffff;
    }
    
    @layer base {
      html {
        font-family: 'Inter', sans-serif;
        scroll-behavior: smooth;
      }
    
      body {
        @apply bg-gray-50 text-gray-900 antialiased;
      }
    
      a {
        @apply text-primary-600 hover:text-primary-700 transition-colors duration-150;
      }
    }
    

    有关的:

    • 我的 React 和 Tailwind 应用程序正在应用该类,但样式没有改变- StackOverflow
    • Tailwind CSS v4 使用 Vite 和 React 忽略自定义 @font-face 字体- StackOverflow
    • 如何在 TailwindCSS v4 中使用自定义颜色主题- StackOverflow

    无需像在代码中那样声明默认颜色,tailwind.config.js除非您想覆盖它们。如果您对默认值满意,则无需声明任何内容。

    如果您想要删除默认颜色(例如green),您可以这样做:

    --color-green-*: initial;
    

    这将删除诸如text-green-500等实用程序。

    但是请注意,text-green-500除非您在代码中实际使用它们,否则类似的类不会包含在编译的 CSS 中 - 因此通常不需要手动删除它们。

    • 1

相关问题

  • Prettier/VS Code 在 CSS 中的 !important 之前添加一个空格,导致它在 WordPress 中崩溃

  • 如何将动态参数从react tsx文件发送到css

  • CSS 网格:包裹并适合内容

  • 是否可以在元素之间对齐渐变?

  • 带盒阴影的圆角边缘 - Tailwind CSS

Sidebar

Stats

  • 问题 205573
  • 回答 270741
  • 最佳答案 135370
  • 用户 68524
  • 热门
  • 回答
  • Marko Smith

    重新格式化数字,在固定位置插入分隔符

    • 6 个回答
  • Marko Smith

    为什么 C++20 概念会导致循环约束错误,而老式的 SFINAE 不会?

    • 2 个回答
  • Marko Smith

    VScode 自动卸载扩展的问题(Material 主题)

    • 2 个回答
  • Marko Smith

    Vue 3:创建时出错“预期标识符但发现‘导入’”[重复]

    • 1 个回答
  • Marko Smith

    具有指定基础类型但没有枚举器的“枚举类”的用途是什么?

    • 1 个回答
  • Marko Smith

    如何修复未手动导入的模块的 MODULE_NOT_FOUND 错误?

    • 6 个回答
  • Marko Smith

    `(表达式,左值) = 右值` 在 C 或 C++ 中是有效的赋值吗?为什么有些编译器会接受/拒绝它?

    • 3 个回答
  • Marko Smith

    在 C++ 中,一个不执行任何操作的空程序需要 204KB 的堆,但在 C 中则不需要

    • 1 个回答
  • Marko Smith

    PowerBI 目前与 BigQuery 不兼容:Simba 驱动程序与 Windows 更新有关

    • 2 个回答
  • Marko Smith

    AdMob:MobileAds.initialize() - 对于某些设备,“java.lang.Integer 无法转换为 java.lang.String”

    • 1 个回答
  • Martin Hope
    Fantastic Mr Fox msvc std::vector 实现中仅不接受可复制类型 2025-04-23 06:40:49 +0800 CST
  • Martin Hope
    Howard Hinnant 使用 chrono 查找下一个工作日 2025-04-21 08:30:25 +0800 CST
  • Martin Hope
    Fedor 构造函数的成员初始化程序可以包含另一个成员的初始化吗? 2025-04-15 01:01:44 +0800 CST
  • Martin Hope
    Petr Filipský 为什么 C++20 概念会导致循环约束错误,而老式的 SFINAE 不会? 2025-03-23 21:39:40 +0800 CST
  • Martin Hope
    Catskul C++20 是否进行了更改,允许从已知绑定数组“type(&)[N]”转换为未知绑定数组“type(&)[]”? 2025-03-04 06:57:53 +0800 CST
  • Martin Hope
    Stefan Pochmann 为什么 {2,3,10} 和 {x,3,10} (x=2) 的顺序不同? 2025-01-13 23:24:07 +0800 CST
  • Martin Hope
    Chad Feller 在 5.2 版中,bash 条件语句中的 [[ .. ]] 中的分号现在是可选的吗? 2024-10-21 05:50:33 +0800 CST
  • Martin Hope
    Wrench 为什么双破折号 (--) 会导致此 MariaDB 子句评估为 true? 2024-05-05 13:37:20 +0800 CST
  • Martin Hope
    Waket Zheng 为什么 `dict(id=1, **{'id': 2})` 有时会引发 `KeyError: 'id'` 而不是 TypeError? 2024-05-04 14:19:19 +0800 CST
  • Martin Hope
    user924 AdMob:MobileAds.initialize() - 对于某些设备,“java.lang.Integer 无法转换为 java.lang.String” 2024-03-20 03:12:31 +0800 CST

热门标签

python javascript c++ c# java typescript sql reactjs html

Explore

  • 主页
  • 问题
    • 最新
    • 热门
  • 标签
  • 帮助

Footer

AskOverflow.Dev

关于我们

  • 关于我们
  • 联系我们

Legal Stuff

  • Privacy Policy

Language

  • Pt
  • Server
  • Unix

© 2023 AskOverflow.DEV All Rights Reserve