直接添加 declare module '*.module.css' 声明可解决编译错误，但 ide 无提示和类型校验是因声明方式与项目配置未对齐；需确保 tsconfig.json 的 include 覆盖声明文件、后缀准确、语言模式设为 css modules，并禁用 css.validate。
直接加 declare module '*.module.css' 声明文件就能过编译，但 IDE 不提示类名、styles.xxx 无类型校验——这不是声明写错了，而是声明方式和项目配置没对齐。
为什么 import styles from './Button.module.css' 报“找不到模块”？
TypeScript 默认不认 .module.css 这种后缀，它既不是标准 JS/TS 模块，也没有内置类型定义。报错本质是模块解析失败，不是 CSS 写错了或路径不对。
- 检查
tsconfig.json的"include"是否覆盖了你的声明文件（比如"src/@types/css-modules.d.ts"或"types/**/*.d.ts"） - 确认没有拼错后缀：是
*.module.css，不是*.css或*.modules.css - 如果用了
.module.scss，声明必须对应写成declare module '*.module.scss'，不能复用 CSS 的声明
declare module 怎么写才真正生效？
最简可用的声明长这样，放在任意 .d.ts 文件里即可：
declare module '*.module.css' {
const classes: { [key: string]: string };
export default classes;
}
注意三点：
Access global ocean tides model. Functions include tide height at a given date/time/location, tide extrema, and grid weather data.
下载
访问全球海洋潮汐模型。功能包括查询指定日期、时间和地点的潮高、潮汐极值及格点天气数据。
- 不要加
export =、declare const或赋值语句（如= {}），TS 会直接报错 - 如果项目启用了
strict模式，建议用readonly [key in string]替代[key: string]，避免误改styles - 用
@types/css-modules包可以省去手写声明，但需确保tsconfig.json启用了"moduleResolution": "node"
VSCode 里 styles.xxx 还是没提示？查这三处
类型声明只是第一步，IDE 提示还依赖语言服务识别和插件协同。
- 右下角点击语言模式，手动把
.module.css文件的语言切换为CSS Modules（VSCode 不自动切） - 在工作区
.vscode/settings.json中加："css.modules": true（新版部分自动，但显式声明更稳） - 禁用内置 CSS 校验：
"css.validate": false，否则.module.css会被当成非法 CSS 压制语言服务启动
composes 和 :global 类名为什么永远不提示？
它们在编译时才合并或注入，不属于 styles 对象的静态键，任何静态分析工具都推导不出来。
-
composes: reset from './reset.module.css'→ 要提示reset，就得单独为reset.module.css写声明，且确保它被include进 TS 配置 -
:global(.btn)定义的样式根本不会出现在styles上，补全列表里自然没有；想搜它，只能靠全局文本搜索或 CSS 文件内跳转
真正难的不是写声明，而是让 TS 解析器、VSCode 语言服务、Webpack 加载器三者对同一个文件达成一致——漏掉任一环，styles.button 就只是个字符串。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
