OSX 10.15.7 Time Machine迁移后Python ctypes导入报错求解

• 报错本质是跨系统版本的二进制兼容问题：加载失败的_ctypes.cpython-39-darwin.so模块，是适配macOS 11.0及以上版本编译的，依赖的系统符号__dyld_shared_cache_contains_path是macOS 11才新增到系统动态库中的接口，你当前运行的macOS 10.15.7的系统库/usr/lib/libSystem.B.dylib内不存在该符号，因此动态加载直接失败。
• 问题的直接诱因是Time Machine跨设备迁移：你当前使用的Python 3.9.1_2是从旧设备直接拷贝过来的Homebrew预编译版本，旧设备大概率运行macOS 11及以上系统，这套二进制包并没有针对你当前10.15的系统环境做适配，并非ctypes库本身损坏。

• 清除当前不兼容的旧Python环境
  • 执行命令卸载残留的跨版本Python包：
    brew uninstall python@3.9
    如果卸载时提示存在其他包依赖导致无法移除，追加--ignore-dependencies参数强制卸载，这些关联包大多也是迁移过来的不兼容版本，后续可按需重装。
  • 刷新Homebrew的版本索引与本地缓存，避免继续拉取不兼容的预编译包：

    brew update
    brew cleanup -s
    

• 重装适配当前系统的Python版本
  • 执行安装命令，Homebrew会自动匹配当前10.15系统拉取对应编译目标的Python安装包：
    brew install python@3.9
  • 安装完成后校验_ctypes模块的适配版本，确认没有版本错配：
    otool -l /usr/local/Cellar/python@3.9/*/Frameworks/Python.framework/Versions/3.9/lib/python3.9/lib-dynload/_ctypes.cpython-39-darwin.so | grep -A4 LC_VERSION_MIN_MACOSX
    只要输出中的最低支持版本不高于10.15，就说明模块适配当前系统。
• 验证功能恢复
  • 执行最初的测试命令，确认ctypes加载正常：
    python -c "import ctypes; print('ctypes加载验证通过')"
    无报错输出即表示修复完成。

• 之前无法启动的Jupyter等依赖ctypes的程序，不需要单独修复，只要在新的Python环境中重新安装对应依赖即可恢复正常：

  python -m pip install --upgrade pip setuptools wheel
  pip install jupyter
  

• 不建议为了绕开问题直接升级macOS版本到11以上：Time Machine迁移过来的Homebrew目录内所有二进制包都是跨版本拷贝的，升级系统后仍可能遇到路径、权限、库版本不匹配的零散问题，优先在当前系统环境中重新适配所有Homebrew安装的包是更稳定的方案。

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