用途:为 Motoko 源码(*.mo 文件)提供格式与基本约定建议,提升代码可读性与统一性。
主要能力:规定空格用法(算术、比较、布尔、赋值、=、:、逗号分号、花括号、方括号、语句关键字、函数与参数、访问运算符);换行与右边界(建议 80 列,运算符后换行,长参数列表每行一个参数);缩进(每级 2 空格,不用制表符,禁止垂直对齐);分组(多行定义间空行,逻辑组间两空行并加节标题注释);注释(优先行注释,行尾注释至少隔 2 空格,多行注释置于代码前并同缩进,独立行注释首字母大写);标点(分号规则、花括号 C 风格布局);括号(支持无括号风格但避免滥用,同时省略括号与花括号属反例,有类型参数时不省略函数参数括号);数字用 _ 分组;命名(类型/模块/actor 用 UpperCamelCase,其余用 lowerCamelCase,缩写按普通单词拼写,避免下划线开头,私有变量用尾随 _,函数名描述返回值或操作,谓词用 is/has 前缀,toX/fromX 转换命名,作用域大用长名、小用短名,集合用复数);类型标注(定宽数值类型、可变变量、公共字段等需标注,函数参数通常可推断)。
使用方式:在编写或审查 *.mo 文件时按上述规则格式化与命名;资料未提供安装命令或工具集成方式。
适用场景:Motoko 项目源码编写、代码评审与格式化统一。
限制:资料为风格建议,非强制规范;部分规则附有理由与反例,具体工具支持情况暂未提供。