在Next.js 14项目中如何将Shadcn主题强制设为浅色？

1. 修改Tailwind配置禁用系统深色模式检测 #

打开项目根目录的tailwind.config.ts（或.js），将darkMode设为false，让Tailwind不再响应系统的深色模式偏好：

/** @type {import('tailwindcss').Config} */
export default {
  darkMode: false,
  content: [
    "./pages/**/*.{js,ts,jsx,tsx,mdx}",
    "./components/**/*.{js,ts,jsx,tsx,mdx}",
    "./app/**/*.{js,ts,jsx,tsx,mdx}",
  ],
  theme: {
    extend: {},
  },
  plugins: [],
}

2. 全局覆盖深色媒体查询样式 #

在app/globals.css中添加以下代码，强制重置所有prefers-color-scheme: dark下的样式变量为浅色主题值：

@media (prefers-color-scheme: dark) {
  :root {
    --background: 0 0% 100%;
    --foreground: 222.2 84% 4.9%;
    --card: 0 0% 100%;
    --card-foreground: 222.2 84% 4.9%;
    --popover: 0 0% 100%;
    --popover-foreground: 222.2 84% 4.9%;
    --primary: 222.2 47.4% 11.2%;
    --primary-foreground: 210 40% 98%;
    --secondary: 210 40% 96.1%;
    --secondary-foreground: 222.2 47.4% 11.2%;
    --muted: 210 40% 96.1%;
    --muted-foreground: 215.4 16.3% 46.9%;
    --accent: 210 40% 96.1%;
    --accent-foreground: 222.2 47.4% 11.2%;
    --destructive: 0 84.2% 60.2%;
    --destructive-foreground: 210 40% 98%;
    --border: 214.3 31.8% 91.4%;
    --input: 214.3 31.8% 91.4%;
    --ring: 222.2 84% 4.9%;
  }
}

3. 确保根布局不添加dark类 #

检查app/layout.tsx中的<html>标签，不要添加dark类，也不要保留任何动态切换主题的逻辑：

export default function RootLayout({
  children,
}: {
  children: React.ReactNode
}) {
  return (
    <html lang="zh-CN">
      <body className="min-h-screen bg-background text-foreground">
        {children}
      </body>
    </html>
  )
}

4. 局部覆盖残留深色样式 #

如果个别组件仍有深色样式残留，可直接通过className强制覆盖：

<Card className="bg-white text-gray-900">
  <CardContent>内容区域</CardContent>
</Card>

内容的提问来源于stack exchange，提问作者GʀᴜᴍᴘʏCᴀᴛ