入坑简介

PyCN，顾名思义就是Python Chinese，它使用和Python相同的语法，但是关键词，字面量，内置函数和运算符均使用中文。

我们来看看这个例子：

定义 是否是质数（被判断的数）：
    如果 被判断的数 小于 二：
        返回 假
    迭代 数一 在 范围（二，整数（被判断的数 取幂 零点五）加 一）：
        如果 被判断的数 取余 数一 等于 零：
            返回 假
    返回 真

上述代码相当于：

def is_prime(num):
    if num < 2:
        return false
    for i in range(2, int(num ** 0.5) + 1):
        if num % i == 0:
            return false
    return true

没错！PyCN和Python的代码风格完全一致，然而如你所见，和我上面说的一样，代码都是中文的！

安装 PyCN

预编译的二进制文件已发布在 GitHub Releases。下载对应平台的压缩包，解压即可使用。

每个发布包已包含 pycn 二进制文件和 Python 标准库——无需安装系统 Python 或 Rust 工具链。

支持平台

平台	架构
Linux	x64, arm64
macOS	x64, arm64
Windows	x64, arm64

下载解压后，直接运行：

./pycn run 你的文件.pycn

从源码构建（面向贡献者）

前置要求

• Rust 工具链
• 网络连接（首次构建需下载预编译 Python）

开发构建（推荐）

只需运行一次配置脚本，之后 cargo build / cargo run 开箱即用：

# 一键配置开发环境（下载独立 Python、生成配置、复制标准库）
bash scripts/setup-dev.sh

# 编译 pycn
cargo build -p pycn --release

# 运行示例
cargo run -p pycn --release -- run examples/打印.pycn

setup-dev.sh 做了什么：

1. 下载 python-build-standalone 预编译的独立 Python 到 build/pbs-python/
2. 生成 build/pyo3-config.txt（pyo3 链接配置）
3. 复制 Python 标准库到 python-stdlib/（运行时加载）
4. 写入 .cargo/config.toml（自动设置 PYO3_CONFIG_FILE 和 PYCN_STATIC_PYTHON 环境变量）

NOTE

• 若需恢复使用系统 Python，删除 .cargo/config.toml 后使用 cargo build --no-default-features 构建
• cargo clean 不会删除 python-stdlib/（在项目根目录而非 target/ 中）

其他 crate 构建

# C 动态库
cargo build -p pycn-dylib --release

# Node.js / Web WASM
cd parser-wasm
wasm-pack build --out-dir output            # ES Module（默认 --target bundler）
wasm-pack build --target nodejs --out-dir output  # CommonJS
wasm-pack build --target web --out-dir output     # Web

# HTTP Server
cargo build -p http-server --release

发布构建（打包独立运行时）

bash scripts/build-release.sh

该脚本会自动下载 PBS Python、编译 pycn、并将二进制与 Python 标准库打包到 target/release/pycn-standalone/，生成一个不依赖系统 Python 的独立分发包。

语法高亮

目前，PyCN在VSCode编辑器中支持语法高亮。

只需要安装Pycn 插件，就可以自动高亮显示了。