如何解决‘Cannot import name’错误及Keras转Core ML导入问题

针对你的具体问题：ImportError: cannot import name 'convert' #

这个错误大概率是coremltools版本不匹配导致的API差异——不同版本的coremltools对模型转换函数的命名和位置做了调整，具体解决步骤如下：

1. 先检查当前的coremltools版本
   在终端运行以下命令查看版本号：

   pip show coremltools
   

   • 如果版本是2.x或更早：这个版本没有全局的convert函数，需要从keras转换器子模块导入：

     from coremltools.converters.keras import convert
     

     或者直接调用完整路径：

     import coremltools
     coreml_model = coremltools.converters.keras.convert(your_keras_model)
     

   • 如果版本是3.x及以上：from coremltools import convert是正确用法，但可能包安装有问题。试试升级到最新稳定版：

     pip install --upgrade coremltools
     

     升级完成后重新运行脚本即可。

通用解决「Cannot import name 'x'」错误的方法 #

遇到这类导入错误，你可以按以下步骤逐一排查：

• 核对版本与官方文档：很多Python库会在版本迭代中重命名、移动函数（比如coremltools的convert就是典型案例）。先确认你使用的库版本对应的官方文档，找到目标函数的正确导入路径。
• 排查同名文件冲突：如果你本地有和库名同名的脚本（比如自己写了coremltools.py），Python会优先导入本地文件而非官方库。检查当前目录下是否存在这类文件，有的话改名或移走即可。
• 确认虚拟环境一致性：如果你用了虚拟环境，要确保安装库的环境和运行脚本的环境是同一个。可以用which python（Linux/macOS）或where python（Windows）查看当前Python解释器路径，再用该路径下的pip安装/升级库。
• 重装损坏的包：有时候包安装过程中会出现文件缺失或损坏，试试完全卸载后重装：

  pip uninstall coremltools -y
  pip install coremltools
  

• 检查子模块归属：有些函数属于库的子模块而非全局导出，比如某些实验性功能可能在library.experimental子模块下，需要明确导入对应子模块。

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