为Pyodide构建Cython扩展遇ModuleNotFoundError问题排查求助

• 确认wheel包的兼容性
  检查你的newt wheel命名是否与Pyodide运行环境完全匹配：

  • 打开console.html控制台，执行import sys; print(sys.version)确认Pyodide的Python版本，需与wheel文件名里的cp310标签一致。
  • 执行import pyodide; print(pyodide.__emscripten_version__)查看Pyodide使用的Emscripten版本，要和wheel中的emscripten_3_1_14对应。

• 检查Pyodide的包搜索路径
  在console.html控制台中执行以下命令，确认dist目录是否在Python的搜索路径内：

  import sys
  print(sys.path)
  

  如果dist目录不在列表中，手动添加路径后再尝试导入：

  import sys
  sys.path.append("/dist")
  

  也可以在加载Pyodide时指定包源目录：

  await loadPyodide({ indexURL: "./dist/" });
  

• 验证wheel包的完整性
  解压newt的wheel包，检查内部结构是否正确：

  • 确认解压后的目录中存在newt模块目录（或对应的.so/.py文件），且路径符合Python包的规范。
  • 查看RECORD文件，确认所有必要文件的条目都存在，没有路径错误或缺失。
    可以用以下命令解压：

  unzip newt-1.0-cp310-cp310-emscripten_3_1_14_wasm32.whl -d newt_unpacked
  

• 尝试显式加载包
  不要直接使用import newt，先通过Pyodide的API显式加载wheel包：

  await pyodide.loadPackage("./dist/newt-1.0-cp310-cp310-emscripten_3_1_14_wasm32.whl");
  

  加载完成后再执行import newt尝试导入。

• 查看加载日志排查细节
  打开浏览器开发者工具的Console标签，查看Pyodide加载过程的详细日志，是否有解压失败、依赖缺失等被忽略的错误。可以开启调试级日志：

  await loadPyodide({ logLevel: "DEBUG" });
  

• 重新检查构建过程
  重新运行newt包的构建命令，仔细查看输出日志：

  • 确认Cython扩展已成功编译为Emscripten兼容的wasm模块。
  • 确认pyodide_build工具在打包过程中没有抛出警告或错误。

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