Skip to content
TheChatArchiveThe Chat Archive
Metallama-4-maverick-03-26-experimental· MetaHugging Face LMArena Human Preference 140K

cmake程序, windows下如何 显示/隐藏控制台窗口

From a Chatbot Arena battleThe same person sent this prompt to two anonymous models at once. Compare it with Qwenqwq-32b’s answer.
  1. User

    cmake程序, windows下如何 显示/隐藏控制台窗口

  2. Meta Assistant

    一个很实用的问题!

    在 Windows 下,使用 CMake 生成的项目(例如使用 add_executable 创建的可执行文件),默认情况下会显示控制台窗口(也就是命令提示符窗口)。如果你希望 隐藏 控制台窗口(例如,对于 GUI 程序,你不希望用户看到一个黑乎乎的命令行窗口),或者 显示 控制台窗口(例如,对于控制台应用程序,你希望即使通过双击启动也能看到输出),可以通过设置编译链接选项来实现。

    下面分别介绍如何在 CMake 中控制 显示 或 隐藏 控制台窗口的方法。


    1. 隐藏控制台窗口(适用于 GUI 程序)

    在 Windows 下,控制台窗口的显示与否,是由链接器选项 /SUBSYSTEM 决定的:

    • /SUBSYSTEM:CONSOLE → 显示 控制台窗口(默认)
    • /SUBSYSTEM:WINDOWS → 隐藏 控制台窗口

    要在 CMake 中隐藏控制台窗口,你需要设置链接器的子系统为 WINDOWS。

    CMakeLists.txt 示例:

    cmake_minimum_required(VERSION 3.10)
    project(MyGUIApp)
    
    add_executable(${PROJECT_NAME} main.cpp)
    
    # 【关键代码】 隐藏控制台窗口(仅限 Windows)
    if (WIN32)
        set_target_properties(${PROJECT_NAME} PROPERTIES
            LINK_FLAGS "/SUBSYSTEM:WINDOWS"
        )
    endif()
    
    # (其他配置...)
    

    这样设置后:

    • 在 Windows 下编译生成的 MyGUIApp.exe,双击运行时不会弹出控制台窗口。
    • 程序仍然可以有 GUI 窗口(如果你在 main.cpp 里写了创建窗口的代码)。

    2. 强制显示控制台窗口(非常规需求,但以防万一)

    万一你的程序 默认隐藏了控制台(比如之前用了 /SUBSYSTEM:WINDOWS),但 临时想调试,强制显示控制台窗口,那么就 反过来设置:

    CMakeLists.txt 示例:

    cmake_minimum_required(VERSION 3.10)
    project(MyConsoleApp)
    
    add_executable(${PROJECT_NAME} main.cpp)
    
    # 【关键代码】 强制显示控制台窗口(仅限 Windows)
    if (WIN32)
        set_target_properties(${PROJECT_NAME} PROPERTIES
            LINK_FLAGS "/SUBSYSTEM:CONSOLE"
        )
    endif()
    

    这样设置后:

    • 即使你双击 MyConsoleApp.exe,也会 自动打开一个命令提示符窗口,printf、std::cout 的内容都会显示在里面。

    3. 更“现代”的 CMake 写法(推荐)

    上面的 LINK_FLAGS 写法比较“古老”,在 CMake 3.13 及以后,官方推荐用 WIN32_EXECUTABLE 属性来控制:

    隐藏控制台(生成 GUI 程序)

    cmake_minimum_required(VERSION 3.13)
    project(MyGUIApp)
    
    add_executable(${PROJECT_NAME} WIN32 main.cpp)
    #                    ^^^^^
    # 这表示:Windows 下使用 /SUBSYSTEM:WINDOWS
    

    显示控制台(生成控制台程序)

    cmake_minimum_required(VERSION 3.13)
    project(MyConsoleApp)
    
    add_executable(${PROJECT_NAME} main.cpp)
    # (啥都不加,默认就是 /SUBSYSTEM:CONSOLE)
    

    解释:

    • add_executable(MyApp WIN32 main.cpp) → 等价于设置 /SUBSYSTEM:WINDOWS,隐藏控制台。
    • add_executable(MyApp main.cpp) → 默认就是 /SUBSYSTEM:CONSOLE,显示控制台。

    4. 验证方法

    1. 写一个简单的 main.cpp:

      #include <iostream>
      int main() {
          std::cout << "Hello, World!\n";
          system("pause"); // 防止闪退
          return 0;
      }
      
    2. 场景 1(隐藏控制台):

      add_executable(MyGUIApp WIN32 main.cpp)
      
      • 编译后,双击 MyGUIApp.exe,只会看到一个黑屏闪一下然后暂停(因为 system("pause")),没有控制台窗口。
    3. 场景 2(显示控制台):

      add_executable(MyConsoleApp main.cpp)
      
      • 编译后,双击 MyConsoleApp.exe,会直接弹出 cmd 窗口,显示 Hello, World! 并暂停。

    总结:

    需求CMake 写法链接器选项
    隐藏控制台(GUI程序)add_executable(MyApp WIN32 main.cpp)/SUBSYSTEM:WINDOWS
    显示控制台(命令行程序)add_executable(MyApp main.cpp)/SUBSYSTEM:CONSOLE
    (兼容旧项目)隐藏控制台set_target_properties(MyApp PROPERTIES LINK_FLAGS "/SUBSYSTEM:WINDOWS")
    (兼容旧项目)显示控制台set_target_properties(MyApp PROPERTIES LINK_FLAGS "/SUBSYSTEM:CONSOLE")

    推荐:使用 WIN32 关键字(新写法),简洁明了:

    • 带 WIN32 → 无控制台窗口,适合 GUI 程序。
    • 不带 WIN32 → 有控制台窗口,适合命令行工具。

    现在重新 cmake ..、cmake --build . 生成一下试试吧! 🎉

    如果还有其他跨平台需求(比如 Linux 下没这个问题,macOS 如何处理等),欢迎继续提问!😊

Responses were produced in different, uncontrolled contexts (system prompts, settings, prior turns). This is not a benchmark.

Identical first prompt