PyQt动态执行脚本导入失败及Poetry配置问题求助

一、动态脚本导入失败问题（PyInstaller打包+Poetry环境） #

问题场景 #

• 主PyQt应用通过subprocess.Popen动态执行子脚本，本地直接运行正常，但打包成exe后或在Poetry shell中运行时，子脚本抛出ModuleNotFoundError: No module named 'utils'。
• 目录结构（已将原utils文件夹更名为python_utils）：

folder-root
├── pyqtWindowApp.py  # 主应用入口
├── actionables
│   └── python
│       └── file_to_run.py  # 被动态执行的子脚本
└── python_utils
    └── file_utils.py

• 子脚本原有路径添加代码（存在两处问题）：

sys.path.append(os.path.abspath(os.path.join(os.path.dirname(__file__), '../../utils')))
from utils import file_utils

核心原因 #

1. 路径计算错误：os.path.dirname(__file__)在PyInstaller打包后的临时环境或Poetry隔离环境中，指向的路径与本地开发环境不一致，导致无法正确定位python_utils目录。
2. 文件夹名称不匹配：已将utils更名为python_utils，但代码中仍使用旧名称。

解决方案 #

方案1：传递项目根路径给子脚本（最稳妥）

主应用中先获取项目根目录，作为参数传递给子脚本：

# pyqtWindowApp.py
import os
import sys
import subprocess

# 获取项目根目录（当前主脚本所在目录）
root_dir = os.path.abspath(os.path.dirname(__file__))
# 调用子脚本时传入根路径
subprocess.Popen(
    [sys.executable, 'actionables/python/file_to_run.py', 'arg1', root_dir],
    stdout=subprocess.PIPE,
    stderr=subprocess.PIPE
)

子脚本直接使用传入的根路径添加到sys.path：

# file_to_run.py
import os
import sys

# 从命令行参数获取根路径（第三个参数）
root_dir = sys.argv[2]
# 添加python_utils目录到sys.path
sys.path.append(os.path.join(root_dir, 'python_utils'))
# 直接导入file_utils
from file_utils import *

方案2：修正子脚本路径计算逻辑

如果不想传递参数，可修改子脚本的路径计算逻辑，确保能正确回溯到项目根目录：

# file_to_run.py
import os
import sys

# 获取当前脚本的绝对路径
current_script = os.path.abspath(__file__)
# 向上回溯3级到folder-root（actionables/python -> actionables -> folder-root）
root_dir = os.path.dirname(os.path.dirname(os.path.dirname(current_script)))
# 添加python_utils路径
sys.path.append(os.path.join(root_dir, 'python_utils'))
# 导入模块
from file_utils import *

方案3：PyInstaller打包时包含资源目录

打包成onefile时，PyInstaller不会自动包含python_utils目录，需手动指定：

# Windows系统用分号分隔路径
pyinstaller --onefile pyqt.pyw -i pyqt.ico --add-data "python_utils;python_utils"
# Linux/macOS用冒号分隔
pyinstaller --onefile pyqt.pyw -i pyqt.ico --add-data "python_utils:python_utils"

这样打包后的exe运行时，会将python_utils解压到临时目录，子脚本可正常访问。

二、Poetry配置错误问题 #

问题场景 #

在pyproject.toml中添加的scripts配置不符合Poetry规范，执行poetry install时报错：

The Poetry configuration is invalid:
- [scripts.scripts] ['python_utils\file_utils.py'] is not valid under any of the given schemas

核心原因 #

Poetry的[tool.poetry.scripts]字段用于定义可执行命令，格式为命令名 = "模块名:函数名"，而非文件路径列表。

解决方案 #

1. 将python_utils转为可导入包（解决Poetry环境导入问题）

• 第一步：在python_utils目录下创建空的__init__.py，使其成为Python包。
• 第二步：在pyproject.toml中添加本地包依赖：

[tool.poetry.dependencies]
python = "^3.8"
# 添加本地python_utils包
python-utils = { path = "./python_utils" }

执行poetry install后，Poetry会将python_utils加入环境的sys.path，在Poetry shell中运行主应用即可正常导入。

2. 正确配置Poetry可执行脚本（如果需要）

如果想通过Poetry命令运行file_utils.py中的逻辑，需定义具体的入口函数：

# python_utils/file_utils.py
def main():
    # 这里是脚本的主逻辑
    print("Executing file_utils logic")

if __name__ == "__main__":
    main()

然后在pyproject.toml中配置scripts：

[tool.poetry.scripts]
# 命令名 = "包名.模块名:函数名"
run-file-utils = "python_utils.file_utils:main"

执行poetry install后，可通过poetry run run-file-utils直接运行该函数。

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