如何在CLion中添加Python路径解决matplotlib-cpp找不到Python3报错

问题核心原因 #

CMake的find_package(Python3)检索逻辑在Windows环境下不会优先读取CLion的Python解释器配置或系统PATH变量，需要手动显式指定Python3的相关路径才能完成检索。

方案1：修改CMakeLists.txt显式指定路径（快速生效） #

适合仅本地运行项目的场景，修改后直接加载CMake即可生效：

• 首先确认你本地Python3.10的实际安装路径，默认用户级安装路径为C:/Users/你的用户名/AppData/Local/Programs/Python/Python310，全局安装路径通常为C:/Program Files/Python310，注意路径分隔符使用正斜杠/或双反斜杠\\，禁止使用单个反斜杠。
• 在你现有CMakeLists.txt的cmake_minimum_required行之后、project行之前，添加如下配置，将路径替换为你本地的实际路径：

# 显式指定Python3检索路径
set(Python3_ROOT_DIR "C:/Users/xxx/AppData/Local/Programs/Python/Python310" CACHE PATH "Python3根目录" FORCE)
set(Python3_EXECUTABLE "${Python3_ROOT_DIR}/python.exe" CACHE FILEPATH "Python3可执行文件" FORCE)
set(Python3_LIBRARIES "${Python3_ROOT_DIR}/libs/python310.lib" CACHE FILEPATH "Python3库文件" FORCE)
set(Python3_INCLUDE_DIRS "${Python3_ROOT_DIR}/include" CACHE PATH "Python3头文件目录" FORCE)

• 右键项目选择「重新加载CMake项目」即可解决报错。

方案2：CLion CMake配置添加参数（无代码侵入，更规范） #

适合不希望修改项目CMakeLists.txt的场景，配置仅对本地CLion生效：

• 打开CLion设置路径：「文件->设置->构建、执行、部署->CMake」
• 在右侧「CMake选项」输入框中，添加如下参数，路径替换为你本地的Python3.10安装路径：

-DPython3_ROOT_DIR=C:/Users/xxx/AppData/Local/Programs/Python/Python310
-DPython3_EXECUTABLE=C:/Users/xxx/AppData/Local/Programs/Python/Python310/python.exe
-DPython3_LIBRARIES=C:/Users/xxx/AppData/Local/Programs/Python/Python310/libs/python310.lib
-DPython3_INCLUDE_DIRS=C:/Users/xxx/AppData/Local/Programs/Python/Python310/include

• 点击「应用」->「确定」后重新加载CMake项目即可。

通用注意事项 #

• 工具链位数必须和Python位数匹配：如果安装的是64位Python，CLion的构建工具链必须选择64位版本（MinGW64、MSVC x64等），32位Python对应32位工具链，位数不匹配也会触发库找不到的报错。
• 确认Python安装目录下libs文件夹内存在对应版本的lib文件，比如Python3.10对应python310.lib，如果缺失需要重新运行Python安装包，选择「修改」后勾选「开发工具」组件完成安装。
• 配置完成后如果仍报错，先删除项目根目录下的cmake-build-debug文件夹清除旧缓存，再重新加载CMake即可。

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