C++使用WT开发Web应用教程

Wt是用C++编写的现代Web框架，以桌面GUI方式开发Web应用，通过组件化和信号-槽机制实现事件驱动，自动映射为HTML/CSS/JS，无需手写前端代码。

Wt（Witty）是一个用C++编写的现代Web框架，核心理念是“以桌面GUI的方式开发Web应用”——你写的是C++对象和事件驱动逻辑，Wt自动将其映射为浏览器中的HTML、CSS和JavaScript，无需手动写前端代码，也不依赖JavaScript框架。

核心思想：组件化 + 事件驱动

Wt把Web界面抽象成类似Qt的Widget组件（如 WPushButton、WTextEdit、WTable），所有交互通过信号-槽（signal-slot）机制处理。服务器端保持完整状态，用户操作触发C++函数调用，Wt负责同步UI更新（可自动Diff DOM或整页刷新）。

• 每个页面是一个 WApplication 实例，生命周期由Wt管理
• 界面由 WContainerWidget 或其子类（如 WVBoxLayout、WGridLayout）组织布局
• 按钮点击、文本变化等直接连接到C++成员函数，不写JS，不操心AJAX

快速启动一个Hello World

安装Wt后（Linux/macOS建议用包管理器，Windows推荐vcpkg），写一个最简应用：

#include <Wt/WApplication.h>
#include <Wt/WBreak.h>
#include <Wt/WContainerWidget.h>
#include <Wt/WText.h>

class HelloApp : public Wt::WApplication {
public:
  HelloApp(const Wt::WEnvironment& env) : Wt::WApplication(env) {
    setTitle("Hello Wt");
    root()->addWidget(std::make_unique<Wt::WText>("Hello, C++ Web!"));
    root()->addWidget(std::make_unique<Wt::WBreak>());
    auto btn = root()->addWidget(std::make_unique<Wt::WPushButton>("Click me"));
    btn->clicked().connect([this] {
      root()->addWidget(std::make_unique<Wt::WText>("You clicked!"));
    });
  }
};

int main(int argc, char **argv) {
  return Wt::WRun(argc, argv, [](const Wt::WEnvironment& env) {
    return std::make_unique<HelloApp>(env);
  });
}

编译时链接 -lwtd -lwthttp（具体库名依版本而定），运行后访问 http://127.0.0.1:8080 即可见响应式按钮。

关键能力与实用技巧

Wt不是“胶水层”，它原生支持生产级功能：

• 会话与状态管理：每个用户有独立的 WApplication 实例，成员变量即会话状态，无需手动存Redis或Session ID
• URL路由与深度链接：用 enableUpdates() + setInternalPath() 支持 SPA 风格导航，配合 WStackedWidget 切换视图
• 数据库集成：内置 Wt::Dbo ORM，支持 PostgreSQL/MySQL/SQLite，C++类直接映射表结构，类型安全
• 异步与长连接：通过 WServer::post() 或 WTimer 实现非阻塞更新；也支持 Server-Sent Events（SSE）
• 自定义渲染：可重载 render() 方法生成原始HTML，或嵌入第三方JS库（如ECharts）做局部增强

部署与注意事项

Wt应用可内建HTTP服务器（Wt::WServer），也可部署在FastCGI、SCGI或反向代理（Nginx/Apache）后：

• 生产环境推荐启用 --https-address 和 --https-port 直接支持HTTPS
• 静态资源（CSS/JS/图片）默认从 ./resources/ 加载，可打包进二进制或由Nginx托管
• 注意线程模型：默认单线程每请求一进程（fork）或线程池模式，高并发需配置 --thread-pool-size
• 调试时加 --debug 参数，Wt会输出详细日志和客户端JS错误回溯

基本上就这些。Wt适合需要强类型、高安全性、复用C++业务逻辑，又不愿陷入JS生态碎片化的团队——它不是“另一个前端框架”，而是把Web当新平台来原生编程。