当前位置：首页 > java >正文

Nuitka：将源码编译为 `.pyd`

java 2025/8/1 18:19:23

Python 作为一种高级动态语言，以其简洁易用和丰富的生态深受开发者喜爱。然而，Python 代码的解释执行特性往往带来性能上的瓶颈和源码泄露风险。Nuitka 是一个将 Python 源码编译为高效的本地二进制模块（如 .pyd 或可执行文件）的工具，不仅能显著提升运行速度，还能有效保护源码。

环境准备

安装 Python（建议版本：3.8 ~ 3.11）
安装 Nuitka（建议在虚拟环境中使用）：
```
pip install nuitka
```
Windows 用户需额外安装 C/C++ 编译器，推荐以下任一方式：
- 安装 Visual Studio，并勾选“使用 C++ 的桌面开发”组件
- 或仅安装 Windows SDK（需包含 cl.exe）

单模块编译

假设你要将 example.py 编译为 example.pyd，结构如下：

project/
└── example.py

执行以下命令：

python -m nuitka --module example.py --nofollow-imports --no-pyi-file

--module：将文件编译为 .pyd 而不是 .exe
--nofollow-imports：不处理依赖，仅编译该文件
--no-pyi-file：不生成类型提示文件（可选）
--remove-output：删除编译中间文件（可选）
--output-dir=build/：指定所有编译输出文件放入 build/ 目录（可选）

生成后的 .pyd 文件可直接 import example 使用。

整包编译

假设你有如下包结构：

project/
└── your_package/├── __init__.py├── submodule1.py└── utils/├── __init__.py└── helper.py

使用以下命令：

python -m nuitka --module your_package/ --include-package=your_package --nofollow-imports --no-pyi-file

--module your_package/：将整个目录作为模块编译
--include-package=your_package：包含包和所有子模块
--no-pyi-file：不生成类型提示文件（可选）
--remove-output：删除编译中间文件（可选）
--output-dir=build/：指定所有编译输出文件放入 build/ 目录（可选）

自定义构建脚本

为方便批量编译项目中的 Python 源码和拷贝非代码资源，可以编写命令行工具脚本（如示例中的 Nuitcrypt.py）。以下是使用和注意事项说明：

python -m Nuitcrypt 源目录 [-o 目标目录]

源目录：必填，待编译的源码根目录（含子目录）
-o 目标目录：可选，编译结果及资源拷贝的输出目录；若不指定，则在原目录内直接替换源码（删除 .py）

import os, shutil, subprocess, sys, importlib.util# 解析命令行参数
if len(sys.argv) < 2:print("[ERROR] 使用方法: python -m Nuitcrypt 源文件夹 [-o 目标文件夹]")sys.exit(1)root = sys.argv[1]
out_dir = sys.argv[3] if len(sys.argv) > 3 and sys.argv[2] == "-o" else None# 检查依赖
print("[INFO] 检查依赖...")
if sys.version_info < (3, 6):print(f"[ERROR] 需要 Python 3.6+，当前: {sys.version}")sys.exit(1)
if not importlib.util.find_spec("nuitka"):print("[ERROR] Nuitka 未安装，运行 'pip install nuitka'")sys.exit(1)
if not os.path.isdir(root):print(f"[ERROR] 源目录 {root} 不存在")sys.exit(1)print("[INFO] 依赖检查通过")# 清理 __pycache__
print("[INFO] 清理 __pycache__...")
for r, dirs, _ in os.walk(root):if "__pycache__" in dirs:path = os.path.join(r, "__pycache__")print(f"[DELETE] 删除缓存: {path}")shutil.rmtree(path, ignore_errors=True)# 编译处理
print("[INFO] 开始编译...")
for r, _, files in os.walk(root):rel = os.path.relpath(r, root)target_dir = r if out_dir is None else os.path.join(out_dir, rel)os.makedirs(target_dir, exist_ok=True)for f in files:src_path = os.path.join(r, f)target_path = os.path.join(target_dir, f)if f.endswith(".py") and f != "__init__.py":cmd = [sys.executable, "-m", "nuitka", "--module", "--no-pyi-file","--nofollow-imports", "--remove-output", f"--output-dir={target_dir}", src_path]print(f"[COMPILING] {src_path}")try:subprocess.run(cmd, check=True, capture_output=True, text=True)print(f"[SUCCESS] 编译成功: {src_path}")if out_dir is None and os.path.exists(src_path):os.remove(src_path)print(f"[REMOVE] 删除源文件: {src_path}")except subprocess.CalledProcessError as e:print(f"[FAIL] 编译失败: {src_path}")print(f"[STDERR] {e.stderr.strip()}")sys.exit(1)elif out_dir is not None:if not os.path.exists(target_path) or not os.path.samefile(src_path, target_path):shutil.copy2(src_path, target_path)print(f"[COPY] {src_path} -> {target_path}")print("[INFO] 编译与拷贝完成")