解决QT报错：You need to set an executable in the custom run configuration

在使用 QtCreator 开发时，如果你的项目使用 CMake 构建，遇到这样一个问题：

You need to set an executable in the custom run configuration

这个问题通常出现在项目编译成功后，运行时报错。

问题描述

我在 QtCreator 中打开了一个基于 CMake 管理的项目，代码编译没有任何问题，但点击 运行 按钮后，弹出提示：

You need to set an executable in the custom run configuration

起初以为是 CMakeLists.txt 没有正确设置可执行文件，但检查后发现，已经写了 add_executable 语句：

add_executable(test src/test.cpp)
target_link_libraries(test algorithm_lib)

显然问题不在于 CMake 配置。

原因分析

QtCreator 运行或调试程序时，需要知道 具体运行哪个可执行文件。如果是 Qt 项目（.pro 管理），QtCreator 会自动配置，但使用 CMake 管理的项目，QtCreator 并不会自动识别最终的可执行文件。

所以虽然 add_executable 已经定义了目标文件，但 QtCreator 没有自动绑定它，导致运行时找不到对应的可执行程序。

解决方案

解决方法是：手动指定运行配置中的可执行文件路径。

步骤：

1、打开项目配置

在 QtCreator 左侧项目面板中，点击 “项目”（Projects）图标。

2、选择构建和运行设置

切换到 “构建与运行”（Build & Run）选项卡。

在左侧选择当前使用的 构建套件（Kit）

3、找到运行配置

点击 “运行”（Run）标签页。

在 “可执行文件”（Executable）输入框中，填入你项目的可执行文件路径。

4、确定路径

可执行文件一般位于构建目录（build 目录），例如：

/home/user/project/build/test

如果是 Windows，可能是：

D:\project\build\debug\test.exe

5、保存并运行

点击 应用（Apply），然后再次运行项目，问题解决。

效果验证

重新点击 运行按钮，程序可以正常启动，调试功能也恢复正常。

总结

这个问题的核心原因是 QtCreator 使用 CMake 项目时，不会自动关联可执行文件，需要手动指定。只要在 运行配置里设置正确的可执行文件路径，就能解决报错。