Nuitka打包python代码教程（含打包pyd）

原创已于 2025-05-22 14:28:33 修改 · 1.2w 阅读

70 ·

CC 4.0 BY-SA版权

文章标签：

#nuitka #python打包 #打包exe #打包pyd

于 2024-03-01 17:17:49 首次发布

Python 专栏收录该内容

18 篇文章

订阅专栏

本文详细介绍了如何使用Nuitka1.9.5在Windows环境下打包Python代码，以创建独立执行文件，同时保护代码不被轻易解译，以及注意事项和常见问题解决方案。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Nuitka 打包python代码教程（含打包pyd）

3.1 windows环境下（win7最高支持python3.8的打包）

0.学习资料

非常感谢这个博主的知乎专栏：Nuitka-Python打包exe，不过里面有些教程比较老，但是很不错。

1.需求

自己写的python代码，不想给别人看，直接让别人用，且不能被破解看到源码，还得追求一下运行速度！（当然可以用go、c++等来写代码），如果写的软件还想要授权许可，参考这一篇博客python 实现客户端软件许可证书签名授权 cryptography_python cryptography-优快云博客

2.打包思路

1.pyinstaller 简单，成功率高，但是能直接被解译。（优点：简单、成功率高；缺点：容易被破解看到源码）

2.cx_freeze 不太追求性能的话，只是为了将代码编译，不被别人反编译查看到，可以。（优点：不被破解看到源码；缺点：比nuitka速度慢）

3.Nuitka 追求速度，且不被反编译直接看到源码，可以。（优点：性能更快；缺点：打包资料少，成功率低，需要一些稳定的版本，尽量别乱升级版本）

。。。

那么本文采用nuitka进行打包python代码。

3.nuitka打包环境

支持所有平台，但本人目前仅在win上探索了

3.1 windows环境下（win7最高支持python3.8的打包）

当前环境：win10 64位、python3.9、nuitka1.9.5

①安装nuitka：pip install nuitka==1.9.5（推荐使用1.9.5）如果使用最新的，需要下载对应时间段的mingw64，pypi上nuitka的时间和github上mingw64的时间差不大，即可！

②nuitka打包需要c环境，推荐mingw64，下载链接（SourceForge上的GCC版本才8.1，推荐直接github上下载mingw-builds-binaries），不推荐安装VS。

mingw64安装教程：选择 64位、ucrt 的下载(至于ucrt和msvcrt、posix是啥自行百度)，然后解压，将其中 mingw64/bin的文件夹的绝对路径放到系统环境变量Path中。

③首次打包，会提示需要下载一些依赖，自动联网下载到c盘个人用户\appdata\local\nuitka下，主要下载depends(Dependency Walker)和ccache，

4.nuitka打包命令

cmd中执行 nuitka --help > command.txt，然后vscode打开command.txt就可以一目了然。

常用命令：

【1】nuitka --standalone --mingw64 --enable-plugins=tk-inter --disable-console --remove-output --output-dir=o main.py

【2】命令解释

--standalone	设置独立环境，不使用python环境
--mingw64	指定编译依赖环境，推荐用
--enable-plugins=	指定支持的插件，nuitka --plugin-list 命令查看。pysimplegui依赖tkinter，需要设置--enable-plugins=tk-inter
--disable-console	取消cmd显示，但测试时建议去掉，好找错误。
--remove-output	删除输出文件夹中的 .build文件夹-没啥用
--output-dir=	指定输出文件夹，.dist文件夹中exe为执行程序
--nofollow-import-to=	指定不参与打包的库，那么这个库依赖的库也不会打包，后期需要一个个复制过来
--show-memory	显示打包内存
--show-progress	显示打包过程

【3】注意：

①在使用pysimplegui（PySimpleGUI教程）时，需要在主代码中添加“import tkinter as tk”，并且设置--enable-plugins=tk-inter，这样可以让nuitka打包tkinter进你的代码中！

②在使用pyside6/pyqt6（PySide6教程）时，需要设置--enable-plugins= pyside6或者pyqt6。

4.1 将py文件打包成pyd

如果可以直接采用nuitka打包exe，那么这种方式就可以不用（不过据说nuitka直接打包对于复杂环境的失败率高；例如conda安装的cuda等）。

有人推荐将自己的核心代码放到1个文件夹中，打包成pyd，然后采用nuitka或者pyinstaller打包，这样就不会影响核心代码被别人反编译看到了！

个人的需求：能直接用nuitka直接打包就直接打包，例如conda环境太复杂，为了保护代码，就将核心代码打包成pyd吧！！！

nuitka --module AutoShp.py 不写include 默认不可import 只能from import导入

nuitka --module --include-module=AutoShp AutoShp.py 将py文件视为module，将文件夹视为package

额外信息（摘自：Nuitka-Python打包exe）：

        一 module
        通常模块为一个文件，直接使用import来导入就好了。可以作为module的文件类型".py"、".pyo"、".pyc"、".pyd"、".so"、".dll"。（可以直接import pyd文件）
        二 package
        通常包总是一个目录，可以使用import导入包，或者from + import来导入包中的部分模块。包目录下为首的一个文件便是 __init__.py。然后是一些模块文件和子目录，假如子目录中也有 __init__.py那么它就是这个包的子包了。

使用--module参数，将包/模块打包为二进制的pyd文件。module在这里可能会有点歧义，实际上借助--include参数，对于包/模块/目录（package/module/directory），都能打包为pyd。
打包pyd文件，必须借助--include参数,这是因为打包pyd的时候没有入口文件，所以就没有import可以follow，因此就必须要用到include对整个包进行指定，否则打包出来的pyd文件里面不会有任何的内容，引用这个pyd文件会提示找不到模块

5.注意事项

1. nuitka不是每个版本都好用的，目前好用的版本有：1.9.5、以及最新版本也可以。

4.无论anaconda、还是原生python或2者的虚拟环境，其实都可以，只是2者之间会有区别，有问题，其实可以解决这些问题的，可能途径or需要复制的文件不一样。

2. 不推荐在anaconda下，可以在anaconda创建的python虚拟环境下(conda创建python虚拟环境)，不推荐系统中存在多版本python相互干扰(目前未遇到)，其实用python的虚拟环境就可以（哪怕是python -m venv venv也可以），目前未遇到其它人说的多版本python的干扰打包的情况。

3.当非要使用--nofollow-import-to时，尽量在原生python环境下，尽量不要在anaconda环境or其虚拟环境下，因为本人测试打包时，加了--nofollow-import-to，各种复制，复制到最后_ctypes报错，按照学习资料中群主的指导，采用everything搜索到anaconda下面的ffi的文件，但是依旧不起作用，原因是anaconda的问题，采用原生python同样的ffi文件就能解决问题。（未采用大型库时，不推荐加--nofollow-import-to）！【当在anaconda环境下，解决此问题，仅需要复制libffi-7.dll文件】