根本原因是@forward默认不暴露本文件定义的变量或混合宏，必须用as 或as prefix-显式导出；若只转发部分成员需with声明；工具包入口应组合@use与@forward以兼容多种导入方式。
为什么 @forward 转发后外部仍找不到变量或混合宏
根本原因不是语法写错，而是转发时没加 as * 或没显式导出。Sass 默认只转发模块内 @use 进来的成员，不自动暴露本文件定义的 $var、@mixin、@function。比如你在 _utils.scss 里写了 $spacing-xs: 4px;，仅靠 @forward "utils"; 不会让使用者通过 @use "index" as * 拿到它。
- 必须用
@forward "utils" as utils-*;或@forward "utils" as *;才能暴露本模块定义的成员 -
as *是最常用做法，但会污染命名空间；更安全的是as utils-*;，这样使用者得写utils-spacing-xs - 如果只想转发部分成员，要用
with显式声明：@forward "utils" with ($spacing-xs as $s-xs);
如何让一个 Sass 工具包支持 @use 和 @forward 双模式
用户可能用 @use "kit"，也可能用 @use "kit" as k，甚至想直接 @use "kit" as *。要兼容，入口文件（如 index.scss）不能只写 @forward，还得补一层 @use + @forward 组合。
- 入口文件里先
@use "core" as core，再@forward "core" as core-*;—— 这样既保留命名空间访问路径，又支持通配符导入 - 避免在入口文件里定义任何新变量或 mixin，所有逻辑下沉到子模块，否则转发规则容易失控
- 若工具包需向下兼容旧项目（还在用
@import），别指望@forward能起作用：@import和@use是两套隔离系统
@forward 的 with 参数改名后，函数调用报 Undefined function
这是典型的作用域混淆：改名只影响转发出口，不影响原函数内部对其他成员的引用。比如你把 color.scale-lightness() 转发为 lighten-color()，但它内部仍依赖未被转发的 $colors，就会报错。
-
with只改名，不重绑定作用域 —— 原函数运行时仍查找它所在模块的变量 - 解决方法是确保被转发模块自身已完整
@use所有依赖，或在with中一并重映射依赖项：@forward "color" with ($colors as $colors); - 调试技巧：临时删掉
with，用原始名称测试是否能跑通，确认问题出在改名还是依赖缺失
构建 CSS 工具包时，哪些内容不该用 @forward 暴露
不是所有东西都适合转发。过度暴露会让使用者误用内部实现细节，也增加未来重构成本。
立即学习“前端免费学习笔记（深入）”；
- 带下划线前缀的私有成员（如
$_breakpoint-config）绝不应出现在@forward中 —— Sass 没强制私有机制，全靠约定 - 未加文档说明的 mixin（比如没写参数含义、适用场景）不要转发，否则别人用了出问题你得背锅
- 实验性功能（如
@use "experimental/grid" as grid）建议单独建入口，别混进主index.scss，避免稳定版被破坏
真正难的不是怎么转，是怎么决定哪些不转。很多人卡在“全转出去省事”，结果半年后想删个变量，发现二十个项目里都散落着它的引用。
