版本更新
重构与优化
文档注释与格式化体系全面重构
- 统一
//行注释与/* ... */块注释的前缀配置逻辑，修正此前将/**错误用于普通块注释的设定，明确区分普通块注释与专用于文档生成的/** ... */注释。 - 将文档注释处理流程由
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_COMMENTtoken 的能力；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
源码地址：点击下载
