React+Webpack项目构建时Sass-loader解析Bootstrap Sass报错

我用React、Webpack、Bootstrap和Sass搭建页面，执行Webpack打包时，sass-loader解析Bootstrap官方Sass文件夹内的_maps.scss文件抛出错误。我通过styles.scss文件导入Bootstrap的Sass文件并覆盖其变量，项目目录结构和错误信息对应原始提问附带的截图。以下是报错的_maps.scss代码：

// Re-assigned maps
//
// Placed here so that others can override the default Sass maps and see automatic updates to utilities and more.

// scss-docs-start theme-colors-rgb
$theme-colors-rgb: map-loop($theme-colors, to-rgb, "$value") !default;
// scss-docs-end theme-colors-rgb

$theme-colors-text: (
  "primary": $primary-text,
  "secondary": $secondary-text,
  "success": $success-text,
  "info": $info-text,
  "warning": $warning-text,
  "danger": $danger-text,
  "light": $light-text,
  "dark": $dark-text,
) !default;

$theme-colors-bg-subtle: (
  "primary": $primary-bg-subtle,
  "secondary": $secondary-bg-subtle,
  "success": $success-bg-subtle,
  "info": $info-bg-subtle,
  "warning": $warning-bg-subtle,
  "danger": $danger-bg-subtle,
  "light": $light-bg-subtle,
  "dark": $dark-bg-subtle,
) !default;

$theme-colors-border-subtle: (
  "primary": $primary-border-subtle,
  "secondary": $secondary-border-subtle,
  "success": $success-border-subtle,
  "info": $info-border-subtle,
  "warning": $warning-border-subtle,
  "danger": $danger-border-subtle,
  "light": $light-border-subtle,
  "dark": $dark-border-subtle,
) !default;

// Utilities maps
//
// Extends the default `$theme-colors` maps to help create our utilities.

// Come v6, we'll de-dupe these variables. Until then, for backward compatibility, we keep them to reassign.
// scss-docs-start utilities-colors
$utilities-colors: $theme-colors-rgb !default;
// scss-docs-end utilities-colors

// scss-docs-start utilities-text-colors
$utilities-text: map-merge(
  $utilities-colors,
  (
    "black": to-rgb($black),
    "white": to-rgb($white),
    "body": to-rgb($body-color)
  )
) !default;
$utilities-text-colors: map-loop($utilities-text, rgba-css-var, "$key", "text") !default;

$utilities-text-emphasis-colors: (
  "primary-emphasis": var(--#{$prefix}primary-text),
  "secondary-emphasis": var(--#{$prefix}secondary-text),
  "success-emphasis": var(--#{$prefix}success-text),
  "info-emphasis": var(--#{$prefix}info-text),
  "warning-emphasis": var(--#{$prefix}warning-text),
  "danger-emphasis": var(--#{$prefix}danger-text),
  "light-emphasis": var(--#{$prefix}light-text),
  "dark-emphasis": var(--#{$prefix}dark-text)
) !default;
// scss-docs-end utilities-text-colors

// scss-docs-start utilities-bg-colors
$utilities-bg: map-merge(
  $utilities-colors,
  (
    "black": to-rgb($black),
    "white": to-rgb($white),
    "body": to-rgb($body-bg)
  )
) !default;
$utilities-bg-colors: map-loop($utilities-bg, rgba-css-var, "$key", "bg") !default;

$utilities-bg-subtle: (
  "primary-subtle": var(--#{$prefix}primary-bg-subtle),
  "secondary-subtle": var(--#{$prefix}secondary-bg-subtle),
  "success-subtle": var(--#{$prefix}success-bg-subtle),
  "info-subtle": var(--#{$prefix}info-bg-subtle),
  "warning-subtle": var(--#{$prefix}warning-bg-subtle),
  "danger-subtle": var(--#{$prefix}danger-bg-subtle),
  "light-subtle": var(--#{$prefix}light-bg-subtle),
  "dark-subtle": var(--#{$prefix}dark-bg-subtle)
) !default;
// $utilities-bg-subtle-colors: map-loop($utilities-bg-subtle, rgba-css-var, "$key", "bg") !default;
// scss-docs-end utilities-bg-colors

// scss-docs-start utilities-border-colors
$utilities-border: map-merge(
  $utilities-colors,
  (
    "white": to-rgb($white)
  )
) !default;
$utilities-border-colors: map-loop($utilities-border, rgba-css-var, "$key", "border") !default;

$utilities-border-subtle: (
  "primary-subtle": var(--#{$prefix}primary-border-subtle),
  "secondary-subtle": var(--#{$prefix}secondary-border-subtle),
  "success-subtle": var(--#{$prefix}success-border-subtle),
  "info-subtle": var(--#{$prefix}info-border-subtle),
  "warning-subtle": var(--#{$prefix}warning-border-subtle),
  "danger-subtle": var(--#{$prefix}danger-border-subtle),
  "light-subtle": var(--#{$prefix}light-border-subtle),
  "dark-subtle": var(--#{$prefix}dark-border-subtle)
) !default;
// scss-docs-end utilities-border-colors

$negative-spacers: if($enable-negative-margins, negativify-map($spacers), null) !default;

$gutters: $spacers !default;

1. 修正styles.scss的导入顺序 #

报错核心原因是Bootstrap的内置Sass函数（比如map-loop、to-rgb）未被提前加载，正确的导入顺序必须是：

• 先导入Bootstrap的functions.scss（提供核心函数）
• 再覆盖自定义变量
• 最后导入Bootstrap的其他Sass文件（包括_maps.scss）

示例styles.scss代码：

// 1. 先导入Bootstrap核心函数
@import "../node_modules/bootstrap/scss/functions";

// 2. 在这里覆盖Bootstrap变量（比如自定义主题色、间距等）
$primary: #2563eb;
$theme-colors: (
  "primary": $primary,
  "secondary": #6b7280
);

// 3. 导入Bootstrap剩余的基础文件
@import "../node_modules/bootstrap/scss/variables";
@import "../node_modules/bootstrap/scss/maps";
@import "../node_modules/bootstrap/scss/mixins";
@import "../node_modules/bootstrap/scss/root";

// 或者直接导入完整的Bootstrap（变量覆盖必须在这之前）
// @import "../node_modules/bootstrap/scss/bootstrap";

2. 检查Webpack的sass-loader配置 #

确保使用Dart Sass（Node Sass已废弃，Bootstrap 5+仅支持Dart Sass），并配置正确的includePaths：

module.exports = {
  module: {
    rules: [
      {
        test: /\.s[ac]ss$/i,
        use: [
          "style-loader", // 把CSS插入DOM
          "css-loader", // 解析CSS
          {
            loader: "sass-loader",
            options: {
              implementation: require("sass"), // 指定用dart-sass
              sassOptions: {
                includePaths: ["node_modules/bootstrap/scss"], // 让Sass能找到Bootstrap的文件
              },
            },
          },
        ],
      },
    ],
  },
};

3. 确认依赖版本兼容性 #

• 安装/升级Dart Sass：npm install sass --save
• 确保Bootstrap是5.x及以上版本：npm install bootstrap@latest --save
• 保证sass-loader和当前Webpack版本匹配（可查看sass-loader官方文档确认版本对应关系）

内容的提问来源于stack exchange，提问作者gokul-0hno