Keil中输入汉字显示为问号，如何解决编码与字体设置问题？

Question

Keil MDK（如uVision5）默认使用ASCII编码且编辑器字体不支持Unicode，导致中文注释或字符串显示为“?”。根本原因在于：源文件保存编码非UTF-8（无BOM）或GBK，且编辑器字体未启用中文字体支持。解决方法分两步：① **编码设置**：在Keil中点击“Edit → Configuration → Editor”，勾选“Use UTF-8 encoding for all files”；同时确保源文件以UTF-8 with BOM格式保存（可用Notepad++或VS Code另存为验证）；② **字体配置**：在相同Editor配置页，点击“Font”按钮，选择支持中文的等宽字体（如“Consolas”不支持中文，改用“Microsoft YaHei Mono”或“NSimSun”），字号建议设为10–12。注意：若工程含旧GB2312文件，需统一转码，避免混用编码引发乱码。完成设置后重启Keil，新输入及已保存中文即可正常显示。（字数：198）

Answer 1

```html

一、现象层：中文显示为“?”的直观表现

在Keil µVision5中编辑含中文注释（如// 初始化串口，配置波特率）或中文字符串（如const char *msg = "系统启动成功";）时，编辑器内普遍显示为多个问号（????），编译虽可通过，但可读性归零。此非语法错误，而是编辑器渲染失败的典型表征。

二、机制层：编码与字体双轨失配的底层原理

• 编码链断裂：Keil默认以ANSI（Windows-1252）或系统Locale（如GB2312）解析文件，而现代IDE（VS Code/Notepad++）常以UTF-8（无BOM）保存；当Keil未启用UTF-8解码，字节流被错误映射为ASCII控制字符，导致Unicode BMP区汉字（U+4E00–U+9FFF）全数坍缩为0x3F（'?'）。
• 字体回退失效：即使编码正确，若所选字体（如Consolas）不含CJK字形表（cmap子表缺失GB18030/Unicode映射），GDI渲染引擎无法定位字形轮廓，强制回退至系统默认等宽字体（通常为不支持中文的Courier New）。

三、验证层：三步精准定位根因

检测项	验证方法	正常结果
文件实际编码	用file -i filename.c（Linux/macOS）或Notepad++「编码→字符集」菜单	显示utf-8-with-bom或gbk
Keil当前解码模式	菜单Edit → Configuration → Editor → Use UTF-8 encoding是否勾选	必须为✅启用状态
字体中文支持	在Editor Font对话框中点击「高级」→「字符集」下拉框	应可见GB2312、Chinese GB18030等选项

四、解决层：编码与字体协同配置方案

1. 全局编码开关：进入Edit → Configuration → Editor，严格勾选Use UTF-8 encoding for all files——此设置覆盖工程级编码策略，强制Keil以UTF-8 decoder解析所有源文件。
2. 文件级BOM固化：使用VS Code打开源文件 → 右下角点击编码标识（如"UTF-8"）→ 选择Save with Encoding → UTF-8 with BOM；BOM（EF BB BF）是Windows生态下UTF-8识别的唯一可靠锚点。
3. 字体级中文化：在同页点击Font... → 选择Microsoft YaHei Mono（Win10+）或NSimSun（兼容Win7嵌入式开发环境），字号设为11，确保勾选Allow scaling防止高DPI缩放失真。

五、工程层：遗留文件批量迁移规范

对含GB2312旧文件的工程，执行以下脚本化转码（以Python为例）：

import chardet
from pathlib import Path

def convert_to_utf8_bom(file_path):
    with open(file_path, 'rb') as f:
        raw = f.read()
        enc = chardet.detect(raw)['encoding'] or 'gbk'
    content = raw.decode(enc).encode('utf-8-sig')  # 自动注入BOM
    with open(file_path, 'wb') as f:
        f.write(content)

for p in Path("src/").rglob("*.c"):
    convert_to_utf8_bom(p)

六、防御层：CI/CD阶段编码合规检查

graph LR A[Git Pre-commit Hook] --> B{file encoding == UTF-8-BOM?} B -->|No| C[Reject commit
Exit code 1] B -->|Yes| D[Allow build] C --> E[Auto-fix script: iconv -f GBK -t UTF-8//BOM]

七、延伸层：跨工具链一致性保障

• ARM Compiler 6（AC6）：需在Options for Target → C/C++ → Misc Controls中添加--unicode标志，否则__attribute__((section("中文段名")))将触发链接器错误。
• STM32CubeMX生成代码：导出前在Project Manager → Code Generator中勾选Generate peripheral initialization as a pair of '.c/.h' files，避免其模板硬编码GBK导致Keil二次乱码。
• 版本控制建议：在.gitattributes中声明*.c text charset=utf-8，使GitHub/GitLab Web界面正确渲染中文。

```