Webpack 集成 Stylus 预处理器配置指南

作者：测试鸭

时间：2026-10-31

本文介绍如何在 Webpack 项目中集成 Stylus 预处理器。通过安装 stylus-loader 包，在 module.rules 中添加对应规则，并在入口文件 main.js 中引入 .styl 文件，即可实现 Stylus 到 CSS 的自动编译与打包。

文章目录

首先需要准备必要的依赖包。

执行命令安装 stylus-loader： npm i stylus-loader

了解该工具的核心功能。

stylus-loader 的主要作用是将 Stylus 源代码编译转换为标准的 CSS 代码。

接下来进行具体的 Webpack 配置。

const path = require('path');//nodejs用来处理路径问题的模块
module.exports = {
    /**入口 */
    entry: './src/main.js',
    /**输出 相对路径*/
    output: {
        /**文件输出路径 绝对路径*/
        //__dirname 表示当前文件的文件夹目录
        path: path.resolve(__dirname, 'dist'),
        /**文件名 */
        filename: 'dist.js'
    },
    /**加载器 */
    module: {
        rules: [
            //loader的配置
            {
                /**test 代表要检测的文件 */
                test: /\.css$/, //只检测.css文件
                use: ['style-loader', 'css-loader'],//对检测到文件使用哪些loader
            },
            {
                test: /\.less$/,//只检测.less文件
                //loader:'xxx',loader只能使用一个loader，use可以使用多个loader
                use: ['style-loader', 'css-loader', 'less-loader'],//对检测到文件使用哪些loader
            },
            {
                test: /\.s[ac]ss$/,//只检测.sass文件
                use: ['style-loader', 'css-loader', 'sass-loader'],
            },
            {
                test: /\.styl$/,//只检测.stylus文件
                use: ['style-loader', 'css-loader', 'stylus-loader']
            }
        ]
    },
    /**插件 */
    plugins: [
        //plugin配置
    ],
    /**模式 */
    mode: 'development'
}

在 webpack.config.js 的 module.rules 数组中，新增一条针对 .styl 文件的处理规则。

创建一个新的 Stylus 样式文件。

.box
 width 100px
 height 100px
 background-color:brown

在项目的入口文件 main.js 中，通过 import 语句引入刚才创建的 .styl 文件。

import sum from "./js/sum";
import count from "./js/count";
//要想webpack打包资源，必须引入该资源
import "./css/file.css"
import "./css/box.less"
import "./css/box2.scss"
import "./css/box3.styl"
console.log(count(1, 2));
console.log(sum(1, 2, 3, 4, 5))

在 HTML 模板中，使用定义好的样式类（如 box3）来应用样式。

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>webpack</title>
</head>
<body>
    <script src="../../dist/dist.js"></script>
    <h1>hell webpack</h1>
    <div class="red"></div>
    <div class="box"></div>
    <div class="box2"></div>
    <div class="box3"></div>
</body>
</html>

运行 npx webpack 命令执行打包操作。

首先需要准备必要的依赖包。