您正在浏览 Nuxt 2 文档。前往 Nuxt 3 文档, 或了解更多关于 Nuxt 2 长期支持


css 属性

Nuxt 允许配置全局应用(包含在所有页面中)的 CSS 文件/模块/库。


如果想使用 sass,请安装 sasssass-loader 包。如果尚未安装,请按如下方式安装:

Yarn
yarn add --dev sass sass-loader@10
NPM
npm install --save-dev sass sass-loader@10
  • 类型: Array
    • 元素: string
nuxt.config.js
export default {
  css: [
    // 直接加载 Node.js 模块(此处为 Sass 文件)
    'bulma',
    // 项目中的 CSS 文件
    '@/assets/css/main.css',
    // 项目中的 SCSS 文件
    '@/assets/css/main.scss'
  ]
}

Nuxt 会自动从扩展名推断文件类型,并使用适当的预处理器 loader。但仍需自行安装所需的 loader。

样式扩展名

可以省略 nuxt.config.js 的 css 数组中文件(CSS/SCSS/Postcss/Less/Stylus/...)的扩展名。

nuxt.config.js
export default {
  css: ['~/assets/css/main', '~/assets/css/animations']
}
如果有两个同名文件,如 main.scssmain.css,且在 css 数组中未指定扩展名(如 css: ['~/assets/css/main']),则只会加载一个文件,顺序取决于 styleExtensions。默认 styleExtension 数组中 css 排在第一位,因此 css 文件会被加载,scss 文件会被忽略。

默认顺序:['css', 'pcss', 'postcss', 'styl', 'stylus', 'scss', 'sass', 'less']

Edit this page on GitHub Updated at Tue, Apr 14, 2026