多语言字符串不能硬编码，因新增语言需改代码重编译，且字符集、RTL布局、复数规则等无法用if分支处理；应抽离为外部JSON文件，如zh-CN.json，并用std::filesystem+nlohmann::json安全加载，注意路径构造、文件存在性检查、解析校验及线程安全缓存。
多语言字符串为什么不能硬编码在代码里
硬编码字符串会让每次新增语言都得改源码、重新编译，上线后想换翻译还得发新版本。更麻烦的是，不同语言的字符集（比如中文 UTF-8、阿拉伯语 RTL 布局）和复数规则（英语有单复数，俄语有 6 种格变化）根本没法靠 std::string + if 分支兜住。真正可行的路径是把语言资源抽离成外部文件，运行时按需加载。
实际项目中推荐用键值对 JSON 文件管理翻译项，比如 zh-CN.json 和 en-US.json，内容结构统一为：
{ "login_button": "登录", "error_network": "网络连接失败" }这样既方便翻译人员编辑，也利于 CI/CD 流程自动校验缺失键。
如何用 std::filesystem + nlohmann::json 安全加载语言包
C++17 的 std::filesystem 能跨平台处理路径，但要注意：Windows 默认路径分隔符是反斜杠，而 JSON 文件名通常用连字符（如 en-US.json），直接拼接容易出错。nlohmann::json 解析失败时不会抛异常，默认静默返回空对象，必须手动检查 json.is_object()。
关键步骤：
- 用
std::filesystem::path构造资源路径，避免手拼"./res/" + lang + ".json" - 加载前先用
std::filesystem::exists()判定文件是否存在，否则 fallback 到默认语言（如 en-US） - 解析后立即遍历所有 key，比对主语言文件的键集合，记录缺失项到日志——避免运行时出现
"key_not_found: login_button"这种裸字符串
运行时切换语言时怎么避免字符串指针失效
常见错误是把翻译结果存成 const char* 或局部 std::string 引用，一旦重新加载 JSON，旧内存被释放，后续访问就变成野指针。正确做法是让翻译器持有所有已加载语言的完整 nlohmann::json 对象副本，并提供线程安全的读取接口。
示例接口设计：
class LangLoader {
public:
const std::string& get(const std::string& key) const {
// 返回 json[lang][key].get<std::string>() 的拷贝
// 不返回引用，不暴露内部 json 对象
}
void reload(const std::string& lang); // 加载新 json，原子替换内部 map
private:
mutable std::shared_mutex mtx_;
std::unordered_map<std::string, nlohmann::json> cache_;
};
注意 reload() 必须用写锁，而 get() 只需读锁；如果项目不用 C++17，std::shared_mutex 可用 boost::shared_mutex 替代。
中文等宽字符显示错位？别忽略字体与排版上下文
加载出来的字符串本身没问题，但 UI 渲染时出问题很常见：比如 Qt 的 QLabel 显示中文突然截断，或 ImGui 中按钮文字重叠。这不是语言加载逻辑的锅，而是字体没配对——英文用 DejaVu Sans，中文必须额外指定 Noto Sans CJK 或思源黑体。
容易被忽略的点：
- 资源文件保存必须用 UTF-8 无 BOM 格式，Windows 记事本默认带 BOM，会导致
nlohmann::json解析失败并静默丢弃整个文件 - RTL 语言（如希伯来语）需要 UI 框架开启双向文本支持，Qt 要设
QApplication::setLayoutDirection(Qt::RightToLeft)，ImGui 则需调用ImFontConfig::GlyphRanges补全对应 Unicode 区段 - 数字和单位符号（如 “200 KB”）在不同语言中顺序可能变化，不要简单拼接，用
std::format（C++20）或 ICU 的MessageFormat处理占位符
