如何在VSCode中配置CSS Modules在React的JS文件里实现类名点击跳转和智能提示
为什么 import styles from './xxx.module.css' 后没有补全和跳转
很多开发者遇到这个问题，第一反应是插件没装对。其实，问题的根源更深一层：TypeScript 语言服务根本“看不见”你 CSS Module 里具体有哪些类名。默认情况下，当你写下 import styles from './Button.module.css'，TypeScript 只知道 styles 是一个键值对对象（类型为 { [key: string]: string }）。至于里面到底是 primary 还是 secondary，编辑器无从得知。既然不知道，自然也就无法提供智能补全，更别提点击跳转到定义了。
必须安装 typescript-plugin-css-modules 插件
解决这个问题的核心，是让 TypeScript 能“看见”CSS Module 的内容。这就需要 typescript-plugin-css-modules 插件出场了。它不是一个普通的 VSCode 扩展，而是一个 TypeScript 编译器插件。它的工作原理很巧妙：在背后为每一个 .module.css 文件动态生成对应的 .d.ts 类型声明文件，从而告诉 TypeScript：“看，这个 styles 对象里就有这些键。” 需要注意的是，这个插件只对 .ts 或 .tsx 文件生效。
具体操作分两步：
- 首先，在项目中安装它：
npm install -D typescript-plugin-css-modules（建议本地安装）。 - 然后，在项目的
tsconfig.json文件里，找到compilerOptions部分，添加插件配置：
{
"compilerOptions": {
"plugins": [
{
"name": "typescript-plugin-css-modules",
"options": {
"customMatcher": "\.(c|le|sc)ss$"
}
}
]
}
}
这里有个关键点：customMatcher 这个正则表达式必须覆盖你项目中实际使用的 CSS 文件后缀。上面的例子匹配了 .css, .less, .scss。如果你用的是 .module.scss，这个配置没问题；如果还用了 .pcss 等后缀，就需要相应地扩展这个正则表达式。
VSCode 必须使用工作区 TypeScript 版本
插件装好了，配置也写了，但问题可能还在。这是因为 VSCode 默认可能使用的是其内置的 TypeScript 语言服务，而这个内置版本并不认识你项目里刚装的插件。所以，必须“强制” VSCode 使用你项目 node_modules 下的 TypeScript。
操作很简单：
- 在项目根目录下，创建或编辑
.vscode/settings.json文件。 - 写入以下配置（这只会影响当前项目，不用担心全局设置）：
{
"typescript.tsdk": "node_modules/typescript/lib",
"typescript.enablePromptUseWorkspaceTsdk": true
}
保存后，你需要执行 Developer: Reload Window 命令，或者直接重启一下 VSCode。完成后，留意编辑器右下角的 TypeScript 版本号，确认它显示的是“Workspace version”（工作区版本），而不是“Bundled”（内置版本）。这一步至关重要。
跳转到定义仍失败？检查文件关联和语言模式
如果类型提示有了，但点击类名仍然无法跳转到 CSS 文件，那问题可能出在文件关联或语言模式上。这种情况在使用了非标准后缀（比如 .page.tsx）或者文件未被正确识别为 TypeScript React 时尤其常见。
可以按以下步骤排查：
- 打开任意一个
.tsx文件，查看编辑器右下角显示的语言模式。它必须明确是TypeScript React，如果显示为TypeScript甚至Plain Text，那功能就会异常。 - 对于自定义的后缀，你需要在
.vscode/settings.json中手动建立文件关联，例如："files.associations": { "*.page.tsx": "typescriptreact" }。 - 此外，还要确保
typescript-plugin-css-modules插件的getScriptSnapshot钩子能被正常调用。这个钩子负责为匹配customMatcher的 CSS 文件生成类型快照。因此，CSS 文件的路径必须是可访问的，不能是符号链接循环或存在权限问题。
最后，需要明确一个技术限制：如果你在代码中动态拼接类名，例如 styles[theme + 'Primary']as const 断言来进行显式的类型约束。
