Table of Contents

34 修复 admin-ui SCSS 变量导入生产白屏

背景与目标
最终方案
修改文件
验收结果
测试
相关提交
用户验收

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

34 修复 admin-ui SCSS 变量导入生产白屏

类型：缺陷
所属 Epic：#3
所属 MVP / 版本：#19 / MVP-1
状态：已完成
日期：2026-08-23
Gitea 工单：#34
Wiki 页面：Task-34-修复-admin-ui-SCSS-变量导入生产白屏
Wiki revision：见在线页面 revision

背景与目标

runtime 资源修复后，正式包继续在 Vuex settings 初始化阶段因读取 undefined.theme 白屏。根因是四处把普通 SCSS 当作 JS 默认对象导入，构建器已明确报告不存在 default export。

最终方案

新增集中运行时样式常量文件，将 store、layout 与 sidebar 的四处导入切换到 JS 常量；数值与原 SCSS 保持一致，SCSS 继续只负责样式。

修改文件

admin-ui/src/styles/runtime-variables.js：集中主题、侧栏颜色与宽度常量。
admin-ui/src/store/modules/settings.js、src/layout/：改用运行时常量。
admin-ui/tests/unit/styles/runtime-variables.spec.js：锁定关键主题值。

验收结果

验收标准	结果
不再从 SCSS 导入运行时对象	通过
主题与侧栏值保持不变	通过
unit、lint、正式构建	通过
Chromium 登录页无运行时异常	通过

测试

pnpm test:unit --runInBand：10 suites、35 tests 全部通过。
pnpm lint：0 error，98 条既有 warning。
正式构建通过；SCSS default export warning 从 2 条消除，构建基线剩 4 条非本任务 warning。
隔离 MySQL + Chromium：页面无异常，登录及 Provider 列表安全回归通过。
未验证部分：未做全部后台旧页面的人工视觉遍历；颜色常量与原值一致，核心 layout/sidebar 已随登录后 Provider 页面加载。

用户验收

结果：通过。
确认人：用户。
确认时间：2026-08-24。