typescript默认不识别scss/css模块，需通过declare module '*.module.scss'声明类型并确保tsconfig.json包含该声明文件，才能解决cannot find module错误并支持类型检查与补全。
tsconfig.json 不处理 CSS/Sass 文件
TypeScript 编译器 tsc 默认只识别 .ts、.tsx、.d.ts 文件，对 .scss 或 .module.scss 完全无感知。即使你写了 import styles from './Button.module.scss'，tsc 会直接报错 Cannot find module './Button.module.scss'（ts2307），因为它根本没被纳入模块解析流程。
SCSS 文件需要两层“翻译”才能进 TypeScript 类型系统
SCSS 本身是预处理器语言，必须先编译成 CSS；而 CSS Modules 输出的是 JS 对象（如 { primary: "Button_primary__abc123" }），TypeScript 需要明确知道这个对象的结构——否则无法做类型检查或自动补全。
- 第一层：构建工具（Vite/Webpack）把
.module.scss编译为 JS 模块导出 - 第二层：TypeScript 需要声明该模块的形状（shape），即
declare module '*.module.scss'
这两步缺一不可。只配 Sass 编译器（sass CLI）不解决 TS 类型问题；只写 declare module 而不配构建工具，文件压根不会被加载。
如果你了解HTML，CSS和JavaScript，您已经拥有所需的工具开发Android应用程序。本动手本书展示了如何使用这些开源web标准设计和建造，可适应任何Android设备的应用程序 - 无需使用Java。您将学习如何创建一个在您选择的平台的Android友好的网络应用程序，然后转换与自由PhoneGap框架到一个原生的Android应用程序。了解为什么设备无关的移动应用是未来的潮流，并开始构建应用程序，提供更
Vite 和 Webpack 的 CSS Modules 配置不等于 TS 类型声明
比如 Vite 默认支持 .module.scss 加载，但它的作用仅限于运行时生成类名对象——它不会自动生成或注入 TypeScript 的类型定义。你依然得手动告诉 TS：“这类文件导出的是一个字符串映射对象”。
- 常见错误：以为开了
css.modules选项就万事大吉，结果编辑器里styles.xxx仍标红 - 典型遗漏：没在
src/custom.d.ts或全局types.d.ts中写declare module '*.module.scss' - 陷阱点：如果用了
typescript-plugin-css-modules，它会动态生成类型，但要求插件在tsconfig.json的plugins数组中正确注册，且不能与手动声明冲突
SCSS 变量和混合宏无法被 TypeScript 直接消费
Sass 的 $color-primary、@mixin button-base 是构建时概念，运行时不存在。TypeScript 无法读取它们，也不能做类型推导。这意味着：
- 你在 TS 里写
const themeColor = $color-primary是非法的——Sass 变量不进入 JS 作用域 - 想让 TS 知道主题色取值范围，得靠手动同步定义
type ThemeColor = 'primary' | 'secondary' - 更稳妥的做法是用
export从 SCSS 导出 JSON（如通过sass --style=expanded --load-path=node_modules+ 自定义 importer），再在 TS 里import该 JSON ——但这已脱离标准流程，容易出错
真正容易被忽略的是：Sass 和 TypeScript 分属不同编译阶段，变量、函数、类型三者之间没有自动桥接机制。任何跨语言的“共享”都得靠显式约定或额外脚本维护。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
