Honey CSS Modules 2025-06 版本发布:新增悬停信息支持与多项改进
Honey CSS Modules 是一个专注于提升 CSS Modules 开发体验的工具链,它通过提供类型安全、代码提示和错误检查等功能,帮助开发者更高效地使用 CSS Modules。本次发布的 2025-06 版本带来了多项重要更新,特别是新增了对悬停信息的支持,让开发者能更直观地查看 CSS 类名的定义。
悬停信息支持
本次更新最引人注目的功能是新增了对"Definition Preview for Hover"(悬停信息预览)的支持。当开发者在代码编辑器中将鼠标悬停在 CSS Modules 导入的类名上时,现在可以看到该类的定义预览。这一功能由贡献者 ssssota 实现,极大提升了开发体验。
悬停信息功能的工作原理是:
- 当鼠标悬停在类名上时,语言服务器会识别出这是一个 CSS Modules 类名
- 系统会查找对应的 CSS 模块文件
- 提取并显示该类的完整定义
- 开发者无需跳转到定义文件就能快速了解类的样式
代码生成器改进
@css-modules-kit/codegen 升级到 0.4.0 版本,带来了以下改进:
- 新增了
--clean选项,允许开发者在生成代码前清理旧的生成文件,确保项目保持整洁 - 修复了 CSS 语法错误范围计算的问题,现在能更准确地定位错误位置
- 对
createDts接口进行了变更,这是一个破坏性更新,需要开发者注意适配
TypeScript 插件增强
@css-modules-kit/ts-plugin 升级到 0.3.0 版本,主要改进包括:
- 同样支持了悬停信息预览功能
- 修复了一个重要问题:当项目中存在 .d.ts 文件但对应的 .module.css 文件不存在时,插件现在能正确报告这类导入错误
- 与核心库同步更新了
createDts接口
核心库更新
@css-modules-kit/core 升级到 0.4.0 版本,为整个工具链提供了基础支持:
- 实现了悬停信息功能的核心逻辑
- 改进了 CSS 语法错误的定位精度
- 同样更新了
createDts接口
其他工具更新
- ESLint 插件和 Stylelint 插件都同步更新到了核心库的最新功能
- VS Code 扩展修复了与语言服务器请求转发相关的问题
升级建议
对于现有项目,建议开发者:
- 检查项目中是否使用了
createDts接口,如有使用需要相应调整 - 考虑在构建脚本中使用
--clean选项来保持生成文件的整洁 - 更新所有相关插件和工具以获得最佳体验
本次更新显著提升了开发体验,特别是悬停信息功能将大大减少开发者在文件间跳转的次数,提高工作效率。对于大型项目或频繁使用 CSS Modules 的团队来说,这些改进尤为有价值。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考



