当前位置：首页 > news >正文

C++新手也能懂：手把手教你用xlnt库从Excel读取游戏配置表（含中文乱码解决）

news 2026/5/3 19:33:49

C++游戏开发实战：用xlnt库高效读取Excel配置表

独立游戏开发中，角色属性、道具数据和关卡配置通常需要频繁调整。将这些信息硬编码在C++源码里不仅难以维护，每次修改还要重新编译。Excel表格作为配置表是更优雅的解决方案——但如何让C++程序读取这些数据？这就是xlnt库大显身手的地方。

1. 环境准备与基础配置

1.1 安装xlnt库

xlnt是一个纯头文件的C++库，支持跨平台操作Excel文件。对于Windows平台，最简单的安装方式是通过vcpkg：

vcpkg install xlnt

如果使用CMake管理项目，在CMakeLists.txt中添加：

find_package(xlnt REQUIRED) target_link_libraries(YourProject PRIVATE xlnt::xlnt)

1.2 创建基础项目结构

建议为游戏配置系统建立专门的管理类：

// GameConfig.h #pragma once #include <xlnt/xlnt.hpp> #include <map> #include <string> class GameConfig { public: bool LoadFromExcel(const std::string& filePath); private: std::map<int, Character> characters; // 角色配置 std::map<int, Item> items; // 道具配置 };

2. 读取Excel基础数据

2.1 加载工作簿与工作表

bool GameConfig::LoadFromExcel(const std::string& filePath) { try { xlnt::workbook wb; wb.load(filePath); auto characterSheet = wb.sheet_by_title("Characters"); auto itemSheet = wb.sheet_by_title("Items"); // 后续处理... } catch (const std::exception& e) { std::cerr << "加载Excel失败: " << e.what() << std::endl; return false; } return true; }

2.2 遍历行列数据

读取角色表的典型模式：

for (auto row : characterSheet.rows()) { Character character; character.id = row[0].value<int>(); character.name = row[1].value<std::string>(); character.hp = row[2].value<int>(); characters[character.id] = character; }

3. 解决中文乱码问题

3.1 UTF-8编码处理

Excel文件中的中文需要使用UTF-8编码处理。在C++17及以上版本中：

std::u8string utf8Name = row[1].value<std::u8string>();

对于C++11/14，需要转换处理：

std::string utf8Name = row[1].value<std::string>(); // 确保你的终端/显示系统支持UTF-8

3.2 字体设置技巧

如果导出数据显示乱码，可能需要设置合适的字体：

xlnt::font chineseFont; chineseFont.name("Microsoft YaHei"); // 或SimSun等中文字体 ws.cell("A1").font(chineseFont);

4. 高级数据处理技巧

4.1 数据验证与转换

auto ValidateCell = [](const xlnt::cell& cell, auto& output) -> bool { if (cell.data_type() != xlnt::cell::type::number) { return false; } try { output = cell.value<decltype(output)>(); return true; } catch (...) { return false; } }; int hpValue; if (!ValidateCell(row[2], hpValue)) { std::cerr << "无效的HP值" << std::endl; continue; }

4.2 性能优化建议

对于大型配置表：

禁用公式计算：

wb.calculation_properties().force_full_calculation(false);

批量读取数据：

auto range = ws.range("A2:D100"); for (auto row : range) { // 处理每行数据 }

5. 实战：游戏配置系统实现

5.1 数据结构设计

struct Character { int id; std::string name; int hp; int attack; // 其他属性... }; struct Item { int id; std::string name; ItemType type; int value; // 其他属性... };

5.2 完整加载流程

bool GameConfig::LoadFromExcel(const std::string& filePath) { characters.clear(); items.clear(); xlnt::workbook wb; try { wb.load(filePath); // 加载角色数据 auto charSheet = wb.sheet_by_title("Characters"); for (auto row : charSheet.rows(false)) { // false表示跳过空行 if (row[0].row() == 1) continue; // 跳过标题行 Character c; c.id = row[0].value<int>(); c.name = row[1].value<std::string>(); c.hp = row[2].value<int>(); c.attack = row[3].value<int>(); characters[c.id] = c; } // 加载道具数据 auto itemSheet = wb.sheet_by_title("Items"); for (auto row : itemSheet.rows(false)) { if (row[0].row() == 1) continue; Item item; item.id = row[0].value<int>(); item.name = row[1].value<std::string>(); item.type = static_cast<ItemType>(row[2].value<int>()); item.value = row[3].value<int>(); items[item.id] = item; } } catch (...) { return false; } return true; }

6. 常见问题排查

6.1 文件路径问题

确保使用正确的文件路径格式：

Windows:"C:\\Path\\To\\File.xlsx"或R"(C:\Path\To\File.xlsx)"
Unix-like:"/path/to/file.xlsx"

6.2 数据类型不匹配

使用安全类型转换：

template <typename T> std::optional<T> SafeGetValue(const xlnt::cell& cell) { try { return cell.value<T>(); } catch (...) { return std::nullopt; } } if (auto val = SafeGetValue<int>(row[0])) { // 使用*val } else { // 处理错误 }