编译FTXUI库

环境准备#

在开始之前，请确保你的电脑已经安装了以下工具：

💡 我使用的是 VS2026，但 VS2019 或 VS2022 也完全适用，步骤是一样的。

拉取项目源码#

首先，我们需要从 GitHub 拉取 FTXUI 的源代码。

⚠️ 重要提示：一定要拉取指定版本的分支，不要拉 main 分支！

main 分支是开发分支，直接用cmake编译会报些奇奇怪怪的错误。(别问我咋知道的，问就是一天)

1
git clone --branch v6.1.9 https://github.com/ArthurSonzogni/FTXUI.git

创建编译目录#

进入项目目录，并创建用于存放编译结果的文件夹：

1
cd FTXUI
2

3
# 创建 64 位编译目录
4
mkdir build_x64
5

6
# 创建 32 位编译目录（可选）
7
mkdir build_x32

打开 VS 开发者命令行#

这是关键步骤！不要用普通的 CMD 或 PowerShell。

1. 按 Win + S 打开 Windows 搜索
2. 搜索 “x64 Native Tools Command Prompt for VS”（编译 64 位）
3. 或搜索 “x86 Native Tools Command Prompt for VS”（编译 32 位）
4. 右键选择 “以管理员身份运行”

开始编译#

1
# 进入 64 位编译目录
2
cd your_path\FTXUI\build_x64
3

4
# 生成项目文件
5
cmake .. -A x64
6

7
# 编译 Debug 版本
8
cmake --build . --config Debug
9

10
# 编译 Release 版本
11
cmake --build . --config Release

1
# 进入 32 位编译目录
2
cd your_path\FTXUI\build_x32
3

4
# 生成项目文件
5
cmake .. -A Win32
6

7
# 编译 Debug 版本
8
cmake --build . --config Debug
9

10
# 编译 Release 版本
11
cmake --build . --config Release

获取编译结果#

编译完成后，你可以在以下目录找到生成的库文件：

1
FTXUI/
2
├── build_x64/
3
│   ├── Debug/          # Debug 版本的库文件
4
│   └── Release/        # Release 版本的库文件
5
└── build_x32/
6
    ├── Debug/          # Debug 版本的库文件
7
    └── Release/        # Release 版本的库文件

在你的项目中使用#

编译完成后，在你的 C++ 项目中使用 FTXUI：

1. 包含头文件：将 FTXUI 的 include 目录添加到你的项目包含路径
2. 链接库文件：将编译好的 .lib 文件添加到链接器输入中
3. 复制 DLL：如果使用动态库，将 .dll 文件放到可执行文件同级目录

常见问题#

Q: 提示 “cmake 不是内部或外部命令”？

A: 确保你打开的是 VS 开发者命令行，不是普通 CMD。

Q: 编译报错，提示找不到某些头文件？

A: 检查是否拉取的不是 main 分支。

Q: 编译成功但运行时报错？

A: 检查 Debug/Release 版本是否匹配，以及运行时库设置是否一致。

总结#

FTXUI 是一个非常棒的 TUI 库，虽然编译过程有点折腾，但效果真的很棒的诶。如果你也想让控制台程序变得高大上，强烈推荐试试

有任何问题欢迎在评论区留言交流