介绍
Nana C++ Library —— 最现代、最符合现代 C++ 风格的框架
如果你想学习现代 C++（C++11/14/17 及以上）的标准语法，Nana 是几乎完美的方案。很多传统的 GUI 框架（如 MFC）因为历史原因，充斥着大量的宏和自定义类型，而 Nana 完全是用现代 C++ 重新设计的。
为什么适合新手：
标准 C++ 风格：它大量使用了标准库（std::string、std::function、智能指针等）。学 Nana 的过程，就是在复习标准 C++。
极其优雅的事件处理：它没有晦涩的宏，而是使用 C++11 的 Lambda 表达式来处理点击事件：
btn.events().click([](){ std::cout << "Button clicked!" << std::endl; });
轻量跨平台：只需包含头文件和源文件即可，没有复杂的配置。
学习资源
Nana 官方原先的域名 nanapro.org 确实由于疏于维护失效了。不过不用担心，开源社区以及作者在 GitHub 上留下了非常完整的复刻版（Mirror）和文档托管地址。
你可以使用以下这几个依然活跃、且内容完全对齐的替代地址：
1. 官方最全的 API 参考手册（Doxygen 复刻版）
这是目前最完整、最好用的 Nana 在线类库参考文档，由社区核心贡献者维护，详细列出了每个控件、API 的定义及 Demo：
👉 qPCR4vir 的 Nana Doxygen 托管页
怎么用：点击左侧的
Classes或Namespaces即可查询具体的控件（如nana::button、nana::form）的使用方法。
2. 官方中文/英文使用指南（Nana Handbook）
如果你需要看通俗易懂的入门教程（讲解事件处理、布局管理等基础概念），官方有一个专门的 Handbook 仓库。你可以直接在 GitHub 上流畅阅读：
👉 GitHub - cnjinhao/nana-handbook (在线阅读手册)
3. 官方历史网页备份（Wayback Machine）
如果你依然想看当年官方网站（En-US 英文版）原汁原味的排版、博客和答疑：
👉 Wayback Machine 上的 nanapro.org 历史快照备份
💡 额外的小建议
看 Nana 的文档时，建议搭配它的源码示例一起看。Nana 的主要作者其实是中国开发者（Jinhao），源码和官方 Handbook 的代码逻辑非常清晰。
你可以直接克隆它的主仓库，里面的 examples/ 文件夹包含了各种基础控件、多线程 UI、复杂布局（nana::place）的直观写法，比干看文档要高效得多！
hello world 小程序
无字版
#include <nana/gui.hpp>int main()
{nana::form fm;fm.show();nana::exec();
}
hello world 版
#include <nana/gui.hpp>
#include <nana/gui/widgets/label.hpp>int main()
{// 创建窗体nana::form fm{nana::API::make_center(400, 200)};fm.caption("Nana Hello World");// 创建标签nana::label lbl{ fm, nana::rectangle{100, 70, 200, 30} };lbl.caption("Hello World");// 可选：居中显示文字lbl.text_align(nana::align::center);fm.show();nana::exec();
}
nana 复杂版 hello world
#include <nana/gui.hpp>
#include <nana/gui/widgets/label.hpp>
#include <nana/gui/place.hpp>int main()
{nana::form fm{nana::API::make_center(400, 200)};fm.caption("Nana Hello World");nana::label lbl{ fm };lbl.caption("Hello World");lbl.text_align(nana::align::center);nana::place plc{ fm };plc.div("margin=20 <text>");plc["text"] << lbl;plc.collocate();fm.show();nana::exec();
}
用virual studio 2026 编译运行
- 下载 nana 库
https://github.com/cnjinhao/nana/archive/refs/tags/v1.7-alpha.zip，解压并更改目录名为 nana， - 同时建立目录 MyNanaApp，新建两个文件 main.cpp CMakeLists.txt，完整的目录系统如下：
├── nana/ (你下载的 Nana 源码文件夹)
└── MyNanaApp/ (你自己的项目文件夹)├── main.cpp (写入你上面那段代码)└── CMakeLists.txt (新建一个文本文件，命名为此名字)
- 编写CMakeLists.txt文件
cmake_minimum_required(VERSION 3.15)
project(MyNanaApp LANGUAGES CXX)# 设置 C++ 标准为现代 C++（Nana 推荐 C++17 或更高）
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)# 自动寻找并包含隔壁的 Nana 源码
add_subdirectory(../nana ${CMAKE_CURRENT_BINARY_DIR}/nana_build)# 定义你的可执行程序
add_executable(MyNanaApp main.cpp)# 让你的程序链接到 nana 库（CMake 会自动处理头文件包含路径）
target_link_libraries(MyNanaApp PRIVATE nana)
但这个cmake 配置会出一个小问题：
[21/22] Linking CXX static library nana_build\nana.lib
[22/22] Linking CXX executable MyNanaApp.exe
FAILED: [code=4294967295] MyNanaApp.exe
C:\Windows\system32\cmd.exe /C "cd . && "C:\Program Files\Microsoft Visual Studio\18\Insiders\Common7\IDE\CommonExtensions\Microsoft\CMake\CMake\bin\cmake.exe" -E vs_link_exe --msvc-ver=1951 --intdir=CMakeFiles\MyNanaApp.dir --rc=C:\PROGRA~2\WI3CF2~1\10\bin\100280~1.0\x64\rc.exe --mt=C:\PROGRA~2\WI3CF2~1\10\bin\100280~1.0\x64\mt.exe --manifests -- C:\PROGRA~1\MICROS~1\18\Insiders\VC\Tools\MSVC\1451~1.362\bin\Hostx64\x64\link.exe /nologo CMakeFiles\MyNanaApp.dir\main.cpp.obj /out:MyNanaApp.exe /implib:MyNanaApp.lib /pdb:MyNanaApp.pdb /version:0.0 /machine:x64 /debug /INCREMENTAL /subsystem:console nana_build\nana.lib stdc++fs.lib kernel32.lib user32.lib gdi32.lib winspool.lib shell32.lib ole32.lib oleaut32.lib uuid.lib comdlg32.lib advapi32.lib && cd ."
LINK Pass 1: command "C:\PROGRA~1\MICROS~1\18\Insiders\VC\Tools\MSVC\1451~1.362\bin\Hostx64\x64\link.exe /nologo CMakeFiles\MyNanaApp.dir\main.cpp.obj /out:MyNanaApp.exe /implib:MyNanaApp.lib /pdb:MyNanaApp.pdb /version:0.0 /machine:x64 /debug /INCREMENTAL /subsystem:console nana_build\nana.lib stdc++fs.lib kernel32.lib user32.lib gdi32.lib winspool.lib shell32.lib ole32.lib oleaut32.lib uuid.lib comdlg32.lib advapi32.lib /MANIFEST /MANIFESTFILE:CMakeFiles\MyNanaApp.dir/intermediate.manifest CMakeFiles\MyNanaApp.dir/manifest.res" failed (exit code 1104) with the following output:
C:\Users\Logic\source\repos\MyNanaApp\out\build\x64-Debug\LINK : fatal error LNK1104: 无法打开文件“stdc++fs.lib”
ninja: build stopped: subcommand failed.
解决方法是修改 CMakeLists.txt 文件
编译出了 nana.lib，但在最后一步链接成 MyNanaApp.exe 时卡住了。
为什么会报 LNK1104: 无法打开文件“stdc++fs.lib”？
在旧版本的 C++（如早期的 C++17）中，文件系统库 std::filesystem 还在实验阶段，需要额外链接 stdc++fs.lib。但随着现代编译器（尤其是你的 VS2026/MSVC）的发展，std::filesystem 已经直接集成在标准 C++ 核心库中了。
错误的原因是：Nana 库自带的 CMake 脚本比较旧，它固执地认为 C++17 环境下“必须强制去链接 stdc++fs.lib”，然而新版 VS2026 里面已经彻底删除了这个独立的 .lib 文件，所以链接器找不到它，报错了。
💡 解决方案：在你的 CMakeLists.txt 中干掉这个死板的依赖
既然编译器已经内置了文件系统，我们只需要在你的 CMakeLists.txt 里加一个小魔法，把 Nana 错误引入的 stdc++fs 库“偷梁换柱”成一个空目标即可。
请把你的 CMakeLists.txt 修改为如下内容（看第 9 行起的 if(MSVC) 部分）：
cmake_minimum_required(VERSION 3.15)
project(MyNanaApp LANGUAGES CXX)# 使用 C++17
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)if(MSVC)add_compile_options(/Zc:__cplusplus)# 【核心修复】欺骗 CMake，创建一个假的、空的 stdc++fs 目标# 这样当 Nana 试图去链接 stdc++fs 时，实际上什么都不会做，直接使用 VS 内置的文件系统if(NOT TARGET stdc++fs)add_library(stdc++fs INTERFACE)endif()
endif()# 自动寻找并包含隔壁的 Nana 源码
add_subdirectory(../nana ${CMAKE_CURRENT_BINARY_DIR}/nana_build)# 定义你的可执行程序
add_executable(MyNanaApp main.cpp)# 让你的程序链接到 nana 库
target_link_libraries(MyNanaApp PRIVATE nana)🛠️ 若 CMakeLists文件没有更新，要手动刷新：
修改完并保存 CMakeLists.txt 后，请务必刷新 CMake 缓存：
- 在 VS2026 顶部菜单栏点击：“项目” (Project) -> “删除缓存并重新配置” (Delete Cache and Reconfigure)。
- 等待底部状态栏的 CMake 配置重新加载完毕。
- 按下
F5重新编译运行。
这次链接器就不会再去寻找那个不存在的 stdc++fs.lib，你的绿色小窗口应该就能顺利弹出来了！
注意，nana 库只能用 c++ 17，不支持 C++ 20，否则也会报错。
严重性 代码 说明 项目 文件 行 抑制状态 详细信息
错误 C2440 “return”: 无法从“std::basic_string<char8_t,std::char_traits<char8_t>,std::allocator<char8_t>>”转换为“std::basic_string<char,std::char_traits<char>,std::allocator<char>>” C:\Users\Logic\source\repos\MyNanaApp\out\build\x64-Debug\MyNanaApp C:\Users\Logic\source\repos\nana\include\nana\filesystem\filesystem_ext.hpp 44
这个错误是典型的 C++20 新特性导致的兼容性冲突。
为什么会报错？
在 C++20 标准中，引入了全新的 UTF-8 字符类型 char8_t。这导致原本在 C++17 中会返回普通字符串（std::string，即 char 类型）的某些文件系统函数（如 std::filesystem::path::string()），在 C++20 下被强制返回 std::u8string（即 char8_t 类型）。
Nana 库的底层代码在编写时，可能还没有完全兼容 C++20 的这一霸道改动，导致了代码在第 44 行试图直接把 char8_t 的字符串当成普通 char 字符串返回，从而引发了 C2440: 无法转换 的错误。
💡 解决方案
解决这个问题有两个方向：方案一（最省心，强烈推荐） 是微调编译选项，让编译器在 C++20 下对 char8_t 进行向下兼容；方案二 是退回 C++17。
方案一：在 CMake 中关闭 C++20 的 char8_t 严格模式（推荐）
微软的 MSVC 编译器提供了一个极其贴心的开关：/Zc:char8_t-（注意后面有个减号），它可以让编译器在 C++20 环境下，依然把 UTF-8 字符串当做普通的 char 字符串处理。这样既能享受 C++20 的其他新特性，又能完美兼容 Nana 库。
请把你的 CMakeLists.txt 修改为如下内容（重点看 if(MSVC) 内部的变化）：
cmake_minimum_required(VERSION 3.15)
project(MyNanaApp LANGUAGES CXX)# 将 C++ 标准提升至 C++20
set(CMAKE_CXX_STANDARD 20)
set(CMAKE_CXX_STANDARD_REQUIRED ON)# 针对 VS/MSVC 编译器的 C++20 优化
if(MSVC)add_compile_options(/Zc:__cplusplus)add_compile_options(/Zc:preprocessor)# 【核心修复】关闭 C++20 的 char8_t 严格类型，允许其隐式转换为普通 stringadd_compile_options(/Zc:char8_t-)
endif()# 自动寻找并包含隔壁的 Nana 源码
add_subdirectory(../nana ${CMAKE_CURRENT_BINARY_DIR}/nana_build)# 定义你的可执行程序
add_executable(MyNanaApp main.cpp)# 让你的程序链接到 nana 库
target_link_libraries(MyNanaApp PRIVATE nana)修改后非常重要的一步：
保存 CMakeLists.txt 后，在 VS2026 顶部菜单栏点击：“项目” (Project) -> “删除缓存并重新配置” (Delete Cache and Reconfigure)。然后再重新点击运行（F5），这个报错就会彻底消失！
方案二：降回 C++17
如果你觉得上面的黑魔法不够稳妥，或者之后还会遇到类似的 C++20 兼容问题，最稳健的做法是直接在 CMakeLists.txt 里把标准改回 C++17：
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)因为 C++17 没有 char8_t 严格类型的限制，Nana 源码在此标准下可以毫无阻碍地编译通过。对于初学者进阶来说，C++17 的特性也已经完全够用了。