nana适合轻量级跨平台C++ GUI项目,但不支持macOS、现代UI特性及异步事件;需手动处理生命周期、UTF-8编码和绘图细节。
确认 nana 库是否真适合你的项目场景
nana 是一个轻量、头文件为主的 C++ GUI 库,不依赖 Qt 或 GTK,编译时直接链接到你的程序里。但它不是“现代风格”框架——没有内置的深色主题、响应式布局、动画过渡或 Material Design 组件。所谓“现代风格”得靠你手动配色、重绘控件、封装布局逻辑。如果你需要开箱即用的暗色模式、高 DPI 自适应、或拖拽式 UI 编辑器,nana 不是首选;但如果你要写一个小型工具(比如日志查看器、配置生成器),又不想引入 Qt 的庞大依赖和许可证顾虑,nana 就很实在。
它只支持 Windows 和 Linux(X11),
不支持macOS
所有控件都是同步绘制,
可自定义外观,但没 Canvas 或 SVG 渲染层
事件模型是典型的回调式(
),不是信号槽,也不支持异步事件分发
Windows 下快速跑起第一个 nana 窗口(MinGW / MSVC 均适用)
别从 GitHub 主页 clone 整个仓库——最新 master 分支常含未稳定 API。推荐用
发布版(2022 年末最稳),解压后把
路径加入编译器 include 目录即可,无需预编译库。
关键点:必须在
开头调用
,且整个 GUI 生命周期需在
内运行;否则窗口闪退或事件不响应。
处理常见崩溃与事件失效问题
nana 对对象生命周期极其敏感:控件必须依附于某个
实例,且该 form 不能提前析构;lambda 捕获的局部变量若在窗口关闭后仍被回调,必然 crash。
ChatGPT (Windows)
ChatGPT Windows 版本优化了系统兼容性与响应速度,提供多任务处理和对话记录管理功能,适用于办公辅助、创意写作、学习辅导和日常问答。它能帮助用户快速生成文稿、整理资料和高效获取信息,为个人和团队提供稳定、流畅的生产力体验。
下载
立即学习
“
C++免费学习笔记(深入)
”;
+
检查是安全做法,尤其在异步回调中
不要在
回调里直接
或
后继续访问控件——改用
并确保后续无延迟调用
中文乱码
?默认用系统 ANSI
编码
,需显式调用
并确保源文件保存为 UTF-8 without BOM
按钮点击无反应?检查是否漏了
——nana 不提供默认 click 行为,也不自动绑定
成员函数
实现接近“现代感”的最小可行方案
nana 本身不提供扁平化按钮、圆角卡片或阴影,但你可以用
+
手动绘制。重点不是画得多像 Figma,而是让交互反馈清晰:
重载
绘制带圆角背景和文字居中的按钮
用
/
切换 hover 状态并触发
字体统一设为
(Windows)或
(Linux),避免默认等宽字体
禁用原生边框:
,再自己 draw 标题栏(含最小化/关闭按钮)
真正的复杂点不在代码量,而在于:nana 的绘图坐标系 Y 轴向下,且
不支持抗锯齿文本;圆角矩形用
时半径超过尺寸会静默失败——这些细节不试三次根本记不住。
nana::drawerbasebutton->click([&]{ ... });v1.7.5include/nanamain()nana::gui::init()nana::gui::exec()#include
#include
int main()
{
nana::gui::init(); // 必须!否则 create_window 失败
nana::form fm;
fm.caption("Hello nana");
fm.size({400, 300});
nana::button btn{fm, "Click Me"};
btn.move({50, 80});
btn.events().click([&btn]{
btn.caption("Clicked!");
});
fm.show();
nana::gui::exec(); // 阻塞式事件循环,不能用 std::thread::join 替代
} nana::formstd::shared_ptrstd::weak_ptrclickdelete thisfm.close()fm.destroy()nana::charset("UTF-8")btn.events().click(...)onclicknana::drawerbasenana::paint::graphicson_paintevents().mouse_entermouse_leaverefresh()"Segoe UI", "Microsoft YaHei""Noto Sans CJK SC"fm.borderless(true)graphicsround_rectangle