使用Nuitka打包Python项目后无法调用Smartsheet API，报Search类导入错误

看起来你遇到的问题是Nuitka打包时没有正确识别并包含Smartsheet SDK的Search相关依赖，导致运行时无法加载对应的API类，进而引发调用错误。结合你的代码和配置，我整理了几个针对性的解决方案：

1. 先检查代码中Smartsheet API的调用规范 #

首先我注意到你代码里用的是smart.Search.search_sheet(...)，但根据Smartsheet Python SDK的官方规范，客户端实例的搜索功能应该通过**小写的smart.search**属性来访问（对应smartsheet.search模块）。大写的Search可能在开发环境中因为动态导入的“侥幸”能运行，但打包后Nuitka无法追踪到这种动态依赖，就会触发错误。

先尝试把代码中的调用改成小写：

# 替换原来的大写Search为小写search
response = smart.search.search_sheet(sheetID, search)

2. 调整Nuitka配置，完整包含Smartsheet包 #

你的nuitka.yaml里只单独包含了Smartsheet的几个子模块，但Smartsheet SDK的内部依赖是联动的（比如api、model、search模块互相依赖），单独加子模块容易遗漏。建议直接把整个Smartsheet包加入include_packages，让Nuitka递归包含所有子模块：

修改nuitka.yaml的include_packages部分：

include_packages:
  - UI
  - Core
  - Scripts
  - PIL  # Pillow
  - cv2  # opencv-python
  - smartsheet  # 新增：包含整个Smartsheet SDK包

同时可以删除include_modules中所有和smartsheet相关的条目（比如smartsheet、smartsheet.search等），避免重复配置导致冲突。

3. 显式导入Search模块，帮助Nuitka追踪依赖 #

Nuitka对动态导入的支持有限，如果你代码中是通过客户端实例间接访问Search模块，Nuitka可能无法静态检测到这个依赖。可以在使用Smartsheet的代码开头，显式导入Search模块，强制Nuitka打包时包含它：

在你的代码文件（比如Helper.py或者调用Smartsheet的模块）开头添加：

from smartsheet import smartsheet
from smartsheet.search import Search  # 显式导入，让Nuitka能检测到这个模块

4. 临时关闭OneFile模式排查问题 #

OneFile模式下，Nuitka会把所有资源打包成单个可执行文件，运行时临时解压，偶尔会出现模块路径问题。可以先临时关闭onefile: true，用standalone: true单独测试：

standalone: true
onefile: false  # 先改成false测试

如果standalone模式能正常运行，再排查OneFile模式的路径问题（比如是否需要额外配置include_data_files处理Smartsheet的内部配置文件）。

5. 升级Nuitka到最新版本 #

旧版本的Nuitka对某些第三方包的兼容性较差，建议先升级到最新稳定版：

pip install --upgrade nuitka

按照以上步骤逐一尝试，应该能解决打包后Smartsheet Search模块无法加载的问题。

备注：内容来源于stack exchange，提问作者Mariano Gongora