@forward仅控制外部访问权限而不导入变量，需用as显式暴露成员，多处转发同名变量会报错，统一收口或with重命名可解决冲突。
@forward不是导出，是接口门禁
很多人写完 @forward "colors" 就以为 $primary-color 会自动出现在当前文件里，结果编译报错 Undefined variable "$primary-color"。这不是路径错，也不是拼写错，而是根本误解了 @forward 的作用：它不把变量“搬进来”，只决定“外面的人”能不能、以什么方式访问它。
比如你在 _theme.scss 中写了：
@use "colors";<br>@forward "colors";
这行 @forward 只告诉使用者：“如果你 @use "theme"，那你可以访问 colors 模块的成员”——但前提是，你得显式声明怎么暴露：
-
@forward "colors" as *;→ 使用者@use "theme" as *;后可直接用$primary-color -
@forward "colors" as color-*;→ 使用者必须写color-primary-color - 如果
_theme.scss自己定义了$spacing-md: 16px;，但没在@forward中声明，那它永远不会被外部看到
多处转发同名变量会报错，不是bug是保护
当你在入口 index.scss 里同时 @forward "utils/spacing" 和 @forward "components/card"，而两者都含 $radius-sm，Sass 编译器会直接报 "$radius-sm" is already used。这不是配置问题，是设计使然——它在阻止你无意中暴露冲突的命名。
立即学习“前端免费学习笔记（深入）”；
常见触发场景：
-
@forward "a" show $radius-sm;+@forward "b" show $radius-sm; - 两个组件模块各自定义并转发了同名断点或间距变量
解决办法只有两个：
PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。
- 把这类基础变量统一收口到
core/vars，其他模块只@use不转发 - 用
with显式重命名：@forward "a" with ($radius-sm as $a-radius-sm);
支持 @use "kit" 和 @use "kit" as * 要靠组合写法
单靠 @forward 无法同时兼容命名空间导入和通配符导入。入口文件（如 index.scss）必须先 @use 子模块，再 @forward 它们，并且自身不能定义任何新变量或 mixin。
正确写法：
@use "core/variables" as core;<br>@use "utils/mixins" as utils;<br>@forward "core/variables" as core-*;<br>@forward "utils/mixins" as utils-*;
这样使用者就有三种选择：
-
@use "index" as i;→ 用i.core-primary-color -
@use "index" as *;→ 直接用$primary-color和@include text-truncate -
@use "index" as kit;→ 用kit.core-primary-color
关键点：入口文件只是中转站，所有逻辑必须下沉到子模块；否则转发规则会失控，比如你在 index.scss 里加了一行 $tmp: 12px;，它不会被转发，还可能干扰内部依赖链。
@forward 后函数调用报 Undefined function，大概率是作用域没理清
你用 @forward "color" with (color.scale-lightness() as lighten-color)，结果调用 lighten-color() 报错。这不是改名失败，而是原函数内部仍依赖未被转发的 $colors 变量——with 只改名，不重绑定作用域。
调试建议：
- 先删掉
with，用原始名color.scale-lightness()测试是否能跑通，确认是依赖缺失还是改名问题 - 确保被转发模块自身已完整
@use所有依赖，或在with中一并重映射：@forward "color" with ($colors as $colors); - 避免转发带下划线前缀的私有成员（如
$_breakpoint-config），它们本就不该暴露
真正容易被忽略的是：@forward 的路径必须真实存在，不能靠 package.json 或别名自动解析；VS Code 的 SCSS 插件跳转不到转发内容，这是已知局限，不是你配错了。
