当前位置: 首页 > news >正文

Lean 工具链教程 | Lake elan

前边安装 Lean4 提到了 Lean 项目开发的三件套:版本管理器 elan + 包管理器和构建工具 lake + 语言本身的核心组件 lean。本篇分别介绍这三个工具的基本用法。

elan 常用功能

elan 是 Lean 版本管理器,用于安装、管理和切换不同版本的 Lean。

版本管理:

elan --version   # 输出版本号来测试安装是否成功
elan self update # 更新 elan
elan show        # 显示已安装的 Lean 版本

# 下载指定 Lean 版本,所有版本可见 https://github.com/leanprover/lean4/releases
elan install leanprover/lean4:v4.10.0

# 下载最新稳定版本 stable
elan default leanprover/lean4:stable 

# 切换默认的 Lean 版本
# 切换到 leanprover/lean4:v4.11.0-rc1 
elan default leanprover/lean4:v4.11.0-rc1 

# 设置在当前目录下使用的 Lean 版本
elan override set leanprover/lean4:stable
# info: info: override toolchain for 'xxx' set to 'leanprover/lean4:stable'

指定版本运行 lakelean 命令:

lake --version # 使用 elan 默认版本
# 使用指定版本
elan run leanprover/lean4:v4.10.0 lake --version
elan run leanprover/lean4:v4.10.0 lean --version
# 创建指定版本的项目
elan run leanprover/lean4:v4.10.0 lake new package

elan 配置记录可以在 ~/.elan/settings.toml 查看。

具体地,Windows 下的 elan 管理目录为 %USERPROFILE%\.elan\bin,Linux/Mac 下的管理目录为 $HOME/.elan,内容形如

❯ tree .elan -L 2
.elan
├── bin
│   ├── elan
│   ├── lake
│   ├── lean
│   ├── leanc
│   ├── leanchecker
│   ├── leanmake
│   └── leanpkg
├── env
├── settings.toml
├── tmp
├── toolchains
│   └── stable
└── update-hashes
    └── stable

文件说明:

  • toolchains 存放下载的各个 Lean 版本
  • settings.toml 是 elan 的配置文件。
  • bin 存放常用的二进制文件,比如 lake

Lake 基本用法

lake 全称 Lean Make,是 Lean 4 的包管理器,用于创建 Lean 项目,构建 Lean 包和编译 Lean 可执行文件。

本节介绍 lake 的基本用法,Lean 函数式编程也提供了创建 Lean 项目的例子,而更全面的参数介绍可参考 lake 文档。

在终端中运行(your_project_name 替换为你自己起的名字)

lake new your_project_name

# 或者手动创建一个新文件夹并在原地建立项目
mkdir your_folder_name && cd your_folder_name && lake init your_project_name

以创建一个名为 your_project_name 的空白新项目。这个项目的内容形如

your_project_name
├── YourProjectName
│   └── Basic.lean
├── lakefile.lean
├── lean-toolchain
├── Main.lean
├── YourProjectName.lean
└── ...

其中 lakefile.lean 是当前项目的配置文件,lean-toolchain 是当前项目使用的 Lean 版本。

初次让 Lean Server 运行该项目时会添加

├── .lake
   ├── lakefile.olean.trace
   └── ...
├── lake-manifest.json

如果你想在这个现有的工程中引用 Mathlib4,你需要在 lakefile.lean 文件尾中加入

require mathlib from git
  "https://github.com/leanprover-community/mathlib4"

保存文件后 VS code 会提示 “Restart Lean”,点不点都没关系。

下面要下载 Mathlib,注意让终端路径在你的项目文件夹下。如果你的网络情况好,那么在终端中运行

curl -L https://raw.githubusercontent.com/leanprover-community/mathlib4/master/lean-toolchain -o lean-toolchain
lake update

保存运行缓存会让每次编译节省一两个小时,但它当然也不是必须的:

lake exe cache get

否则(会相当艰难),参考这个解决方案。(不保证该参考方案的可靠性)

如果你看到终端中显示了类似如下的提示:

Decompressing 1234 file(s)
unpacked in 12345 ms

同时你的项目文件夹中出现了 .lake\packages 文件夹,那么证明你安装 Mathlib 成功了,此时 “Restart Lean” 即可使用。注意:你要在项目所在的目录中运行 VS code,才能让 Lean 使用Mathlib。

这里提供一个实例来测试你的安装:

import Mathlib.Data.Real.Basic
example (a b :) : a * b = b * a := by
  rw [mul_comm a b]

如果你的 Lean infoview 没有任何报错,并且光标放在文件最后一行时会提示 “No goals”,证明你的 Mathlib 已经正确安装了。

如果你想更新 Mathlib,在终端中运行

curl -L https://raw.githubusercontent.com/leanprover-community/mathlib4/master/lean-toolchain -o lean-toolchain
lake update
lake exe cache get

关于 Mathlib 的更多内容请参考 Mathlib Wiki

lake 的其他常用功能:

# 构建项目可执行文件
lake build
# 运行
lake exec hello # Hello, world!
# 清理构建文件
lake clean
# 更新依赖
lake update
# 运行 lakefile.lean 的脚本
lake run <script>

lean 验证定理

lean 是语言本身的核心组件,通常不需要直接与 lean 交互。

这里介绍常见的两个操作:运行 Lean 脚本,以及验证 Lean 代码。

执行 Lean 脚本,入口为 main 函数:

-- hello.lean
def main : IO Unit := IO.println s!"Version: {Lean.versionString}"

在终端中运行:

elan default leanprover/lean4:v4.11.0-rc1
lean --run hello.lean
# Version: 4.11.0-rc1
elan run leanprover/lean4:v4.10.0 lean --run hello.lean
# Version: 4.10.0

验证 Lean 代码:

-- proof.lean
theorem my_first_theorem : 1 + 1 = 2 := by
  simp

theorem my_false_theorem : 1 + 1 = 1 := by
  simp

theorem my_syntax_error_themore 1 + 1 = 2 := by
  simp

在终端中运行:lean proof.lean,返回错误信息:

hello.lean:5:40: error: unsolved goals
⊢ False
hello.lean:8:31: error: unexpected token; expected ':'

相关文章:

  • 【Qt 常用控件】多元素控件(QListWidget、QTableWidgt、QTreeWidget)
  • PostgreSQL 开发利器:Navicat 核心功能与资源攻略
  • MFC程序设计(十一)单文档架构
  • w208基于spring boot物流管理系统设计与实现
  • linux系统安装zabbix监控
  • 算法随笔_50: 表现良好的最长时间段
  • matlab齿轮传动
  • unity学习36:老版的动画 Animation
  • pytorch训练五子棋ai
  • Azure上基于OpenAI GPT-4模型验证行政区域数据的设计方案
  • deepSeek本地部署,详细教程,Ollama安装
  • 机器学习入门-读书摘要
  • 数据结构 树的存储和遍历
  • 一口气入门前端——HTML5入门
  • 内网穿透简单使用
  • QEMU参数与使用
  • nginx播放视频(auth_request鉴权)
  • 人工智能行为识别之slowfast源码解读
  • Linux Mem -- MTE in AArch64 Linux
  • 树莓集团全国拓展:产业园服务与人才培养的协同发展
  • 学生靠老干妈下饭、职工餐肉类又多又好?纪委出手整治
  • 国家统计局:4月份各线城市商品住宅销售价格环比持平或略降
  • 中共中央、国务院印发《党政机关厉行节约反对浪费条例》
  • 上海这场有温度的“人才集市”,为更多人才搭建“暖心桥”
  • 广州医药集团有限公司原党委书记、董事长李楚源被“双开”
  • 河南一女子被医院强制带走治疗,官方通报:当值医生停职