Gradualizer教程:如何用Rebar3插件为现有Erlang项目3步无痛接入静态类型检查
Gradualizer教程如何用Rebar3插件为现有Erlang项目3步无痛接入静态类型检查【免费下载链接】GradualizerA Gradual type system for Erlang项目地址: https://gitcode.com/gh_mirrors/gr/GradualizerGradualizer是一个面向Erlang 的静态类型检查器静态类型检查工具支持渐进式类型系统Gradual Type System。借助它的Rebar3 插件你可以在不改动任何现有代码的前提下为已存在的 Erlang 项目无痛接入静态类型检查没有类型声明的函数不受影响添加的-spec越多静态检查就越深入。本文将带你快速完成配置。为什么选择 Gradualizer 做静态类型检查很多团队想给 Erlang 项目加类型检查但又担心全量改造的成本。Gradualizer 的设计正是为了解决这个痛点渐进式接入基于渐进式类型原则未标注类型的代码不会被强制检查零侵入复用现有语法直接使用 Erlang 原生的-type/-spec类型声明无需学习新语法细粒度控制可以按函数、按文件逐步开启类型检查穷尽性检查case、if等模式匹配是否覆盖所有类型分支都能在编译期提前发现见上方图片中cats分支缺失的提示低门槛运行仅需 OTP 21项目使用标准 OTP 目录结构即可。 核心理念类型声明越多静态检查越强——你可以只给关键函数加 spec其余保持原样。前置条件环境与项目准备开始之前请确认✅ 已安装rebar3标准 Erlang 构建工具✅ Erlang/OTP 版本≥ 21✅ 项目已有rebar.config文件没有的话新建一个即可。用 Rebar3 插件 3 步接入静态类型检查第 1 步在 rebar.config 中注册 gradualizer 插件打开项目根目录的rebar.config添加plugins配置项把 Gradualizer 作为 rebar3 插件引入{plugins, [ {gradualizer, {git, https://gitcode.com/gh_mirrors/gr/Gradualizer.git, {branch, master}}} ]}.首次执行任意 rebar3 命令时插件会自动拉取并编译。官方提供了一个完整的最小示例项目包含rebar.config与带 spec 的示例模块可参考examples/rebar3/目录下的 rebar.config 和 rebar3_example.erl-module(rebar3_example). -spec c(boolean()) - boolean(). c(X) - X.第 2 步运行类型检查命令rebar3 gradualizer该命令由插件模块 src/rebar_prv_gradualizer.erl 实现默认会对所有应用源码目录下的*.erl文件执行静态类型检查并自动处理 include 目录与编译选项。检查通过时静默结束发现问题时会按文件: 行号 列号: 错误信息的格式逐条输出并以非零退出码结束——非常适合接入 CI。 由于插件依赖compileprovider它会先编译项目再检查确保使用最新的编译产物信息。第 3 步给关键函数添加 -spec享受渐进式静态检查现在从你最担心的函数开始逐步补充类型声明-type status() :: ok | error. -spec handle_request(string()) - status(). handle_request(_Req) - ok.再次运行rebar3 gradualizer任何与 spec 不一致的调用、遗漏的模式分支、错误的返回类型都会在运行之前被揪出来。加得越多检查网越密——这就是无痛接入的含义你掌控节奏。常用配置用 gradualizer_opts 微调检查范围默认情况下 Gradualizer 会检查应用内全部.erl文件。如需精细控制在rebar.config中增加gradualizer_opts一个属性列表官方示例见 examples/rebar3/rebar.config选项类型作用include[filelib Wildcard]指定要检查的文件未定义时默认检查源码目录所有.erlexclude[filelib Wildcard]排除不需要检查的文件stop_on_first_errorboolean()遇到第一个错误就停止还是检查完所有函数与文件appsstring()umbrella 项目中只检查指定应用逗号分隔列表{gradualizer_opts, [ {exclude, [src/not_*.erl]}, {stop_on_first_error, false} ]}.此外还支持两个命令行选项rebar3 gradualizer --appsapp1,app2只检查指定应用rebar3 gradualizer --use_beams改用ebin下的*.beam文件作为输入需带 debug info 编译。当项目结构复杂、.erl文件分析不准确时这是更稳健的选择。进阶让静态类型检查走进你的 IDE静态类型检查不必只停留在命令行。Gradualizer 与ErlangLSErlang 官方语言服务器深度集成——在项目根目录放置erlang_ls.config并启用gradualizer诊断即可在编辑器中实时获得类型检查提示本仓库根目录的 erlang_ls.config 就是一个现成配置diagnostics: enabled: - compiler - gradualizer下图展示了在 IDE 中边写代码、边查看 Gradualizer 静态类型检查诊断的实时效果常见问题FAQQ1不加任何 -spec运行rebar3 gradualizer会报错吗不会。Gradualizer 遵循渐进式类型原则没有类型声明的代码不做静态检查接入本身零成本。Q2我的项目 include 路径很多检查总是报 include 相关错误可以先尝试--use_beams模式它以编译好的 beam 文件为输入绕过了 include 解析环节在复杂工程中通常更稳健。Q3如何让 CI 在第一个错误时立即失败设置 {gradualizer_opts, [{stop_on_first_error, true}]}或保持默认检查完全部文件以获得一次性完整的问题清单。Q4Elixir 项目能用吗可以。Gradualizer 的 Elixir 前端叫 Gradient通过 Mix task 集成原理与本教程相同。总结用 3 步为现有 Erlang 项目接入 Gradualizer 静态类型检查注册插件在rebar.config中添加 gradualizer 插件运行检查执行rebar3 gradualizer零改动、零风险渐进补类型给关键函数补-spec配合gradualizer_opts控制范围把类型错误消灭在运行之前。渐进式类型系统的最大优势就是小步快跑——从今天的一个函数开始让静态类型检查成为你项目的安全网 ️。【免费下载链接】GradualizerA Gradual type system for Erlang项目地址: https://gitcode.com/gh_mirrors/gr/Gradualizer创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

Python + AI Agent:让你办公效率暴增10倍的8个“狠”招(附案例)

Python + AI Agent:让你办公效率暴增10倍的8个“狠”招(附案例)

你还在用 写死板的自动化脚本吗?比如:“如果有邮件,就下载附件”。这叫自动化。可是到了二零二六年, 我们所要玩的是人工智能智能体, 没错, 就是那个AI Agent。说像这样, 查看一下邮件究竟是谁发送过来的, 要是发送者是老板, 那就即刻去进行重…

2026/11/21 2:57:37 阅读更多 →
去ai写作痕迹后阅读体验会变差吗?保留语气的改法,检测查重不翻车

去ai写作痕迹后阅读体验会变差吗?保留语气的改法,检测查重不翻车

去ai写作痕迹后阅读体验会变差吗?保留语气的改法,检测查重不翻车 先回答标题这个问题:会不会变差,完全取决于你用什么改法。用同义词替换那一挂的改法,大概率变差,稿子会被改得别别扭扭,AI率还…

2026/11/21 2:57:37 阅读更多 →
如何用Neptune Mutual Bridge跨链转移资产:Celer与LayerZero双通道完整对比

如何用Neptune Mutual Bridge跨链转移资产:Celer与LayerZero双通道完整对比

如何用Neptune Mutual Bridge跨链转移资产:Celer与LayerZero双通道完整对比 【免费下载链接】app.neptunemutual.com 🔱 An open source interface for the Neptune Mutual App 项目地址: https://gitcode.com/gh_mirrors/ap/app.neptunemutual.com …

2026/11/19 11:20:15 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/20 23:27:28 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/20 23:27:28 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/20 23:27:28 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/20 21:55:32 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/20 23:27:28 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/20 22:59:12 阅读更多 →

日新闻

周新闻

月新闻