AskOverflow.Dev

AskOverflow.Dev Logo AskOverflow.Dev Logo

AskOverflow.Dev Navigation

  • Início
  • system&network
  • Ubuntu
  • Unix
  • DBA
  • Computer
  • Coding
  • LangChain

Mobile menu

Close
  • Início
  • system&network
    • Recentes
    • Highest score
    • tags
  • Ubuntu
    • Recentes
    • Highest score
    • tags
  • Unix
    • Recentes
    • tags
  • DBA
    • Recentes
    • tags
  • Computer
    • Recentes
    • tags
  • Coding
    • Recentes
    • tags
Início / coding / Perguntas / 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

Falha nos utilitários do Tailwind 4 ("Não é possível aplicar classe de utilitário desconhecida") na compilação do Next.js 15 (roteador de páginas)

  • 772

Estou configurando um novo projeto usando Next.js (v15.3.0 - Pages Router) e Tailwind CSS (v4.1.4) e encontrei um problema de compilação persistente em que as classes de utilitários do Tailwind não estão sendo reconhecidas.

O problema central:

O servidor de desenvolvimento Next.js ( next dev) falha ao compilar, gerando erros como:

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

Inicialmente, isso acontecia com as classes padrão do Tailwind ( bg-gray-50) usadas @applyno meu globals.css. Depois de testar configurações diferentes globals.css(como usar @import "tailwindcss/preflight"; @reference "tailwindcss/theme.css";), o erro passou para as cores do meu tema personalizado :

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

Ao tentar usar a theme()função diretamente em @layer base, recebo:

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

Basicamente, parece que o processo de construção do PostCSS/Tailwind não está reconhecendo ou aplicando nenhuma classe de utilitário do Tailwind corretamente dentro do pipeline de construção do CSS.

Versões relevantes:

  • Next.js: 15.3.0 (Usando o roteador de páginas)
  • Tailwind CSS: 4.1.4
  • @tailwindcss/postcss: 4.1.4
  • Node.js: v20.x

Arquivos de configuração:

tailwind.config.js(Tentativa simplificada):

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(Última tentativa):

/* 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;
    }
}

Etapas de solução de problemas tentadas (sem sucesso):

  • Instalações limpas completas:.next , node_modulese , foram excluídos várias vezes package-lock.jsone executados novamente npm install.
  • Caminhos de configuração verificados:content caminhos verificados em tailwind.config.jse baseUrlem tsconfig.json.
  • Simplificado tailwind.config.js: Tentei remover theme.extende definir cores diretamente em theme.
  • Cores padrão explícitas: adicionadas explicitamente gray: colors.gray, red: colors.redetc. à configuração.
  • Diretivas diferentes globals.css:
    • Testei o padrão v3 @tailwind base; @tailwind components; @tailwind utilities;.
    • Testado @import "tailwindcss/preflight"; @reference "tailwindcss/theme.css"; @tailwind utilities;(isso corrigiu erros de classe padrão, mas não os personalizados ao usar @apply).
    • Testado @import "tailwindcss/preflight"; @tailwind theme; @tailwind utilities;(atual).
  • @applyvs. theme(): Tentei usar cada um desses métodos dentro @layer basede globals.css. @applyfalhou primeiro, depois theme()também.
  • postcss.config.jsVariações: Tentei usar tailwindcss: {}em vez de @tailwindcss/postcss: {}.

Apesar dessas etapas, a compilação falha consistentemente, incapaz de reconhecer ou processar classes de utilitários do Tailwind referenciadas em CSS (especialmente em globals.css). Classes de utilitários padrão usadas diretamente em elementos JSX (por exemplo, <div className="p-4 bg-primary-500">) também falham em aplicar estilos corretamente porque o CSS subjacente não é gerado corretamente.

Alguém já encontrou problemas semelhantes com esta pilha específica (Next.js 15 / Tailwind 4 / Pages Router)? O que pode estar causando essa falha fundamental no processamento do Tailwind na compilação do Next.js? Alguma sutileza de configuração que eu possa estar ignorando?

Agradecemos antecipadamente por qualquer informação!

css
  • 1 1 respostas
  • 54 Views

1 respostas

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

    Desde o TailwindCSS v4, o TailwindCSS precisa ser importado de forma diferente. Devido a uma importação incorreta, suas classes não existiam, então você não pôde usá-las. Veja como deveria ficar corretamente:

    • Diretivas @tailwind removidas - 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;
      }
    }
    

    Além disso, a partir da versão 4, o uso padrão de tailwind.config.jsfoi descontinuado. O arquivo em si não é mais necessário, pois foi introduzida uma configuração CSS-first. Você pode ler mais sobre isso aqui:

    • Quais são as principais mudanças do TailwindCSS v4? - StackOverflow
    • Nova opção de configuração CSS-first na v4 - StackOverflow
    • TailwindCSS v4 é compatível com versões anteriores da v3 - StackOverflow
    • Atualizando seus projetos Tailwind CSS de v3 para v4 - TailwindCSS v4 Docs

    De fato, houve muitas mudanças drásticas que nem mesmo os modelos de IA conseguiram acompanhar completamente. Vale a pena consultar os recursos do StackOverflow e do TailwindCSS sobre isso. Muitos guias, vídeos e documentação criados para o TailwindCSS v3 ficaram desatualizados na v4.

    Configuração CSS-first baseada em seutailwind.config.js

    • @themediretiva - Documentação do TailwindCSS v4
    • Variáveis ​​de tema - Documentação do TailwindCSS v4
    • Namespaces de variáveis ​​de tema - Documentação do 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;
      }
    }
    

    Relacionado:

    • Meus aplicativos React e Tailwind estão aplicando a classe, mas o estilo não muda - StackOverflow
    • Fonte @font-face personalizada ignorada pelo Tailwind CSS v4 com Vite e React - StackOverflow
    • Como usar temas de cores personalizados no TailwindCSS v4 - StackOverflow

    Não há necessidade de declarar cores padrão — como você fez tailwind.config.js— a menos que queira substituí-las. Se estiver satisfeito com os valores padrão, não precisa declarar nada.

    Se você quiser remover uma cor padrão (por exemplo, green), você pode fazer isso assim:

    --color-green-*: initial;
    

    Isso removerá utilitários como text-green-500, etc.

    Entretanto, observe que text-green-500classes semelhantes não são incluídas no CSS compilado, a menos que você as utilize em seu código. Portanto, removê-las manualmente geralmente não é necessário.

    • 1

relate perguntas

  • Prettier/VS Code adicionando um espaço antes de !important no CSS, causando quebra no WordPress

  • Como enviar parâmetros dinâmicos do arquivo react tsx para css

  • Grade CSS: agrupar e ajustar ao conteúdo

  • É possível alinhar gradientes entre elementos?

  • Bordas arredondadas com Box Shadow - Tailwind CSS

Sidebar

Stats

  • Perguntas 205573
  • respostas 270741
  • best respostas 135370
  • utilizador 68524
  • Highest score
  • respostas
  • Marko Smith

    Reformatar números, inserindo separadores em posições fixas

    • 6 respostas
  • Marko Smith

    Por que os conceitos do C++20 causam erros de restrição cíclica, enquanto o SFINAE antigo não?

    • 2 respostas
  • Marko Smith

    Problema com extensão desinstalada automaticamente do VScode (tema Material)

    • 2 respostas
  • Marko Smith

    Vue 3: Erro na criação "Identificador esperado, mas encontrado 'import'" [duplicado]

    • 1 respostas
  • Marko Smith

    Qual é o propósito de `enum class` com um tipo subjacente especificado, mas sem enumeradores?

    • 1 respostas
  • Marko Smith

    Como faço para corrigir um erro MODULE_NOT_FOUND para um módulo que não importei manualmente?

    • 6 respostas
  • Marko Smith

    `(expression, lvalue) = rvalue` é uma atribuição válida em C ou C++? Por que alguns compiladores aceitam/rejeitam isso?

    • 3 respostas
  • Marko Smith

    Um programa vazio que não faz nada em C++ precisa de um heap de 204 KB, mas não em C

    • 1 respostas
  • Marko Smith

    PowerBI atualmente quebrado com BigQuery: problema de driver Simba com atualização do Windows

    • 2 respostas
  • Marko Smith

    AdMob: MobileAds.initialize() - "java.lang.Integer não pode ser convertido em java.lang.String" para alguns dispositivos

    • 1 respostas
  • Martin Hope
    Fantastic Mr Fox Somente o tipo copiável não é aceito na implementação std::vector do MSVC 2025-04-23 06:40:49 +0800 CST
  • Martin Hope
    Howard Hinnant Encontre o próximo dia da semana usando o cronógrafo 2025-04-21 08:30:25 +0800 CST
  • Martin Hope
    Fedor O inicializador de membro do construtor pode incluir a inicialização de outro membro? 2025-04-15 01:01:44 +0800 CST
  • Martin Hope
    Petr Filipský Por que os conceitos do C++20 causam erros de restrição cíclica, enquanto o SFINAE antigo não? 2025-03-23 21:39:40 +0800 CST
  • Martin Hope
    Catskul O C++20 mudou para permitir a conversão de `type(&)[N]` de matriz de limites conhecidos para `type(&)[]` de matriz de limites desconhecidos? 2025-03-04 06:57:53 +0800 CST
  • Martin Hope
    Stefan Pochmann Como/por que {2,3,10} e {x,3,10} com x=2 são ordenados de forma diferente? 2025-01-13 23:24:07 +0800 CST
  • Martin Hope
    Chad Feller O ponto e vírgula agora é opcional em condicionais bash com [[ .. ]] na versão 5.2? 2024-10-21 05:50:33 +0800 CST
  • Martin Hope
    Wrench Por que um traço duplo (--) faz com que esta cláusula MariaDB seja avaliada como verdadeira? 2024-05-05 13:37:20 +0800 CST
  • Martin Hope
    Waket Zheng Por que `dict(id=1, **{'id': 2})` às vezes gera `KeyError: 'id'` em vez de um TypeError? 2024-05-04 14:19:19 +0800 CST
  • Martin Hope
    user924 AdMob: MobileAds.initialize() - "java.lang.Integer não pode ser convertido em java.lang.String" para alguns dispositivos 2024-03-20 03:12:31 +0800 CST

Hot tag

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

Explore

  • Início
  • Perguntas
    • Recentes
    • Highest score
  • tag
  • help

Footer

AskOverflow.Dev

About Us

  • About Us
  • Contact Us

Legal Stuff

  • Privacy Policy

Language

  • Pt
  • Server
  • Unix

© 2023 AskOverflow.DEV All Rights Reserve