1. 为什么要在 Windows 上折腾 GTK3 加 CLion 这套组合先把结论摆在前面如果你是一个长期在 Windows 上写 C/C 的人又恰好想做一个带原生窗口界面的桌面小工具那 GTK3 加 CLion 这套组合是值得花一个下午去搭起来的。GTK3 本身是跨平台的 C 语言图形界面库Linux 桌面上一大堆软件都用它Windows 上虽然生态没那么热闹但跑起来完全没问题。CLion 是 JetBrains 家的 C/C IDE代码补全、跳转、调试、CMake 集成这些体验在同类工具里属于第一梯队。问题在于这两样东西凑到 Windows 上中间隔着一层叫 MSYS2 或者 MinGW 的东西新手很容易在“我明明装好了为什么 CLion 找不到头文件”这一步卡住。我自己第一次搭的时候光是让pkg-config在 CLion 里正常返回 GTK3 的编译参数就来回折腾了两三个小时。所以这篇东西不是那种“点下一步下一步就完事”的教程而是把每一步背后的原因、容易踩的坑、以及我实测下来比较稳的做法都摊开讲。这套环境搭好之后你能做的事情很具体用 C 语言写 GTK3 界面程序在 CLion 里直接点运行就能弹出窗口断点调试、变量查看、CMake 重新加载都正常。适合谁看适合已经会一点 C 语言、用过或者听说过 CMake、但没在 Windows 上正经配过 GTK 开发环境的人。如果你连 C 语言指针都还没搞明白建议先把基础补一补再回来不然报错信息会让你怀疑人生。我下面讲的这套流程核心思路是用 MSYS2 提供 GTK3 的库和工具链用 CLion 作为编辑和调试的前端两者通过 CMake 的find_package或者pkg-config对接。为什么选 MSYS2 而不是别的因为它在 Windows 上维护了一个相当完整的包仓库GTK3 及其依赖GLib、Pango、Cairo、GDK-Pixbuf 等都能一条命令装齐而且它自带的 MinGW-w64 工具链和 CLion 的兼容性经过很多人验证属于“照着做大概率能成”的路线。2. 环境搭建前的整体设计与工具选型考量2.1 为什么是 MSYS2 而不是 WSL 或纯 Visual Studio在 Windows 上搞 GTK3摆在面前的路其实有好几条。第一条是 WSL装个 Linux 子系统里面apt install libgtk-3-dev就完事编译也顺。但 WSL 的问题是图形界面要走一层转发调试的时候窗口弹出来那一下总感觉隔了一层而且 CLion 连 WSL 工具链虽然支持配置起来又是另一套心智负担。第二条是纯 Visual Studio 加 vcpkgvcpkg 确实能装 GTK3但 GTK3 在 Windows 上的官方支持本来就偏向 MinGW 系用 MSVC 编译经常会遇到一些边边角角的链接问题对新手不友好。第三条就是 MSYS2。它的本质是一个在 Windows 上模拟类 Unix 环境的软件发行版自带包管理器pacman你可以理解成 Windows 里的一个迷你 Linux 包管理生态。它提供两套主要的工具链一套是mingw64编译出来的是原生 Windows 程序不依赖 MSYS2 的运行时另一套是msys编译出来的是依赖 MSYS2 运行时的程序。做 GTK3 桌面程序一定要用mingw64这套因为你要的是能独立运行的 exe而不是绑死在 MSYS2 环境里的东西。选 MSYS2 的另一个理由是 CLion 对它的识别很成熟。CLion 在设置工具链的时候可以直接指定 MSYS2 的安装路径它会自动找到gcc、g、gdb、cmake这些。相比之下你如果自己东拼西凑一个 MinGW版本对不上、路径找不到的情况太常见了。2.2 CLion 的角色定位与 CMake 的衔接方式CLion 本身不提供编译器它是个“前端”负责编辑、索引、调用外部工具链、展示调试信息。所以真正干活的是 MSYS2 里的 GCC 和 GDB。CLion 通过 CMake 来组织项目CMake 又通过find_package或者pkg-config来找到 GTK3 的头文件路径和库文件路径。这里有个关键点很多人没搞明白GTK3 在 MSYS2 里安装后会提供一个.pc文件pkg-config 的元数据文件里面记录了编译 GTK3 程序需要的-I头文件路径和-L库路径以及-l链接库名。CMake 里可以用PkgConfig模块去读这个文件也可以用 GTK3 自带的 CMake 配置文件。我实测下来在 MSYS2 环境下用pkg-config的方式最稳因为 GTK3 的 CMake config 文件有时候路径处理会出幺蛾子。所以整体设计就是MSYS2 装 GTK3 和工具链CLion 指向 MSYS2 的工具链项目里写一个 CMakeLists.txt用pkg_check_modules把 GTK3 的编译参数拉进来。这样一套下来你在 CLion 里点构建它调用 MSYS2 的 GCCGCC 根据 CMake 生成的参数去 MSYS2 的目录里找 GTK3 头文件和库链接成 exe运行的时候因为用的是 mingw64 工具链exe 可以直接双击跑前提是 GTK3 的 dll 在 PATH 里或者跟 exe 放一起。2.3 版本选择的几个现实考虑MSYS2 的mingw64仓库里 GTK3 的版本更新还算勤快目前主流是 3.24.x 这个系列。我不建议去追最新的 4.x因为 GTK4 的 API 和 GTK3 差别不小网上大部分中文资料还是 GTK3 的新手照着 GTK4 的文档写 GTK3 的代码会各种编译不过。CLion 这边2023 之后的版本对 MSYS2 的支持都很成熟用较新的稳定版就行没必要追 EAP。还有一个坑是 32 位和 64 位的选择。现在基本无脑选 64 位mingw64就是 64 位的mingw32才是 32 位的。除非你有特殊的老系统兼容需求否则一律 64 位。3. 手把手实操从零把环境跑通3.1 安装 MSYS2 并配置国内镜像源先去 MSYS2 官网下载安装包一路默认安装建议装在C:\msys64这种没有空格和中文的路径下。装完之后打开 “MSYS2 UCRT64” 或者 “MSYS2 MINGW64” 的终端。这里要注意MSYS2 现在有 UCRT64、MINGW64、CLANG64 好几个环境我们统一用 MINGW64因为 GTK3 的包在 MINGW64 仓库里最全。打开 MINGW64 终端后第一件事是换镜像源不然下载速度能让你等到睡着。编辑/etc/pacman.d/mirrorlist.mingw64、mirrorlist.msys、mirrorlist.mingw32这几个文件把国内的镜像地址放到最前面。具体地址我就不贴了搜“MSYS2 镜像源”能找到一堆选几个延迟低的就行。换完之后执行pacman -Syu这个命令会更新包数据库和已安装的包。注意第一次执行-Syu之后它可能会提示你关闭终端重新打开这是正常的照做就行。重新打开后再执行一次pacman -Syu确保全部更新完。提示MSYS2 的更新有时候会要求你先更新pacman本身再更新其他包如果遇到报错按它提示的顺序来别硬刚。3.2 安装 GTK3 开发包和工具链更新完之后安装 GTK3 和编译工具。在 MINGW64 终端里执行pacman -S mingw-w64-x86_64-gtk3 mingw-w64-x86_64-toolchain mingw-w64-x86_64-cmake mingw-w64-x86_64-pkg-config这条命令装的东西有点多我拆开说gtk3是 GTK3 的库和头文件toolchain是一组工具链的集合包包含 GCC、GDB、binutils 等cmake是构建工具pkg-config是帮我们查询库编译参数的工具。装的过程中会问你好几次确认一路回车默认全装就行。装完之后验证一下在 MINGW64 终端里敲pkg-config --cflags --libs gtk-3.0如果输出了一长串-I和-L以及-lgtk-3之类的参数说明 GTK3 装好了。如果提示Package gtk-3.0 was not found那多半是你没在 MINGW64 终端里执行或者包没装全。注意pkg-config查询的包名是gtk-3.0不是gtk3也不是gtk-3.0这个加号和点号的位置很容易记错记不住就pkg-config --list-all | grep gtk看一眼。3.3 配置 CLion 的工具链指向 MSYS2打开 CLion进File - Settings - Build, Execution, Deployment - Toolchains。点加号新建一个工具链名字随便起比如 “MSYS2-MINGW64”。然后关键的一步把Toolset那一栏的路径指向C:\msys64\mingw64假设你装在默认位置。CLion 会自动探测出C:\msys64\mingw64\bin\gcc.exe、g.exe、gdb.exe这些。如果自动探测没出来就手动指定C Compiler填C:\msys64\mingw64\bin\gcc.exeC Compiler填g.exeDebugger填gdb.exe。CMake那一栏可以留空让 CLion 用自带的也可以指向 MSYS2 里的 cmake我一般用 CLion 自带的省事。建好之后把这个工具链移到列表最上面或者在你项目的 CMake 配置里选它。然后新建项目的时候CLion 会让你选工具链选这个 MSYS2 的就行。3.4 写一个能跑起来的最小 CMakeLists.txtCLion 新建 C 项目会自带一个CMakeLists.txt我们把它改成下面这样cmake_minimum_required(VERSION 3.20) project(gtk3_demo C) set(CMAKE_C_STANDARD 11) find_package(PkgConfig REQUIRED) pkg_check_modules(GTK3 REQUIRED gtk-3.0) include_directories(${GTK3_INCLUDE_DIRS}) link_directories(${GTK3_LIBRARY_DIRS}) add_executable(gtk3_demo main.c) target_link_libraries(gtk3_demo ${GTK3_LIBRARIES}) target_compile_options(gtk3_demo PRIVATE ${GTK3_CFLAGS_OTHER})这里解释几个关键点。find_package(PkgConfig REQUIRED)是让 CMake 加载 PkgConfig 模块这个模块提供了pkg_check_modules命令。pkg_check_modules(GTK3 REQUIRED gtk-3.0)会去调用pkg-config把gtk-3.0的编译参数存到GTK3_开头的变量里。GTK3_INCLUDE_DIRS是头文件路径GTK3_LIBRARY_DIRS是库路径GTK3_LIBRARIES是要链接的库名列表GTK3_CFLAGS_OTHER是其他编译选项。为什么不用find_package(GTK3)因为 GTK3 在 MSYS2 里提供的 CMake config 文件有时候会因为路径里的反斜杠和正斜杠混用导致解析问题而pkg-config这条路是 GTK 官方在类 Unix 环境下最推荐的在 MSYS2 里同样适用稳定性我实测更好。3.5 写一个最小 GTK3 窗口程序验证main.c写个最简单的#include gtk/gtk.h static void on_activate(GtkApplication *app, gpointer user_data) { GtkWidget *window gtk_application_window_new(app); gtk_window_set_title(GTK_WINDOW(window), GTK3 on Windows); gtk_window_set_default_size(GTK_WINDOW(window), 400, 300); gtk_widget_show_all(window); } int main(int argc, char **argv) { GtkApplication *app gtk_application_new(com.example.gtk3demo, G_APPLICATION_DEFAULT_FLAGS); g_signal_connect(app, activate, G_CALLBACK(on_activate), NULL); int status g_application_run(G_APPLICATION(app), argc, argv); g_object_unref(app); return status; }这段代码创建了一个 400x300 的窗口标题是 “GTK3 on Windows”。gtk_application_new的第二个参数在 GTK3 不同小版本里名字有变化老版本是G_APPLICATION_FLAGS_NONE新版本推荐G_APPLICATION_DEFAULT_FLAGS如果编译报未定义换成前者即可。在 CLion 里点构建如果一切正常会在cmake-build-debug目录下生成gtk3_demo.exe。直接点运行应该能弹出一个空窗口。如果弹窗失败或者报缺少 dll往下看排查部分。4. 常见问题与排查技巧实录4.1 编译期报错找不到 gtk/gtk.h这是最常见的问题报错长这样fatal error: gtk/gtk.h: No such file or directory。原因基本只有一个CMake 没有正确拿到 GTK3 的头文件路径。排查顺序如下。第一确认你在 MINGW64 终端里执行pkg-config --cflags gtk-3.0能输出内容。如果这一步就失败说明 GTK3 没装好或者pkg-config不在 PATH 里。第二确认 CLion 用的工具链是 MSYS2 的 MINGW64而不是它自带的 MinGW 或者别的。第三确认CMakeLists.txt里pkg_check_modules那行没有拼写错误包名是gtk-3.0。还有一个隐蔽的坑CLion 有时候会缓存 CMake 配置你改了CMakeLists.txt之后它没重新加载。这时候点Tools - CMake - Reset Cache and Reload Project强制刷新一次。4.2 链接期报错undefined reference togtk_application_window_new这种undefined reference的错误说明头文件找到了但链接的时候没找到对应的库。原因通常是target_link_libraries里没有把${GTK3_LIBRARIES}加进去或者加进去了但顺序不对。GTK3 依赖的库很多链接顺序在 Linux 上比较敏感在 MSYS2 上虽然好一些但也要保证 GTK3 的库在依赖它的库前面。用pkg_check_modules拿到的GTK3_LIBRARIES顺序是 pkg-config 排好的直接用就行别自己手动调整顺序。如果确认加了还是报错检查一下是不是链接到了错误的库路径。可以在 CLion 的 CMake 输出里搜-L看看它去的目录是不是C:/msys64/mingw64/lib。4.3 运行期报错缺少 libgtk-3-0.dll 之类的动态库编译链接都过了双击 exe 或者 CLion 里点运行弹出一个错误框说找不到libgtk-3-0.dll。这是因为 Windows 运行 exe 的时候会在 exe 所在目录和 PATH 环境变量里找 dll而 GTK3 的 dll 在C:\msys64\mingw64\bin里这个目录默认不在 PATH 里。解决办法有两个。一是把C:\msys64\mingw64\bin加到系统 PATH 里一劳永逸但会往 PATH 里塞一大堆东西。二是把需要的 dll 拷贝到 exe 同目录比较干净但麻烦。我一般用第一种因为开发阶段经常要跑加 PATH 省事。加完 PATH 记得重启 CLion不然它读不到新的环境变量。提示如果你不想污染系统 PATH可以在 CLion 的 Run/Debug Configuration 里给这个可执行文件单独设置环境变量把C:\msys64\mingw64\bin加到PATH前面。这样只影响这个项目的运行不影响系统全局。4.4 CLion 里 GDB 调试 GTK3 程序卡住或崩溃有时候你在 CLion 里用 GDB 调试 GTK3 程序断点能停但一继续运行就卡死或者报一些奇怪的信号。这通常是因为 GTK3 内部有自己的线程和信号处理机制GDB 默认会捕获所有信号包括 GTK 正常使用的那些。解决办法是在 CLion 的 GDB 设置里配置不捕获SIG32、SIG33这类 GTK 用的信号。具体在Settings - Build, Execution, Deployment - Debugger - Data Views - GDB或者直接在项目的.gdbinit里加handle SIG32 nostop noprint pass之类的配置。另一个可能是 GDB 版本和 GCC 版本不匹配。MSYS2 的mingw-w64-x86_64-toolchain装出来的 GCC 和 GDB 是配套的一般不会有问题。如果你单独升级过其中一个可能会出幺蛾子建议一起升级。4.5 常见问题速查表问题现象最可能原因解决动作找不到 gtk/gtk.hCMake 没拿到 GTK3 头文件路径检查 pkg-config 是否可用重置 CMake 缓存undefined reference没链接 GTK3 库或链接顺序错确认 target_link_libraries 包含 GTK3_LIBRARIES运行时缺 dllGTK3 的 bin 目录不在 PATH把 C:\msys64\mingw64\bin 加入 PATH 或拷贝 dllGDB 调试卡死GDB 捕获了 GTK 内部信号配置 GDB 忽略 SIG32/SIG33 等信号pkg-config 找不到包不在 MINGW64 终端或包名写错用 MINGW64 终端包名 gtk-3.0CMake 配置报错工具链选错或路径含空格确认工具链指向 MSYS2 MINGW64路径无空格5. 几个让开发体验更顺的实操心得5.1 把 pkg-config 的路径显式告诉 CMake虽然 CLion 通过工具链设置一般能自动找到pkg-config但有时候它找的是 MSYS2 的usr/bin下的那个而不是mingw64/bin下的两者行为有差异。稳妥的做法是在CMakeLists.txt开头显式设置set(PKG_CONFIG_EXECUTABLE C:/msys64/mingw64/bin/pkg-config.exe)这样不管 CLion 怎么探测用的都是我们指定的这个。路径里的斜杠用正斜杠CMake 在 Windows 上认这个。5.2 用 CMake Presets 固化配置CLion 现在对CMakePresets.json支持很好。你可以把工具链、生成器、构建类型这些写进 presets 文件团队协作或者换机器的时候直接复用不用每次手动点。一个最小的 preset 大概长这样{ version: 3, configurePresets: [ { name: msys2-mingw64, generator: Ninja, binaryDir: ${sourceDir}/build, cacheVariables: { CMAKE_C_COMPILER: C:/msys64/mingw64/bin/gcc.exe, CMAKE_CXX_COMPILER: C:/msys64/mingw64/bin/g.exe, CMAKE_BUILD_TYPE: Debug } } ] }用 Ninja 作为生成器比用 MinGW Makefiles 快不少CLion 自带 Ninja不用额外装。5.3 处理 GTK3 的国际化与资源文件如果你后面要做稍微正经一点的程序会碰到界面翻译和图标资源的问题。GTK3 用.ui文件描述界面用 GResource 把资源编译进 exe。在 MSYS2 环境下glib-compile-resources这个工具是有的在CMakeLists.txt里加一段自定义命令就能把.gresource.xml编译成 C 源文件参与构建。这块内容比较多我这里只点一下知道有这么回事需要的时候去查 GLib 的 GResource 文档就行。5.4 关于中文显示和字体GTK3 在 Windows 上默认用的字体渲染有时候中文会发虚或者字体不对。可以在程序启动时设置一下字体或者写一个settings.ini放到 exe 同目录指定gtk-font-name。我实测下来指定成Microsoft YaHei UI 10显示效果比较正常。这个不是必须的但如果你做的是中文界面程序早点处理比后面返工强。5.5 打包发布时的注意事项开发阶段用 PATH 解决 dll 问题很方便但发布给别人的时候不能要求别人也配 PATH。这时候需要用ldd或者 MSYS2 自带的ntldd工具把 exe 依赖的所有 dll 找出来连同 GTK3 的运行时资源比如share/glib-2.0/schemas、share/icons这些一起打包。GTK3 程序对资源目录结构有要求不是光拷 dll 就完事这个坑等你要发布的时候自然会遇到到时候搜“GTK3 Windows 打包”能找到比较详细的清单。6. 关于这套环境后续能怎么扩展环境跑通只是起点。有了 GTK3 加 CLion 这套底子你可以往几个方向走。一是用 Glade 做界面设计Glade 生成的.ui文件在程序里用gtk_builder_add_from_file加载界面和逻辑分离改界面不用重新编译。二是接 SQLite 做本地数据存储MSYS2 里有mingw-w64-x86_64-sqlite3包装完同样用 pkg-config 接进 CMake。三是如果以后想跨到 Linux 或者别的平台这套 CMake 加 pkg-config 的写法基本可以原样搬过去只需要把工具链换成目标平台的代码层面几乎不用动这也是当初选 GTK3 而不是 Win32 API 的原因之一。我个人在实际操作中的体会是Windows 上搭 GTK3 环境最耗时间的不是装软件而是排查“为什么 CMake 找不到库”这类路径和配置问题。把pkg-config --cflags --libs gtk-3.0这条命令当成你的听诊器任何时候编译链接出问题先跑一遍它看输出对不对能省掉一大半瞎猜的时间。另外MSYS2 的终端和 CLion 里的环境变量是两套终端里能跑不代表 CLion 里能跑遇到诡异问题先想想是不是环境变量没同步。 
长河君 · 2026/10/20 15:16:31 · 阅读 1.2k Windows下GTK3与CLion开发环境搭建实战指南
1. 为什么要在 Windows 上折腾 GTK3 加 CLion 这套组合先把结论摆在前面如果你是一个长期在 Windows 上写 C/C 的人又恰好想做一个带原生窗口界面的桌面小工具那 GTK3 加 CLion 这套组合是值得花一个下午去搭起来的。GTK3 本身是跨平台的 C 语言图形界面库Linux 桌面上一大堆软件都用它Windows 上虽然生态没那么热闹但跑起来完全没问题。CLion 是 JetBrains 家的 C/C IDE代码补全、跳转、调试、CMake 集成这些体验在同类工具里属于第一梯队。问题在于这两样东西凑到 Windows 上中间隔着一层叫 MSYS2 或者 MinGW 的东西新手很容易在“我明明装好了为什么 CLion 找不到头文件”这一步卡住。我自己第一次搭的时候光是让pkg-config在 CLion 里正常返回 GTK3 的编译参数就来回折腾了两三个小时。所以这篇东西不是那种“点下一步下一步就完事”的教程而是把每一步背后的原因、容易踩的坑、以及我实测下来比较稳的做法都摊开讲。这套环境搭好之后你能做的事情很具体用 C 语言写 GTK3 界面程序在 CLion 里直接点运行就能弹出窗口断点调试、变量查看、CMake 重新加载都正常。适合谁看适合已经会一点 C 语言、用过或者听说过 CMake、但没在 Windows 上正经配过 GTK 开发环境的人。如果你连 C 语言指针都还没搞明白建议先把基础补一补再回来不然报错信息会让你怀疑人生。我下面讲的这套流程核心思路是用 MSYS2 提供 GTK3 的库和工具链用 CLion 作为编辑和调试的前端两者通过 CMake 的find_package或者pkg-config对接。为什么选 MSYS2 而不是别的因为它在 Windows 上维护了一个相当完整的包仓库GTK3 及其依赖GLib、Pango、Cairo、GDK-Pixbuf 等都能一条命令装齐而且它自带的 MinGW-w64 工具链和 CLion 的兼容性经过很多人验证属于“照着做大概率能成”的路线。2. 环境搭建前的整体设计与工具选型考量2.1 为什么是 MSYS2 而不是 WSL 或纯 Visual Studio在 Windows 上搞 GTK3摆在面前的路其实有好几条。第一条是 WSL装个 Linux 子系统里面apt install libgtk-3-dev就完事编译也顺。但 WSL 的问题是图形界面要走一层转发调试的时候窗口弹出来那一下总感觉隔了一层而且 CLion 连 WSL 工具链虽然支持配置起来又是另一套心智负担。第二条是纯 Visual Studio 加 vcpkgvcpkg 确实能装 GTK3但 GTK3 在 Windows 上的官方支持本来就偏向 MinGW 系用 MSVC 编译经常会遇到一些边边角角的链接问题对新手不友好。第三条就是 MSYS2。它的本质是一个在 Windows 上模拟类 Unix 环境的软件发行版自带包管理器pacman你可以理解成 Windows 里的一个迷你 Linux 包管理生态。它提供两套主要的工具链一套是mingw64编译出来的是原生 Windows 程序不依赖 MSYS2 的运行时另一套是msys编译出来的是依赖 MSYS2 运行时的程序。做 GTK3 桌面程序一定要用mingw64这套因为你要的是能独立运行的 exe而不是绑死在 MSYS2 环境里的东西。选 MSYS2 的另一个理由是 CLion 对它的识别很成熟。CLion 在设置工具链的时候可以直接指定 MSYS2 的安装路径它会自动找到gcc、g、gdb、cmake这些。相比之下你如果自己东拼西凑一个 MinGW版本对不上、路径找不到的情况太常见了。2.2 CLion 的角色定位与 CMake 的衔接方式CLion 本身不提供编译器它是个“前端”负责编辑、索引、调用外部工具链、展示调试信息。所以真正干活的是 MSYS2 里的 GCC 和 GDB。CLion 通过 CMake 来组织项目CMake 又通过find_package或者pkg-config来找到 GTK3 的头文件路径和库文件路径。这里有个关键点很多人没搞明白GTK3 在 MSYS2 里安装后会提供一个.pc文件pkg-config 的元数据文件里面记录了编译 GTK3 程序需要的-I头文件路径和-L库路径以及-l链接库名。CMake 里可以用PkgConfig模块去读这个文件也可以用 GTK3 自带的 CMake 配置文件。我实测下来在 MSYS2 环境下用pkg-config的方式最稳因为 GTK3 的 CMake config 文件有时候路径处理会出幺蛾子。所以整体设计就是MSYS2 装 GTK3 和工具链CLion 指向 MSYS2 的工具链项目里写一个 CMakeLists.txt用pkg_check_modules把 GTK3 的编译参数拉进来。这样一套下来你在 CLion 里点构建它调用 MSYS2 的 GCCGCC 根据 CMake 生成的参数去 MSYS2 的目录里找 GTK3 头文件和库链接成 exe运行的时候因为用的是 mingw64 工具链exe 可以直接双击跑前提是 GTK3 的 dll 在 PATH 里或者跟 exe 放一起。2.3 版本选择的几个现实考虑MSYS2 的mingw64仓库里 GTK3 的版本更新还算勤快目前主流是 3.24.x 这个系列。我不建议去追最新的 4.x因为 GTK4 的 API 和 GTK3 差别不小网上大部分中文资料还是 GTK3 的新手照着 GTK4 的文档写 GTK3 的代码会各种编译不过。CLion 这边2023 之后的版本对 MSYS2 的支持都很成熟用较新的稳定版就行没必要追 EAP。还有一个坑是 32 位和 64 位的选择。现在基本无脑选 64 位mingw64就是 64 位的mingw32才是 32 位的。除非你有特殊的老系统兼容需求否则一律 64 位。3. 手把手实操从零把环境跑通3.1 安装 MSYS2 并配置国内镜像源先去 MSYS2 官网下载安装包一路默认安装建议装在C:\msys64这种没有空格和中文的路径下。装完之后打开 “MSYS2 UCRT64” 或者 “MSYS2 MINGW64” 的终端。这里要注意MSYS2 现在有 UCRT64、MINGW64、CLANG64 好几个环境我们统一用 MINGW64因为 GTK3 的包在 MINGW64 仓库里最全。打开 MINGW64 终端后第一件事是换镜像源不然下载速度能让你等到睡着。编辑/etc/pacman.d/mirrorlist.mingw64、mirrorlist.msys、mirrorlist.mingw32这几个文件把国内的镜像地址放到最前面。具体地址我就不贴了搜“MSYS2 镜像源”能找到一堆选几个延迟低的就行。换完之后执行pacman -Syu这个命令会更新包数据库和已安装的包。注意第一次执行-Syu之后它可能会提示你关闭终端重新打开这是正常的照做就行。重新打开后再执行一次pacman -Syu确保全部更新完。提示MSYS2 的更新有时候会要求你先更新pacman本身再更新其他包如果遇到报错按它提示的顺序来别硬刚。3.2 安装 GTK3 开发包和工具链更新完之后安装 GTK3 和编译工具。在 MINGW64 终端里执行pacman -S mingw-w64-x86_64-gtk3 mingw-w64-x86_64-toolchain mingw-w64-x86_64-cmake mingw-w64-x86_64-pkg-config这条命令装的东西有点多我拆开说gtk3是 GTK3 的库和头文件toolchain是一组工具链的集合包包含 GCC、GDB、binutils 等cmake是构建工具pkg-config是帮我们查询库编译参数的工具。装的过程中会问你好几次确认一路回车默认全装就行。装完之后验证一下在 MINGW64 终端里敲pkg-config --cflags --libs gtk-3.0如果输出了一长串-I和-L以及-lgtk-3之类的参数说明 GTK3 装好了。如果提示Package gtk-3.0 was not found那多半是你没在 MINGW64 终端里执行或者包没装全。注意pkg-config查询的包名是gtk-3.0不是gtk3也不是gtk-3.0这个加号和点号的位置很容易记错记不住就pkg-config --list-all | grep gtk看一眼。3.3 配置 CLion 的工具链指向 MSYS2打开 CLion进File - Settings - Build, Execution, Deployment - Toolchains。点加号新建一个工具链名字随便起比如 “MSYS2-MINGW64”。然后关键的一步把Toolset那一栏的路径指向C:\msys64\mingw64假设你装在默认位置。CLion 会自动探测出C:\msys64\mingw64\bin\gcc.exe、g.exe、gdb.exe这些。如果自动探测没出来就手动指定C Compiler填C:\msys64\mingw64\bin\gcc.exeC Compiler填g.exeDebugger填gdb.exe。CMake那一栏可以留空让 CLion 用自带的也可以指向 MSYS2 里的 cmake我一般用 CLion 自带的省事。建好之后把这个工具链移到列表最上面或者在你项目的 CMake 配置里选它。然后新建项目的时候CLion 会让你选工具链选这个 MSYS2 的就行。3.4 写一个能跑起来的最小 CMakeLists.txtCLion 新建 C 项目会自带一个CMakeLists.txt我们把它改成下面这样cmake_minimum_required(VERSION 3.20) project(gtk3_demo C) set(CMAKE_C_STANDARD 11) find_package(PkgConfig REQUIRED) pkg_check_modules(GTK3 REQUIRED gtk-3.0) include_directories(${GTK3_INCLUDE_DIRS}) link_directories(${GTK3_LIBRARY_DIRS}) add_executable(gtk3_demo main.c) target_link_libraries(gtk3_demo ${GTK3_LIBRARIES}) target_compile_options(gtk3_demo PRIVATE ${GTK3_CFLAGS_OTHER})这里解释几个关键点。find_package(PkgConfig REQUIRED)是让 CMake 加载 PkgConfig 模块这个模块提供了pkg_check_modules命令。pkg_check_modules(GTK3 REQUIRED gtk-3.0)会去调用pkg-config把gtk-3.0的编译参数存到GTK3_开头的变量里。GTK3_INCLUDE_DIRS是头文件路径GTK3_LIBRARY_DIRS是库路径GTK3_LIBRARIES是要链接的库名列表GTK3_CFLAGS_OTHER是其他编译选项。为什么不用find_package(GTK3)因为 GTK3 在 MSYS2 里提供的 CMake config 文件有时候会因为路径里的反斜杠和正斜杠混用导致解析问题而pkg-config这条路是 GTK 官方在类 Unix 环境下最推荐的在 MSYS2 里同样适用稳定性我实测更好。3.5 写一个最小 GTK3 窗口程序验证main.c写个最简单的#include gtk/gtk.h static void on_activate(GtkApplication *app, gpointer user_data) { GtkWidget *window gtk_application_window_new(app); gtk_window_set_title(GTK_WINDOW(window), GTK3 on Windows); gtk_window_set_default_size(GTK_WINDOW(window), 400, 300); gtk_widget_show_all(window); } int main(int argc, char **argv) { GtkApplication *app gtk_application_new(com.example.gtk3demo, G_APPLICATION_DEFAULT_FLAGS); g_signal_connect(app, activate, G_CALLBACK(on_activate), NULL); int status g_application_run(G_APPLICATION(app), argc, argv); g_object_unref(app); return status; }这段代码创建了一个 400x300 的窗口标题是 “GTK3 on Windows”。gtk_application_new的第二个参数在 GTK3 不同小版本里名字有变化老版本是G_APPLICATION_FLAGS_NONE新版本推荐G_APPLICATION_DEFAULT_FLAGS如果编译报未定义换成前者即可。在 CLion 里点构建如果一切正常会在cmake-build-debug目录下生成gtk3_demo.exe。直接点运行应该能弹出一个空窗口。如果弹窗失败或者报缺少 dll往下看排查部分。4. 常见问题与排查技巧实录4.1 编译期报错找不到 gtk/gtk.h这是最常见的问题报错长这样fatal error: gtk/gtk.h: No such file or directory。原因基本只有一个CMake 没有正确拿到 GTK3 的头文件路径。排查顺序如下。第一确认你在 MINGW64 终端里执行pkg-config --cflags gtk-3.0能输出内容。如果这一步就失败说明 GTK3 没装好或者pkg-config不在 PATH 里。第二确认 CLion 用的工具链是 MSYS2 的 MINGW64而不是它自带的 MinGW 或者别的。第三确认CMakeLists.txt里pkg_check_modules那行没有拼写错误包名是gtk-3.0。还有一个隐蔽的坑CLion 有时候会缓存 CMake 配置你改了CMakeLists.txt之后它没重新加载。这时候点Tools - CMake - Reset Cache and Reload Project强制刷新一次。4.2 链接期报错undefined reference togtk_application_window_new这种undefined reference的错误说明头文件找到了但链接的时候没找到对应的库。原因通常是target_link_libraries里没有把${GTK3_LIBRARIES}加进去或者加进去了但顺序不对。GTK3 依赖的库很多链接顺序在 Linux 上比较敏感在 MSYS2 上虽然好一些但也要保证 GTK3 的库在依赖它的库前面。用pkg_check_modules拿到的GTK3_LIBRARIES顺序是 pkg-config 排好的直接用就行别自己手动调整顺序。如果确认加了还是报错检查一下是不是链接到了错误的库路径。可以在 CLion 的 CMake 输出里搜-L看看它去的目录是不是C:/msys64/mingw64/lib。4.3 运行期报错缺少 libgtk-3-0.dll 之类的动态库编译链接都过了双击 exe 或者 CLion 里点运行弹出一个错误框说找不到libgtk-3-0.dll。这是因为 Windows 运行 exe 的时候会在 exe 所在目录和 PATH 环境变量里找 dll而 GTK3 的 dll 在C:\msys64\mingw64\bin里这个目录默认不在 PATH 里。解决办法有两个。一是把C:\msys64\mingw64\bin加到系统 PATH 里一劳永逸但会往 PATH 里塞一大堆东西。二是把需要的 dll 拷贝到 exe 同目录比较干净但麻烦。我一般用第一种因为开发阶段经常要跑加 PATH 省事。加完 PATH 记得重启 CLion不然它读不到新的环境变量。提示如果你不想污染系统 PATH可以在 CLion 的 Run/Debug Configuration 里给这个可执行文件单独设置环境变量把C:\msys64\mingw64\bin加到PATH前面。这样只影响这个项目的运行不影响系统全局。4.4 CLion 里 GDB 调试 GTK3 程序卡住或崩溃有时候你在 CLion 里用 GDB 调试 GTK3 程序断点能停但一继续运行就卡死或者报一些奇怪的信号。这通常是因为 GTK3 内部有自己的线程和信号处理机制GDB 默认会捕获所有信号包括 GTK 正常使用的那些。解决办法是在 CLion 的 GDB 设置里配置不捕获SIG32、SIG33这类 GTK 用的信号。具体在Settings - Build, Execution, Deployment - Debugger - Data Views - GDB或者直接在项目的.gdbinit里加handle SIG32 nostop noprint pass之类的配置。另一个可能是 GDB 版本和 GCC 版本不匹配。MSYS2 的mingw-w64-x86_64-toolchain装出来的 GCC 和 GDB 是配套的一般不会有问题。如果你单独升级过其中一个可能会出幺蛾子建议一起升级。4.5 常见问题速查表问题现象最可能原因解决动作找不到 gtk/gtk.hCMake 没拿到 GTK3 头文件路径检查 pkg-config 是否可用重置 CMake 缓存undefined reference没链接 GTK3 库或链接顺序错确认 target_link_libraries 包含 GTK3_LIBRARIES运行时缺 dllGTK3 的 bin 目录不在 PATH把 C:\msys64\mingw64\bin 加入 PATH 或拷贝 dllGDB 调试卡死GDB 捕获了 GTK 内部信号配置 GDB 忽略 SIG32/SIG33 等信号pkg-config 找不到包不在 MINGW64 终端或包名写错用 MINGW64 终端包名 gtk-3.0CMake 配置报错工具链选错或路径含空格确认工具链指向 MSYS2 MINGW64路径无空格5. 几个让开发体验更顺的实操心得5.1 把 pkg-config 的路径显式告诉 CMake虽然 CLion 通过工具链设置一般能自动找到pkg-config但有时候它找的是 MSYS2 的usr/bin下的那个而不是mingw64/bin下的两者行为有差异。稳妥的做法是在CMakeLists.txt开头显式设置set(PKG_CONFIG_EXECUTABLE C:/msys64/mingw64/bin/pkg-config.exe)这样不管 CLion 怎么探测用的都是我们指定的这个。路径里的斜杠用正斜杠CMake 在 Windows 上认这个。5.2 用 CMake Presets 固化配置CLion 现在对CMakePresets.json支持很好。你可以把工具链、生成器、构建类型这些写进 presets 文件团队协作或者换机器的时候直接复用不用每次手动点。一个最小的 preset 大概长这样{ version: 3, configurePresets: [ { name: msys2-mingw64, generator: Ninja, binaryDir: ${sourceDir}/build, cacheVariables: { CMAKE_C_COMPILER: C:/msys64/mingw64/bin/gcc.exe, CMAKE_CXX_COMPILER: C:/msys64/mingw64/bin/g.exe, CMAKE_BUILD_TYPE: Debug } } ] }用 Ninja 作为生成器比用 MinGW Makefiles 快不少CLion 自带 Ninja不用额外装。5.3 处理 GTK3 的国际化与资源文件如果你后面要做稍微正经一点的程序会碰到界面翻译和图标资源的问题。GTK3 用.ui文件描述界面用 GResource 把资源编译进 exe。在 MSYS2 环境下glib-compile-resources这个工具是有的在CMakeLists.txt里加一段自定义命令就能把.gresource.xml编译成 C 源文件参与构建。这块内容比较多我这里只点一下知道有这么回事需要的时候去查 GLib 的 GResource 文档就行。5.4 关于中文显示和字体GTK3 在 Windows 上默认用的字体渲染有时候中文会发虚或者字体不对。可以在程序启动时设置一下字体或者写一个settings.ini放到 exe 同目录指定gtk-font-name。我实测下来指定成Microsoft YaHei UI 10显示效果比较正常。这个不是必须的但如果你做的是中文界面程序早点处理比后面返工强。5.5 打包发布时的注意事项开发阶段用 PATH 解决 dll 问题很方便但发布给别人的时候不能要求别人也配 PATH。这时候需要用ldd或者 MSYS2 自带的ntldd工具把 exe 依赖的所有 dll 找出来连同 GTK3 的运行时资源比如share/glib-2.0/schemas、share/icons这些一起打包。GTK3 程序对资源目录结构有要求不是光拷 dll 就完事这个坑等你要发布的时候自然会遇到到时候搜“GTK3 Windows 打包”能找到比较详细的清单。6. 关于这套环境后续能怎么扩展环境跑通只是起点。有了 GTK3 加 CLion 这套底子你可以往几个方向走。一是用 Glade 做界面设计Glade 生成的.ui文件在程序里用gtk_builder_add_from_file加载界面和逻辑分离改界面不用重新编译。二是接 SQLite 做本地数据存储MSYS2 里有mingw-w64-x86_64-sqlite3包装完同样用 pkg-config 接进 CMake。三是如果以后想跨到 Linux 或者别的平台这套 CMake 加 pkg-config 的写法基本可以原样搬过去只需要把工具链换成目标平台的代码层面几乎不用动这也是当初选 GTK3 而不是 Win32 API 的原因之一。我个人在实际操作中的体会是Windows 上搭 GTK3 环境最耗时间的不是装软件而是排查“为什么 CMake 找不到库”这类路径和配置问题。把pkg-config --cflags --libs gtk-3.0这条命令当成你的听诊器任何时候编译链接出问题先跑一遍它看输出对不对能省掉一大半瞎猜的时间。另外MSYS2 的终端和 CLion 里的环境变量是两套终端里能跑不代表 CLion 里能跑遇到诡异问题先想想是不是环境变量没同步。