10 分钟从零跑通第一行代码:Lean 4 环境搭建与入门实践
Lean 4 是函数式编程语言兼定理证明器,能写可执行程序,也能形式化验证命题。读完本文你能完成 Lean 4 环境搭建,在编辑器里看到实时类型检查反馈,并构建、运行一个完整的小项目。
📋 动手前先过一遍自检清单
逐项确认,每项 10 秒:
-
git可用:lake new会为项目初始化 git 仓库,缺了它建项目直接失败。缺则执行sudo apt-get install git - C 编译器(clang 或 gcc)可用:
lake build靠 clang 把 Lean 代码编成原生可执行文件,缺了它构建立刻报错。缺则执行sudo apt-get install clang - 已安装 VSCode:下一节的实时诊断依赖它,没有就只能在终端里看报错
- 网络畅通:elan 和 Lake 都要下载工具链与依赖,断网时安装脚本会卡住不动
📦 装工具链,只保留最短路径
在终端依次运行 3 条命令:
curl -sSf https://raw.githubusercontent.com/leanprover/elan/master/elan-init.sh | sh
source ~/.bashrc
lean --version
第三条能打印版本号即装好(elan 会把 PATH 写进 shell 配置文件,项目的 lean-toolchain 文件负责锁定编译器版本,无需手动切换;不想用 curl,也可在 VSCode 的 Lean 4 Setup 向导里点 "Click to install" 完成同样的事)。
✏️ 在编辑器里写第一行代码
在 VSCode 扩展市场安装 "Lean 4" 扩展,装完按提示重启窗口。打开集成终端,运行 lake new hello 建项目,用 VSCode 打开 hello 文件夹,新建 Foo.lean 文件,粘贴:
def double (n : Nat) : Nat := n + n
#eval double 21
按 Ctrl+S 保存,等几秒,看右侧 Lean Infoview:#eval 一行会给出结果 42,底部状态栏右侧显示 lean4 标识,说明服务器在跑。把 21 改成 "21"(字符串)再保存:该行出现红色波浪线,下方 Problems 面板报类型不匹配。这步卡住的人不少,别慌,这是正常的类型检查反馈。
🏁 用 15 行以内的代码跑完一个真实小任务
lake new hello 生成的模板本身就是个小任务,不用再加代码。在终端运行:
cd hello
lake build
./.lake/build/bin/hello
第三条打印 Hello, world!,从源码到原生可执行文件的闭环完成(首次 lake build 会自动下载锁定版本的工具链,等待偏长属正常)。生成的 lakefile.toml 关键段:
[[lean_exe]]
name = "hello"
root = "Main"
root 指向自动生成的 Main.lean,内容就两行:
def main : IO Unit :=
IO.println s!"Hello, {hello}!"
🔍 卡住时查这两处
lean --version 提示找不到命令
- 现象:装完 elan,终端仍报 command not found
- 解决:
source ~/.bashrc(zsh 用户执行source ~/.zshrc) - 原理:安装脚本把 PATH 写进了 shell 配置文件,当前终端会话看不到,需重新加载
lake build 报找不到 clang
- 现象:构建刚开始就报 failed to run 'clang'
- 解决:
sudo apt-get install clang - 原理:Lake 调用系统 C 编译器生成可执行文件,elan 装不了它
两处都没命中时,点状态栏 Lean 4 图标,选 Troubleshooting: Show Setup Information 查看完整环境信息。
更多示例看 doc/examples/。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考






