Eclipse PyDev环境下如何用Nuitka正确导入外部PyLibUty包

问题背景 #

使用Eclipse+PyDev开发Python应用，工作区结构如下：

c:/Dati/workspaces/PythonEclipse/ (工作区根目录)
├─ APyLibUty
│  └─ PyLibUty (需导入的公共工具包)
└─ MyProject
   └─ src
      └─ main.py

此前用PyInstaller时，PyDev和打包工具均可正常识别导入PyLibUty，但切换到Nuitka后，只有将PyLibUty复制到MyProject子目录中，生成的二进制文件才能正常运行，否则会提示包缺失。需要找到无需复制包的简便解决方案。

当前使用的Nuitka编译脚本（bat）：

cd C:\Dati\workspaces\PythonEclipse\JanasSchoolsWebLoginPySide2\src
python -m nuitka wbbPyb2Main.py^
 --standalone^
 --follow-imports^
 --windows-console-mode=force^
 --include-package=PyLibUty^
 --include-data-dir=locales=locales^
 --include-data-file=config-cl.ini=config-cl.ini^
 --include-data-file=Back.png=Back.png^
 --include-data-file=Cancel.png=Cancel.png^
 --include-data-file=Exit.png=Exit.png^
 --include-data-file=Forward.png=Forward.png^
 --include-data-file=Home.png=Home.png^
 --include-data-file=Load.png=Load.png^
 --include-data-file=Refresh.png=Refresh.png^
 --include-data-file=key.ico=key.ico^
 --include-data-file=key.png=key.png^
 --include-package=certifi,urllib3.contrib.socks^
 --enable-plugin=pyside2,pywebview,dll-files,glfw,implicit-imports^
 --output-dir=distNuitka^
 --output-file=jswl.exe
copy .\libs\libEGL.dll .\distNuitka\wbbPyb2Main.dist\
copy .\libs\libGLESv2.dll .\distNuitka\wbbPyb2Main.dist\
copy .\libs\opengl32sw.dll .\distNuitka\wbbPyb2Main.dist\
cd ..\bat

解决办法 #

1. 编译时直接指定包所在目录（最快临时方案） #

Nuitka默认仅搜索Python标准库路径和当前脚本目录，需通过--include-package-dir参数明确告知PyLibUty的父目录位置。修改编译脚本中的Nuitka命令，添加一行：

--include-package-dir=C:\Dati\workspaces\PythonEclipse\APyLibUty^

修改后的核心命令片段：

python -m nuitka wbbPyb2Main.py^
 --standalone^
 --follow-imports^
 --windows-console-mode=force^
 --include-package=PyLibUty^
 --include-package-dir=C:\Dati\workspaces\PythonEclipse\APyLibUty^
 ... # 其他原有参数不变

此方法无需修改代码，直接让Nuitka定位到公共包并打包。

2. 代码中添加包路径配合编译参数 #

若不想每次编译都写绝对路径，可在main.py开头添加路径配置：

import sys
import os
# 从当前脚本目录向上回溯到工作区根目录，加入APyLibUty路径
sys.path.append(os.path.abspath(os.path.join(os.path.dirname(__file__), '../../APyLibUty')))
import PyLibUty

编译时仍需保留--include-package=PyLibUty参数，确保Nuitka追踪并打包该包。

3. 将公共包设为开发模式安装（长期最优方案） #

把APyLibUty做成可安装的Python包，用开发模式安装后，可像第三方库一样直接导入，无需任何路径配置：

1. 在APyLibUty目录下创建pyproject.toml文件，示例内容：

[build-system]
requires = ["setuptools>=61.0"]
build-backend = "setuptools.build_meta"

[project]
name = "PyLibUty"
version = "0.1.0"
packages = ["PyLibUty"]

2. 打开命令行进入APyLibUty目录，执行：

pip install -e .

安装后，无论是PyDev运行还是Nuitka编译，都能直接import PyLibUty，无需额外参数或路径代码。

内容的提问来源于stack exchange，提问作者Massimo Manca