M1 macOS(ARM64) CLion配置C++ Matplotlib遇arm64未定义符号错误

报错核心成因 #

当前所有Undefined symbols for architecture arm64的链接错误由两个关键问题共同导致：

• 硬编码引用的macOS系统自带Python 2.7框架无arm64架构支持，且Python2专属API（如PyCObject_AsVoidPtr、PyString_FromString）在Python3版本中已被移除，对应的符号库不存在。
• 编译流程仅配置了头文件搜索路径，未将对应版本的Python动态库加入链接目标，链接器找不到匹配的函数实现。
• 引用的matplotlibcpp版本过旧，未适配Python3的API接口，和当前arm64架构的Python运行库不兼容。

Matplotlib 方案的修复步骤 #

如果继续使用matplotlibcpp方案，按以下步骤调整即可解决链接问题：

• 移除matplotlibcpp.h中硬编码的Python2.7头文件路径，改用本地通过Homebrew安装的arm64原生Python3（不要使用系统自带的Python框架）。
• 在CLion对应的CMakeLists.txt中补全链接配置：
  • 执行python3-config --prefix获取Python3的安装根路径，将该路径下的include目录加入头文件搜索范围
  • 执行python3 -c "import numpy; print(numpy.get_include())"获取numpy头文件路径，加入头文件搜索范围
  • 将Python3安装目录下的libpython3.x.dylib加入链接目标列表
• 替换为适配Python3的新版matplotlibcpp，旧版本中对Python2 API的调用会自动替换为Python3兼容的PyUnicode_FromString、PyCapsule_*接口，消除所有未定义符号报错。
• 检查所有依赖的Python、numpy、matplotlib包均为arm64原生架构，避免使用Rosetta转译的x86版本包导致架构不匹配。

适配场景的替代绘图方案 #

如果不想维护Python绑定的依赖环境，以下方案无Python运行时依赖、原生支持arm64 macOS + CLion开发环境，更适合PDE数值求解的可视化需求：

• matplotplusplus：API风格和matplotlib完全对齐，现有基于plt::plot的测试代码几乎无需修改即可迁移，CMake集成简单，编译过程无额外动态库依赖，从根源上避免Python符号链接错误。
• gnuplot-iostream：通过调用本地安装的gnuplot完成绘图，依赖体积小，对PDE仿真中的收敛曲线、二维场云图等场景的适配性强，编译配置仅需引入对应头文件即可。
• 轻量头文件绘图库：无第三方依赖，仅需引入单个头文件即可完成基础绘图，编译速度快，适合对数值结果做快速出图验证。

内容的提问来源于stack exchange，提问作者Josh E.