版本更新

重构与优化

文档注释与格式化体系全面重构

• 统一 // 行注释与 /* ... */ 块注释的前缀配置逻辑，修正此前将 /** 错误用于普通块注释的设定，明确区分普通块注释与专用于文档生成的 /** ... */ 注释。
• 将文档注释处理流程由 preFormatProcessor 迁移至 PostFormatProcessor，新增 SnowDocCommentPostFormatter，确保在代码格式化完成后统一调整 /** ... */ 注释块的缩进层级与每行星号（*）的垂直对齐。
• 利用 CodeStyleManager 精确推导 Doc 注释各行的目标缩进值；当原始代码未缩进或缩进混乱时，自动对齐首行 /** 与后续各 * 行，保障注释块内部及与外部代码之间的缩进风格统一。
• 在文档注释格式化前后显式调用 Document 与 PSI 的同步机制，彻底解决因模型不同步引发的异常崩溃、光标意外跳转或格式丢失等问题，大幅增强格式化过程的鲁棒性。

基于官方编译器的缩进与词法分析逻辑升级

• 引入 BlockKind 枚举类型与 SnowAstIndentCalculator 工具类，依托 SnowCompilerFacade 提供的 AST 节点信息计算缩进深度，使 IDE 缩进行为与编译器语义解析结果严格对齐。
• 设计 SnowIndentSnapshot 机制缓存各源码行对应的缩进数值，并建立其与 AST 节点的映射关系；SnowBlock 直接从该快照中读取缩进数据，实现缩进与间距控制逻辑的高度集中化管理。
• 抽离出 SpacingRulesBuilder 模块，统一定义运算符、关键字及标点符号的空格/换行策略，并针对一元正负号 +/- 单独制定空格规则，防止其被错误识别为二元运算符而触发不合理的格式化行为。
• 优化词法分析器的增量分词流程：重写 start 方法，仅保留 startOffset 之后的有效 token；通过 trimTokensBefore 清理起点前冗余 token 并截断跨起点的首个 token，避免 SegmentArray 出现负偏移及旧 token 引发的左移错位；同时保留全量 buffer 重分词兜底策略，在保证增量性能的同时兼顾分词准确性。

结构视图与段落解析健壮性强化

• 重构 SnowStructureViewElement 实现，精准建模文件、模块、结构体与函数间的嵌套层级，完全摒弃依赖缩进判断节点归属的方式，转而基于 token 流与 AST 结构进行语义化定位。
• 新增结构体内函数的识别与归组逻辑，杜绝函数既出现在顶层又挂载于结构体下的重复展示问题，统一将其作为叶子节点呈现，显著提升结构树的语义准确性和可读性。
• 采用 SnowCompilerCache 首先解析 token 流构建结构视图，当遇到复杂嵌套、语法不完整等边界场景时，自动降级使用 PSI 树搜索作为补充手段，确保结构视图始终稳定可用；新增辅助方法用于精确计算缩进与行号，支撑更可靠的函数参数与返回值位置识别。
• 重构段落（Section）判定逻辑，新增 nextKeywordPopsSection 和 commentBeforeContainerKeyword 判断条件，正确应对「注释位于容器关键字之前」这类特殊情形，确保嵌套段落层级变化与结构结束标记之间的一致性匹配。

配置项与文件类型定义规范化

• 统一插件内 fileType 的命名规范与本地化 key 设置，修复 Snow File 显示名称与 file.type.name 属性不一致的问题，确保 Snow 文件在 IDE 中以标准名称呈现，并与对应语言服务类、注释器实现类完成正确绑定。
• 清理结构视图模块中冗余导入项，修正 TokenType 命名冲突与类型引用错误，进一步提升代码结构清晰度与长期可维护性。

---

新增功能

Snow 文档注释（Doc Comment）全流程支持

• 新增 SnowDocCommentPreFormatter，协同 SnowDocCommentPostFormatter 在格式化前后双阶段介入，统一管控文档注释的整体样式，自动校准首行 /** 与内部 * 行的缩进与对齐关系。
• SnowCommenter 实现 CodeDocumentationAwareCommenter 接口，赋予 IDE 级别的文档注释识别能力，支持注释前缀识别、类型判别，并完善行注释/块注释/文档注释三类注释的快捷键交互体验。
• 增强 SnowCompilerLexerAdapter，使其具备识别 DOC_COMMENT token 的能力；SnowTokenTypes 中正式加入 DOC_COMMENT 类型标识，并在 ParserDefinition、FindUsagesProvider 等核心组件中完成对该 token 类型的全链路接入，确保文档注释在语法解析、符号查找等环节享有“一等公民”待遇。
• 在语法高亮系统中复用 BLOCK_COMMENT 的着色方案渲染 DOC_COMMENT，并扩展 SnowDocumentationProvider，使其能同时从 DOC_COMMENT 与 BLOCK_COMMENT 中提取文档内容，显著优化悬浮提示与文档弹窗的信息完整性与响应体验。

Snow 语言结构视图能力深度拓展

• 在 plugin.xml 中注册 SnowStructureViewFactory，构建 Snow 专属结构视图基础设施，支持模块声明、结构体定义及函数签名的层级化、结构化展示。
• 实现 SnowStructureViewModel 与 SnowStructureViewElement，支持按模块和顶层两个维度分别组织声明列表，并内置按名称字母排序与去重机制，确保结构树层次分明、无冗余节点。
• 为函数节点引入差异化图标系统：常规函数使用默认图标，以下划线 _ 开头的函数则显示「锁」形图标，直观标识其内部/受限访问属性，便于大型项目中快速视觉筛选。
• 函数节点支持展示完整签名信息，涵盖参数类型、返回值类型，并兼容多行格式解析，极大提升在结构视图中阅读上下文及跳转至目标函数时的理解效率。
• 引入结构体内函数的映射与过滤机制，结合词法分析结果与字符偏移映射，精准绑定函数与其所属结构体，从根本上避免结构体成员函数在顶层列表中重复出现。

Snow 语言专属代码风格设置支持

• 在 plugin.xml 中注册 SnowCodeStyleSettingsProvider，为 Snow 语言提供独立的代码风格配置面板，UI 与交互逻辑与 IntelliJ 平台其他语言保持一致。
• 默认启用 4 空格缩进并禁用 Tab 字符，确保新建文件及格式化后的代码风格与 Snow 官方推荐规范完全吻合。
• 内置 Snow 语言典型代码片段作为风格预览示例，开发者可实时查看缩进、空格、换行等规则的实际应用效果，快速验证配置是否符合预期。

---

依赖升级

Snow 核心依赖升级至 0.13.2

• 将全局管理的 snowVersion 由 0.13.1 升级至 0.13.2，同步更新 snow-lang 全系子模块依赖（含 common、parser、semantic、ir、backend、vm、lexer 等），全面对齐最新版官方编译器。
• 此次升级后，缩进计算、词法分析及语义解析等底层能力与编译器侧实现进一步趋同，为文档注释格式化、结构视图构建等上层功能提供了更坚实、更可信的语义支撑基础。

工具链与构建环境保持稳定

• 本次迭代仅更新 Snow 语言相关依赖，Kotlin 版本、IntelliJ 平台插件 SDK 版本以及 Gradle 构建脚本配置均维持不变，最大限度保障构建流程稳定性与升级风险可控性。

如遇使用问题，欢迎随时 提交 Issue

源码地址：点击下载