raylib国际化指南3步解决游戏多语言显示与中文乱码问题【免费下载链接】raylibA simple and easy-to-use library to enjoy videogames programming项目地址: https://gitcode.com/GitHub_Trending/ra/raylib游戏画面里英文提示Start Game显示正常中文标题却变成一排□□□方框——这是用 raylib 做游戏出海时最典型的翻车现场。raylib 是一款轻量级跨平台游戏开发库它本身并不不认识中文问题出在字体加载方式上默认只生成了 ASCII 字符的字形其余字符全部缺失。下面从零讲清楚 raylib 多语言的正确打开方式看完就能跑通。乱码根源码点范围与字体图集先解释两个概念后面会反复用到码点code pointUnicode 给每个字符分配的编号比如A是 0x41你是 0x4F60。每种语言的码点都集中在特定区间。字体图集font atlas加载字体时raylib 会把需要的字形画成一张纹理图图集渲染时就是贴图。图集里没有的字形画出来就是方框或空白。LoadFont默认只把 ASCII 区间32–127的字符烘焙进图集所以中、日、俄等语言必然缺字。解决办法就一条把目标语言的码点范围加进字体生成列表。最小可运行示例按需加载中文码点下面这段完整代码解决窗口里同时显示英文、中文、日文的问题。字体文件NotoSansTC-Regular.ttf就在仓库的 examples/text/resources/ 里支持中文、日文等多语言字形。#include raylib.h // 把一个码点区间补充进已有字体来自官方示例 text_unicode_ranges.c 的思路 static void ExtendFontCJK(Font *font, const char *path, int from, int to) { int added to - from 1; int total font-glyphCount added; int *list (int *)RL_CALLOC(total, sizeof(int)); for (int i 0; i font-glyphCount; i) list[i] font-glyphs[i].value; for (int i 0; i added; i) list[font-glyphCount i] from i; UnloadFont(*font); // 图集重建前先释放旧字体 *font LoadFontEx(path, 32, list, total); // 用合并后的码点表重建字体 RL_FREE(list); } int main(void) { InitWindow(800, 450, raylib multilang demo); Font font LoadFont(resources/NotoSansTC-Regular.ttf); ExtendFontCJK(font, resources/NotoSansTC-Regular.ttf, 0x4E00, 0x9FFF); // 基本汉字 ExtendFontCJK(font, resources/NotoSansTC-Regular.ttf, 0x3040, 0x30FF); // 平假名片假名 SetTextureFilter(font.texture, TEXTURE_FILTER_BILINEAR); // 缩放更平滑缺了会发虚 while (!WindowShouldClose()) { BeginDrawing(); ClearBackground(RAYWHITE); DrawTextEx(font, EN : Start Adventure, (Vector2){60, 80}, 30, 1, MAROON); DrawTextEx(font, ZH : 开始冒险之旅, (Vector2){60, 150}, 30, 1, MAROON); DrawTextEx(font, JP : 冒険をはじめよう, (Vector2){60, 220}, 30, 1, MAROON); EndDrawing(); } UnloadFont(font); CloseWindow(); return 0; }跑起来后三行文字都不会再变方框。注意每次追加范围本质上是销毁旧字体、用更大的码点表重新生成图集所以切换语言集合时不要每帧调用只需在语言真正变化时执行一次。常用码点区间速查语言码点区间中文基本汉字0x4E00 – 0x9FFF日文平假名/片假名0x3040 – 0x30FF韩文谚文0xAC00 – 0xD7AF俄文西里尔0x0400 – 0x04FF希腊文0x0370 – 0x03FF欧洲语言扩展拉丁0x00C0 – 0x017F性能优化只烘焙游戏真正用到的字符把整个 CJK 区间灌进图集能工作但代价明显几千个字形意味着更长的加载时间和更大的显存。如果游戏文本量固定菜单、剧情、说明更省的策略是以文定字——先扫描全部文本提取去重后的码点再只烘焙这些字形。官方示例 text_codepoints_loading.c 用的就是这个思路// allLines 是游戏里全部需要显示的文本UTF-8 保存源文件 int count 0; int *points LoadCodepoints(allLines, count); // 提取所有出现的码点 // 对 points 去重后 Font font LoadFontEx(resources/NotoSansTC-Regular.ttf, 32, points, uniqueCount); UnloadCodepoints(points);好处是图集只包含真正出现过的字形加载快、体积小代价是运行时新出现的字符比如玩家自定义昵称会缺字需要在输入环节补一次码点重建。动态测量文本宽度让 UI 自动适配不同语言同一句提示德文往往比英文长 30% 以上写死的按钮宽度迟早撑爆。正确做法是渲染前先用MeasureTextEx量出实际尺寸让 UI 元素跟着文字走// 按钮背景框宽度由文本实测宽度决定换任何语言都不会溢出 float btnWidth MeasureTextEx(font, Start Game, 30, 1).x 40; DrawRoundedRectangle(100, 320, btnWidth, 56, 12, SKYBLUE); DrawTextEx(font, Start Game, (Vector2){120, 336}, 30, 1, DARKBLUE);换语言时只需替换传入的字符串布局自动跟着变。涉及多行文本时先SetTextLineSpacing设置行距再测量和绘制结果会保持一致。避坑清单现象原因处理个别语言显示方框/空白码点范围没覆盖该语言对照上表补区间或改走按需提取方案字体缩放后边缘发虚图集缩放没开双线性过滤SetTextureFilter(font.texture, TEXTURE_FILTER_BILINEAR)切语言时卡住数秒每帧重复重建图集或一次烘焙几千个 CJK 字形只在语言变化时重建一次优先按需提取码点图集越滚越大、显存上升加载了新字体却忘了释放旧的每次重建前UnloadFont退出前再释放按钮/输入框文字溢出UI 尺寸写死一律用MeasureTextEx动态计算另外提前打两个预防针raylib 的文本绘制按码点顺序摆放字形RTL从右到左语言的方向排布需要你自己处理而 emoji 等复合字符能否显示取决于所选字体是否包含对应字形建议直接参考 examples/text/text_unicode_emojis.c。下一步可以做什么把各语言文案抽成 JSON/ini 配置文件启动时读取切换语言只改一个索引给语言切换加淡入淡出过渡避免图集重建时的突兀闪烁针对阿拉伯语、希伯来语实现从右到左的排版深入字体细节可查阅 src/raylib.h 中 Font 相关接口以及 examples/text/text_unicode_ranges.c 的完整实现。【免费下载链接】raylibA simple and easy-to-use library to enjoy videogames programming项目地址: https://gitcode.com/GitHub_Trending/ra/raylib创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 raylib国际化指南：3步解决游戏多语言显示与中文乱码问题
raylib国际化指南3步解决游戏多语言显示与中文乱码问题【免费下载链接】raylibA simple and easy-to-use library to enjoy videogames programming项目地址: https://gitcode.com/GitHub_Trending/ra/raylib游戏画面里英文提示Start Game显示正常中文标题却变成一排□□□方框——这是用 raylib 做游戏出海时最典型的翻车现场。raylib 是一款轻量级跨平台游戏开发库它本身并不不认识中文问题出在字体加载方式上默认只生成了 ASCII 字符的字形其余字符全部缺失。下面从零讲清楚 raylib 多语言的正确打开方式看完就能跑通。乱码根源码点范围与字体图集先解释两个概念后面会反复用到码点code pointUnicode 给每个字符分配的编号比如A是 0x41你是 0x4F60。每种语言的码点都集中在特定区间。字体图集font atlas加载字体时raylib 会把需要的字形画成一张纹理图图集渲染时就是贴图。图集里没有的字形画出来就是方框或空白。LoadFont默认只把 ASCII 区间32–127的字符烘焙进图集所以中、日、俄等语言必然缺字。解决办法就一条把目标语言的码点范围加进字体生成列表。最小可运行示例按需加载中文码点下面这段完整代码解决窗口里同时显示英文、中文、日文的问题。字体文件NotoSansTC-Regular.ttf就在仓库的 examples/text/resources/ 里支持中文、日文等多语言字形。#include raylib.h // 把一个码点区间补充进已有字体来自官方示例 text_unicode_ranges.c 的思路 static void ExtendFontCJK(Font *font, const char *path, int from, int to) { int added to - from 1; int total font-glyphCount added; int *list (int *)RL_CALLOC(total, sizeof(int)); for (int i 0; i font-glyphCount; i) list[i] font-glyphs[i].value; for (int i 0; i added; i) list[font-glyphCount i] from i; UnloadFont(*font); // 图集重建前先释放旧字体 *font LoadFontEx(path, 32, list, total); // 用合并后的码点表重建字体 RL_FREE(list); } int main(void) { InitWindow(800, 450, raylib multilang demo); Font font LoadFont(resources/NotoSansTC-Regular.ttf); ExtendFontCJK(font, resources/NotoSansTC-Regular.ttf, 0x4E00, 0x9FFF); // 基本汉字 ExtendFontCJK(font, resources/NotoSansTC-Regular.ttf, 0x3040, 0x30FF); // 平假名片假名 SetTextureFilter(font.texture, TEXTURE_FILTER_BILINEAR); // 缩放更平滑缺了会发虚 while (!WindowShouldClose()) { BeginDrawing(); ClearBackground(RAYWHITE); DrawTextEx(font, EN : Start Adventure, (Vector2){60, 80}, 30, 1, MAROON); DrawTextEx(font, ZH : 开始冒险之旅, (Vector2){60, 150}, 30, 1, MAROON); DrawTextEx(font, JP : 冒険をはじめよう, (Vector2){60, 220}, 30, 1, MAROON); EndDrawing(); } UnloadFont(font); CloseWindow(); return 0; }跑起来后三行文字都不会再变方框。注意每次追加范围本质上是销毁旧字体、用更大的码点表重新生成图集所以切换语言集合时不要每帧调用只需在语言真正变化时执行一次。常用码点区间速查语言码点区间中文基本汉字0x4E00 – 0x9FFF日文平假名/片假名0x3040 – 0x30FF韩文谚文0xAC00 – 0xD7AF俄文西里尔0x0400 – 0x04FF希腊文0x0370 – 0x03FF欧洲语言扩展拉丁0x00C0 – 0x017F性能优化只烘焙游戏真正用到的字符把整个 CJK 区间灌进图集能工作但代价明显几千个字形意味着更长的加载时间和更大的显存。如果游戏文本量固定菜单、剧情、说明更省的策略是以文定字——先扫描全部文本提取去重后的码点再只烘焙这些字形。官方示例 text_codepoints_loading.c 用的就是这个思路// allLines 是游戏里全部需要显示的文本UTF-8 保存源文件 int count 0; int *points LoadCodepoints(allLines, count); // 提取所有出现的码点 // 对 points 去重后 Font font LoadFontEx(resources/NotoSansTC-Regular.ttf, 32, points, uniqueCount); UnloadCodepoints(points);好处是图集只包含真正出现过的字形加载快、体积小代价是运行时新出现的字符比如玩家自定义昵称会缺字需要在输入环节补一次码点重建。动态测量文本宽度让 UI 自动适配不同语言同一句提示德文往往比英文长 30% 以上写死的按钮宽度迟早撑爆。正确做法是渲染前先用MeasureTextEx量出实际尺寸让 UI 元素跟着文字走// 按钮背景框宽度由文本实测宽度决定换任何语言都不会溢出 float btnWidth MeasureTextEx(font, Start Game, 30, 1).x 40; DrawRoundedRectangle(100, 320, btnWidth, 56, 12, SKYBLUE); DrawTextEx(font, Start Game, (Vector2){120, 336}, 30, 1, DARKBLUE);换语言时只需替换传入的字符串布局自动跟着变。涉及多行文本时先SetTextLineSpacing设置行距再测量和绘制结果会保持一致。避坑清单现象原因处理个别语言显示方框/空白码点范围没覆盖该语言对照上表补区间或改走按需提取方案字体缩放后边缘发虚图集缩放没开双线性过滤SetTextureFilter(font.texture, TEXTURE_FILTER_BILINEAR)切语言时卡住数秒每帧重复重建图集或一次烘焙几千个 CJK 字形只在语言变化时重建一次优先按需提取码点图集越滚越大、显存上升加载了新字体却忘了释放旧的每次重建前UnloadFont退出前再释放按钮/输入框文字溢出UI 尺寸写死一律用MeasureTextEx动态计算另外提前打两个预防针raylib 的文本绘制按码点顺序摆放字形RTL从右到左语言的方向排布需要你自己处理而 emoji 等复合字符能否显示取决于所选字体是否包含对应字形建议直接参考 examples/text/text_unicode_emojis.c。下一步可以做什么把各语言文案抽成 JSON/ini 配置文件启动时读取切换语言只改一个索引给语言切换加淡入淡出过渡避免图集重建时的突兀闪烁针对阿拉伯语、希伯来语实现从右到左的排版深入字体细节可查阅 src/raylib.h 中 Font 相关接口以及 examples/text/text_unicode_ranges.c 的完整实现。【免费下载链接】raylibA simple and easy-to-use library to enjoy videogames programming项目地址: https://gitcode.com/GitHub_Trending/ra/raylib创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考