根本原因是TypeScript默认将.module.css视为Record<string, string>，无法推断具体类名；必须通过declare module '*.module.css'声明类型或工具自动生成.d.ts文件，并确保VSCode使用工作区TypeScript版本。
为什么 import styles from './X.module.css' 后点不了类名跳转
根本原因不是插件没装，而是 TypeScript 默认完全不认识 .module.css 文件导出什么——styles 被当成 Record<string string></string> 这种宽泛类型，VSCode 没法推断 styles.button 对应 CSS 文件里的哪个选择器。即使你装了 CSS Modules 插件，只要类型信息缺失，跳转和提示就只是“尽力而为”，大概率失败。
必须让 TypeScript 知道 CSS 文件导出了哪些类名
这是唯一稳定路径。不靠插件“猜”，而是用类型声明告诉 TS：.module.css 导出的键就是文件里定义的类名。操作很简单：
- 在项目根目录或
src下新建types/css-modules.d.ts（确保它被tsconfig.json的include覆盖） - 写入：
declare module '*.module.css' { const classes: Record<string, string>; export default classes; } - 如果用了
composes或需要更精确的类型（比如类名驼峰化），改用@types/css-modules包，或配合css-modules-typescript-loader自动生成类型
注意：declare module '*.css' 不行，必须精确匹配 .module.css 后缀；否则 Webpack 的普通 CSS 和 CSS Modules 会冲突。
VSCode 必须用工作区 TypeScript 版本
哪怕类型声明写了，VSCode 仍可能用内置 TS 服务（不读你项目里的 node_modules/typescript），导致声明无效。确认方法：右下角点击 TypeScript 版本号，必须显示 Workspace version。
立即学习“前端免费学习笔记（深入）”；
- 在项目根目录
.vscode/settings.json中强制指定：{ "typescript.tsdk": "node_modules/typescript/lib", "typescript.enablePromptUseWorkspaceTsdk": true } - 改完后执行
Developer: Reload Window，再检查右下角版本 - 如果仍显示
Bundled，说明node_modules/typescript不存在或路径不对——运行npm install typescript --save-dev
composes 和 :global 类名为什么永远不提示
这不是配置问题，是静态分析的天然限制。composes 是运行时合并行为，:global(.btn) 是全局注入，它们都不会出现在 styles 对象的键集合里。VSCode 插件或类型声明无法提前知道 “button composes reset”，更没法跨文件追踪。
- 想让
reset可提示？把它单独抽成reset.module.css，并确保该文件也有对应类型声明 - 避免依赖
:global实现可跳转类名——这类样式本质就不属于模块作用域，强行补全反而误导 - 别信“支持 composes 提示”的插件宣传，目前无成熟实现；扫描全项目找
composes会拖慢索引，大型项目基本不可用
真正能稳定跳转的，只有直接定义在当前 .module.css 文件中的类选择器本身。其他都是妥协方案。
