Lean 4 官方资料去哪找
学到一半想查点东西,最常见的困扰不是“没有资料”,而是不知道该去哪一个网站。Lean 官方的东西分散在好几个地方:语言本身、数学库、在线试用、找定理的搜索引擎,各有各的网址。
先说你想干什么,直接告诉你去哪:
查一查我想……
点一个看看。
学完你能做什么
- 遇到问题时知道该去哪个官方网站查
- 用
lake new新建一个 Lean 项目并编译通过 - 知道怎样新建一个依赖 Mathlib 的项目
官方网站一览
下面这些都列在 lean-lang.org 的导航和页脚里(说明取自各站点自己的介绍):
| 名称 | 网址 | 用来做什么 |
|---|---|---|
| 安装 | lean-lang.org/install | 官方安装说明,推荐 VS Code 加 Lean 4 扩展 |
| Learn | lean-lang.org/learn | 官方学习入口 |
| 语言参考 | lean-lang.org/doc/reference/latest/ | 语法和语义的权威说明 |
| Lean API | lean-lang.org/doc/api/ | 标准库每个定义的文档 |
| Playground | live.lean-lang.org | 浏览器里直接写 Lean |
| Mathlib | leanprover-community.github.io | 社区维护的数学库 |
| Reservoir | reservoir.lean-lang.org | Lake 的包注册中心 |
| Loogle | loogle.lean-lang.org | 搜索 Lean 和 Mathlib 的定义与定理 |
| FAQ | lean-lang.org/faq | 官方常见问题 |
- 我把这张表收藏了,或者记住了 Playground 和语言参考的网址
新建一个 Lean 项目
官方的说法是:所有 Lean 代码都应该放在一个 Lean 项目里。项目就是一个文件夹,里面有 git 仓库、描述依赖的 lakefile.lean 或 lakefile.toml,以及其他必要文件。用 lake 一条命令生成:
lake new MyLeanProject
cd MyLeanProject && lake build你应该看到:最后一行是 Build completed successfully。文件夹里有 lakefile.toml、lean-toolchain、Main.lean 等文件。这两条命令我们在 Lean 4.35.0 上实际跑过。
然后用 VS Code 打开这个文件夹(终端里输入 code .),提示时选 “Trust authors”。
$lake new MyLeanProject
$cd MyLeanProject && lake build
Build completed successfully (8 jobs).
- 我的项目
lake build通过了
新建一个依赖 Mathlib 的项目
想用数学库,新建项目时直接选 Mathlib 模板(官方手动安装说明里的命令):
lake +leanprover-community/mathlib4:lean-toolchain new MyMathlibProject math第一次建这种项目要下载 Mathlib,会等比较久。
克隆别人的、依赖 Mathlib 的项目之后,先在项目文件夹里运行这一条,下载编译好的缓存,省去自己从头编译:
lake exe cache get要升级项目里的 Mathlib,官方给的做法是:
curl -L https://raw.githubusercontent.com/leanprover-community/mathlib4/master/lean-toolchain -o lean-toolchain
lake update升级后建议再检查一遍所有文件还能编译:
lake exe mk_all && lake build- 我知道新建 Mathlib 项目和克隆后下载缓存分别用哪条命令
常见问题
Lean 4 官方文档在哪?
语言本身看语言参考 lean-lang.org/doc/reference/latest/,查具体函数看 API 文档 lean-lang.org/doc/api/。系统学习的入口在 lean-lang.org/learn。
Lean 4 在 Windows 上怎么安装?
官方推荐的装法是 VS Code 加 Lean 4 扩展,由扩展带你完成剩下的设置。只想用命令行,可以在 PowerShell 里装 elan,命令见 装好 Lean 4。
不想安装,能在线试 Lean 4 吗?
能。官方在线版在 live.lean-lang.org。它适合安装前试试、跑小片段,大项目还是要装在本地。
提示 lake 是未知命令怎么办?
官方的说明是先运行 source ~/.profile 或 source ~/.bash_profile,让刚装好的命令生效,再重试。
检查点
- 我知道语言参考、API 文档、Playground、Mathlib 各在哪
- 我用
lake new建了一个项目,并且lake build通过 - 我知道依赖 Mathlib 的项目怎么建、克隆后先运行哪条命令
下一节
工具和资料都齐了,开始学推理:如果……那么……。