版本更新

重构与优化

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

• 统一 // 行注释与 /* ... */ 块注释的前缀配置逻辑，修正此前将 /** 错误用于普通块注释的设定，明确区分普通块注释与专用于文档生成的 /** ... */ 注释。
• 将文档注释处理流程由 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

源码地址：点击下载

Procys

AI驱动的发票数据处理

102 查看详情

以上就是Snow-IntelliJ v1.2.0 发布：文档注释、结构视图与缩进格式化增强的详细内容，更多请关注其它相关文章！

# 不支持  # 百度关键词优化排名失败  # 公益服务网站建设方案  # 推广交流网站怎么做的呢  # 乌海视频seo  # 豆豆小说网站建设论文  # 九江营销推广代理商  # 厦门seo推广招聘网  # 网络营销推广精准获客  # 河源中文网站建设推广  # 怎么判断seo价值  # 绑定  # 行号  # 跳转  # word  # 使其  # 运算符  # 一键  # 重构  # 微软  # 文档  # 同步机制  # 本地化  # win  # ai  # 工具  # cad 

相关栏目： 【 科技资讯46185 】 【 网络学院92790 】

相关推荐： 照顾宝贝2小游戏免费秒玩入口  Lar*el如何生成PDF或Excel文件_Lar*el文档导出工具与使用教程  2025俄罗斯Yandex最新入口 官方网站地址及浏览器下载指南  Linux如何构建多环境配置管理_Linux多环境配置方案  优化 Jest 模拟：强制未实现函数抛出错误以提升测试效率  抖音未来赚钱的新趋势 2025年值得关注的变现风口分析  解决 Vaadin 8 中大文件音频播放与定位时出现的 IOException  vivo浏览器怎么扫描二维码 vivo浏览器内置扫一扫功能使用方法  漫蛙2在线漫画入口 漫蛙正版漫画网页版直达  vivo浏览器自带的下载器速度慢怎么办 vivo浏览器提升文件下载速度的技巧  漫蛙2(台版)官方入口地址 漫蛙2(台版)正版漫画网页端  优化LangChain文档加载与ChromaDB集成：解决多文档处理与分块问题  C++如何进行游戏物理模拟_使用Box2D库为C++游戏添加2D物理效果  C++如何实现单例模式_C++设计模式之线程安全的单例写法  Win11蓝牙耳机断连怎么解决 Win11蓝牙设置重新配对与驱动更新【技巧】  百度网盘网页版入口 百度网盘网页版官方登录网址  Go语言HTML解析：利用Goquery精准获取指定元素内容  KFC游戏互动怎么赢取优惠券_KFC线上游戏活动参与与优惠代码赢取教程  sublime如何处理大型CSV文件的列对齐_sublime高级表格编辑插件指南  JUnit5/Mockito：优雅测试内部依赖与异常处理的实践  正确连接J*aScript到HTML实现可点击图片与自定义事件处理  MAC如何安全彻底地删除文件_MAC使用终端命令确保文件无法被恢复  Win10如何开启蓝牙功能_Windows10找不到蓝牙开关解决方法  poki网页游戏推荐_poki免费游戏平台入口  微信怎么把收藏的内容分类管理 微信收藏内容标签分类方法  生成rdflib自定义SPARQL函数：参数匹配与实践指南  百度浏览器字体显示异常偏小_百度浏览器字体渲染修复方案  俄罗斯Yandex搜索引擎入口_Yandex官网免登录一键访问  2306选座时如何选靠窗位置_12306选座靠窗座位查看方法解析  魅族20怎样在浏览器开无图省流_iPhone魅族20浏览器开无图省流【流量节省】  b站怎么删除评论_b站评论管理与删除操作  品牌机怎么重装系统 联想/戴尔/惠普笔记本恢复出厂系统教程  163邮箱登录密码 163邮箱忘记密码找回  蓝湖怎样用切图标注提对接效率_蓝湖用切图标注提对接效率【设计对接】  怎样更改Windows系统的默认安装路径_避免C盘爆满的终极设置【技巧】  Win11 USB传输速度慢怎么解决 Win11 USB驱动更新与设置  163邮箱注册官网 免费申请163个人邮箱  高德地图公交到站提醒失败如何解决 高德提醒权限设置  微信网页版官方入口教程 微信网页版网页版快速登录步骤  深入理解与实现最大堆的Heapify过程：常见错误与修正  三星ZFold5多任务卡顿_Samsung ZFold5流畅度提升  Go语言中JSON数据解码与字段访问指南  LINUX怎么设置定时任务_LINUX crontab配置教程  PyTorch模型训练效果不佳？深入剖析常见错误与调试技巧  如何提高微信支付的安全性_微信支付安全防护与设置建议  C++如何检测键盘输入_C++ _kbhit与_getch函数非阻塞输入  支付宝碰一碰设备是REDMI手机吗 博主拆机辟谣：处理器、内存都不一样  魅族17怎样用浏览器译外语网页_iPhone魅族17浏览器译外语网页【即时翻译】  126邮箱网页版官方入口 126邮箱账号在线登录平台  iCloud登录入口网页版 苹果iCloud官网登录