ftxui适合快速原型、配置工具、cli辅助面板及本地开发小工具等需结构化布局和响应式交互但性能要求不高的场景，不适合高频刷新的实时监控或游戏类应用。
FTXUI 适合什么场景的 C++ TUI 开发
FTXUI 是面向现代 C++ 的轻量终端 UI 库，不是 curses 封装，也不依赖 ncurses 运行时 —— 它纯靠 ANSI 转义序列 + 终端尺寸探测 + 单次完整重绘（非增量刷新）实现渲染。这意味着它适合：快速原型、配置工具、CLI 辅助面板、本地开发小工具等对性能要求不高但需要结构化布局和响应式交互的场景；不适合高频刷新的实时监控界面或游戏类应用。
它默认不处理鼠标双击、拖拽、复杂焦点链，也不支持 Windows Console 原生模式（需启用 Windows Terminal 或 WSL）。如果你在 VS Code 的集成终端或 macOS Terminal 中跑不起来，先检查是否启用了真彩色（TERM=xterm-256color）和 UTF-8 编码。
初始化与基础渲染必须调用 Screen::Create() 和 Render()
FTXUI 不提供全局单例或自动事件循环，所有渲染都由你显式控制。漏掉 Screen::Create() 会导致空指针崩溃；漏掉 Render() 则界面永远不更新 —— 即使你改了状态、调了 screen->Loop() 也没用。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
-
Element描述 UI 结构（比如hbox(text("Hello"), text("World"))），是纯数据，不触发绘制 -
Screen是实际渲染目标，必须用Screen::Create()构造，并传给Render() - 每次想刷新画面，必须重新构造
Element（或复用并更新内部状态），再调一次Render(screen, element) - 不要在循环里反复 new/delete
Screen，创建一次复用即可；Screen::Create(Dimension::Full())是最常用尺寸
事件循环中正确读取输入要用 screen->Event(&event)，不是 std::cin
FTXUI 自己接管 stdin（设为非阻塞、无缓冲），直接读取原始字节流并解析成 Event。用 std::cin >> key 会破坏其输入队列，导致按键丢失或卡死。
-
Event event;声明后，用if (screen->Event(&event)) { ... }检测是否有新事件 -
event.is_keyboard()判断是否键盘事件，再用event.character()或event.key()取值（如Key::ArrowUp） -
event.is_mouse()可获取坐标，但注意：多数终端只上报点击/释放，不支持 hover 或滚轮（除非开启扩展协议） - 别在事件处理里做耗时操作（如文件读写），否则界面冻结 —— FTXUI 无异步机制，需你自己拆分逻辑或起线程
样式和布局容易忽略的三个细节
FTXUI 的 border、color、padding 等修饰符默认不继承，且顺序影响最终效果。比如 color(Color::Red) | border 和 border | color(Color::Red) 渲染出的边框颜色可能不同 —— 因为 border 本身也生成一个带样式的子 Element，而修饰符作用于其外层容器。
-
text("OK").bold()生效，但text("OK") | bold不生效（bold是修饰符函数，不是运算符重载） -
vbox/hbox默认不撑满父容器，加size(WIDTH, EQUAL, 100)才能占满宽度 - 中文字符宽度在某些终端会被误判为 2 列（尤其混合 ASCII 时），导致布局错位；可临时用
text("你好").fixed_size(4)强制指定列宽
真正麻烦的是跨平台字体渲染一致性 —— 没有“漂亮”的统一解，只有适配：Linux/macOS 上靠终端字体设置，Windows 上强烈建议换用 Windows Terminal 并关闭“使用旧版控制台”，否则连 box-drawing 字符都显示为方块。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
