Snow-IntelliJ v1.1.0 发布：语法解析增强、格式化全面升级与符号索引重构

栏目：广告资讯发布时间：2025-12-05

版本更新重构与优化文档体系全面重构与扩展显著细化插件扩展点说明，补充.snow文件类型定义、语法高亮机制、SDK集成方式、模板开发规范、运行配置结构等关联模块的完整技术文档。深化导航跳转、符号解析、引用查找（FindUsages）、文档悬停提示（QuickDocumentation）及引用解析逻辑的说明，构建更系统、连贯的文档知识图谱。新增注释系统设计原理、索引服务（SymbolIndex）实现细节及PSI深度集成方案的技术文档，同步优化图表表达形式，增强信息传达效率与可读性

版本更新

重构与优化

文档体系全面重构与扩展

显著细化插件扩展点说明，补充 .snow 文件类型定义、语法高亮机制、SDK 集成方式、模板开发规范、运行配置结构等关联模块的完整技术文档。
深化导航跳转、符号解析、引用查找（Find Usages）、文档悬停提示（Quick Documentation）及引用解析逻辑的说明，构建更系统、连贯的文档知识图谱。
新增注释系统设计原理、索引服务（SymbolIndex）实现细节及 PSI 深度集成方案的技术文档，同步优化图表表达形式，增强信息传达效率与可读性。
对主 README 文件进行结构性与视觉层双重重构：标题与图标统一居中对齐、徽章补全并标准化排版、目录层级升级为多级锚点导航、联系方式格式规范化修复。

代码格式化与缩进逻辑重大优化

彻底重写 Snow 语言缩进与格式化引擎，引入 SnowIndentCalculator、SnowIndentSnapshot 及基于官方 AST 的上下文感知能力。
采用块栈（Block Stack）模型精准识别 module/function/struct/loop/if 等嵌套结构，支持 section 级别对齐与深度层次化缩进策略。
废弃旧有分散式空格控制逻辑，统一由 SpacingBuilder 管理换行与空白字符规则，确保格式化不破坏用户已有代码结构。
解决缩进负值异常、错误回退缩进、init/loop 嵌套边界判定不准等问题，显著提升格式化结果的一致性与鲁棒性。

语法高亮与词法解析优化

新增字符串中转义字符（含 Unicode escape 如 \uXXXX、\UXXXXXXXX）的完整解析、高亮渲染与有效性校验支持。
优化词法分析器增量处理流程，强制触发 buffer 全量重新切分，规避因 lexer 状态残留引发的误识别问题。
引入一元运算符 +/- 的专用空格格式化规则，改进空格计算精度与 PSI 节点识别准确性。

项目级符号索引（Symbol Index）全面重构

以 SnowSymbolIndexService 为核心构建统一的项目级符号缓存中枢，替代低效的全量扫描模式。
为“跳转到定义”、“查找引用”、“符号导航”、“按名称查找”等关键功能提供高性能、低延迟的缓存访问入口。
实现文件级 + 项目级两级缓存架构，兼顾响应速度与增量更新效率，降低 IDE 启动与大型项目加载耗时。
RunConfiguration 模块迁移至新序列化框架，重构配置持久化逻辑，提升稳定性与兼容性。

运行配置、注释器与缓存机制优化

SnowCompileModeAction 新增项目上下文识别缓存机制，避免重复判断逻辑，并将耗时操作移出 EDT 线程。
修复 Commenter 接口声明类型不一致、Kotlin 空安全缺失、冗余 import 导入等问题。
统一代码折叠占位符为标准 ...，精简折叠逻辑，强化对空行与注释内容的跳过检测能力。

新增功能

Snow 语言代码折叠（Folding）全面支持

在 plugin.xml 中注册 SnowFoldingBuilder，原生支持 module/function/struct/body/if/loop 等常见代码块的折叠/展开操作。
构建基于 PSI 的折叠区域生成逻辑，取代原有脆弱的正则文本匹配方式，提升准确率与维护性。
支持多种代码块类型识别、注释与空行智能过滤、自定义占位符（长度限制 300 字符）、默认展开策略灵活配置。

字符串 escape 高亮与处理能力增强

扩展 escape token 类型集合，新增对应颜色主题配置项，并在 Lexer 层实现 escape 片段的独立拆分与语义校验。
提供典型用例示例与配套文档说明，显著改善 Snow 字符串的可视化效果与编辑友好度。

十六进制科学计数法数字解析

新增十六进制整数字面量识别能力，支持 0x / 0X 前缀及完整的十六进制扫描逻辑。
明确限定科学计数法（如 e, E）仅适用于十进制数字，禁止在十六进制中混用，保障数值解析语义严谨性。

代码注释快捷键与注释处理支持

完整实现行注释（//）与块注释（/* */）的插入、删除、切换与格式化功能。
同步提供注释语法高亮、编辑器交互行为适配（如自动缩进、光标定位）、以及详细使用文档说明。

依赖升级

Snow 依赖全面升级至 `0.13.1`

整体升级 snow-lang 全系列依赖：common、parser、semantic、ir、backend、vm、lexer 等模块。
全面迁移至新的 com.snowlang 包命名空间，消除历史包路径混乱问题，增强依赖一致性与可维护性。
同步更新 snow-frontend-common，强化其面向 IDE 插件的前端集成能力与接口稳定性。