Debian Linux开发Python应用：免装Python/依赖且不使用Docker的共享方案

一、使用PyInstaller打包 #

PyInstaller是Python生态中最常用的打包工具，能把你的代码、依赖库连同Python解释器一起打包成可直接运行的文件，对方无需额外安装任何环境。

步骤：

1. 安装PyInstaller

   pip install pyinstaller
   

2. 执行打包命令
   进入应用主脚本所在目录，运行：

   pyinstaller --onefile your_main_script.py
   

   • --onefile 参数会生成单个可执行文件，方便分发；如果应用包含多个模块或资源文件，也可以省略该参数，生成一个包含所有文件的文件夹。
3. 处理资源文件（如果有）
   若应用依赖配置文件、图片等资源，用--add-data参数指定文件映射：

   pyinstaller --onefile --add-data "config.ini:." your_main_script.py
   

   格式为源文件路径:目标路径，这里的.表示资源会被放到可执行文件同目录。
4. 测试结果
   打包完成后，dist目录下会生成目标可执行文件，把它发给对方，直接在Debian终端运行即可。

二、使用Nuitka编译（性能更优） #

Nuitka会把Python代码编译为C代码再生成原生可执行文件，运行效率比PyInstaller打包的更高，依赖处理也更彻底。

步骤：

1. 安装Nuitka及编译依赖

   pip install nuitka
   apt install gcc python3-dev
   

2. 执行编译命令

   python -m nuitka --standalone --onefile your_main_script.py
   

   • --standalone 确保生成的文件不依赖系统Python；--onefile 生成单个可执行文件。
3. 处理资源文件
   若有资源需要打包，用--include-data-files参数：

   python -m nuitka --standalone --onefile --include-data-files=config.ini=. your_main_script.py
   

4. 测试结果
   编译完成后，可执行文件直接生成在当前目录，分发该文件即可。

为什么直接打包Python目录无效？ #

你之前尝试的tar Python安装目录方法，问题在于Python安装路径里包含大量和当前系统绑定的动态链接库，还有硬编码的路径配置。放到其他机器上时，系统可能找不到依赖的库文件，或者路径不匹配，导致无法正常运行。而上面两种工具会自动收集所有依赖、重定向路径，生成真正独立的可执行文件。

内容的提问来源于stack exchange，提问作者Kristiyan Kotomanov