PuXian 0.2.382

普贤教程

一门静态编译的中文亲和语言：语法像 Python，产物是零依赖静态二进制。这份教程按「变量 → 函数 → 模块 → 服务」的顺序展开，每个示例都在这台机器上真实跑过，输出就是本文里贴的输出。

五分钟跑起来

装好工具链后，一个 PuXian 程序就是一个 .px 文件：

# hello.px
def greet(name):
    return "你好，" + name

def main():
    print(greet("世界"))
    print("2 + 3 = " + str(2 + 3))

直接解释执行，秒级拿到结果：

px run hello.px

text

你好，世界
2 + 3 = 5

要发布时编译成二进制，产物不依赖运行时和目标机的 PuXian：

px build hello.px
./hello/build/hello

说明本教程默认你已经能在终端里执行 px 命令。还没装？先看环境搭建。

章节导航

01 普贤简介

这门语言解决什么问题，与 Go、Python 的差异在哪。

02 基础语法

缩进、注释、保留字——写第一个能跑的程序前必须知道的规则。

03 变量与类型

var 与 let 的区别，五种基本类型的边界。

04 函数

参数默认值、返回值、递归与作用域。

05 错误处理

没有 try/catch 的语言怎么写健壮代码。

06 Web 接口

从函数走到服务，写一个真实可访问的接口。

生态包：195 个，一个不缺

语言本体只带 27 个标准库；真正干活的是 registry/ 里的 195 个包——数据库、JWT、二维码、CSV/Excel/PDF、Redis、邮件、限流、数据结构、中文处理，全都在里面。其中 140 个已到 0.2.0；本站每个包一页参考，参考页「可用版本」一行写明该包有哪几版。另有按主题组织的实战教程与清单。

生态包总览

14 个分类、195 个包，按用途逐类列出，并标出会踩的坑。

实用函数包

装包验证、日常函数包的用途分类，以及与 PHP 内置函数的对照。

包使用边界

返回值形态与运行条件的边界，每条给可跑的调用与输出。

Redis 实战

RESP 客户端全套命令，含一段自写的 RESP 服务器用于自测。

JWT 实战

签发与验签，以及「JWT 不是加密」意味着什么。

二维码实战

编码、解码、SVG，以及为什么它必须编译跑（差 1700 倍）。

正则表达式

七个内建函数，四处与别处不同的语义。

认证与安全

bcrypt、PBKDF2、TOTP、验证码与随机数。

设计取向

维度	PuXian 的选择
执行方式	解释轨用于开发（`px run`），编译轨用于发布（`px build`），同一份源码两种轨
并发	spawn / chan / actor，仅编译轨可用；解释器是单线程子集
错误	可恢复错误走 `Ok` / `Err` 值，不可恢复错误直接终止并给出行列号
依赖	标准库 27 个模块随语言分发；生态包 195 个走 registry
产物	静态链接 ELF，无 glibc 之外的运行时依赖