概述
核心需求:我们希望在这些工具中统一编码设置,确保中文支持,避免乱码问题。这通常涉及到设置文件编码为 UTF-8,以及配置编辑器、编译器等。
为了在 STM32 开发环境中统一编码并支持中文,需要分别配置 STM32CubeMX、Keil MDK 和 Git。以下是各工具的详细设置方法:
一、STM32CubeMX 编码设置
核心目标: 强制生成 UTF-8 编码的源代码文件,避免中文注释乱码。
配置步骤:
- 找到 STM32CubeMX 安装目录下的 STM32CubeMX.l4j.ini 文件(通常位于
C:\Program Files\STMicroelectronics\STM32Cube\STM32CubeMX)。 - 在文件末尾的部分添加以下参数
-Dfile.encoding=UTF-8 -Duser.language=zh -Duser.region=CN
- 保存文件并重启 STM32CubeMX。
- 验证:生成工程后,用文本编辑器(如 Notepad++)打开 main.c,确认编码为 UTF-8。
二、Keil MDK 编码设置
核心目标: 确保编辑器正确显示和保存 UTF-8 编码的中文。
配置步骤:
- 打开 Keil MDK,进入 Edit→ Configuration→ Editor 选项卡。
- 在 Encoding 下拉菜单中选择:
- 推荐: UTF-8
- 或 Chinese GB2312(Simplified)(纯中文环境)
- 勾选 Use Unicode Byte Order Mark(自动添加 BOM 头)。
- 字体设置(确保中文显示正常):
- 点击 Font…按钮,选择支持中文的字体(如 Microsoft YaHei、SimSun)。
- 字符集选择 CHINESE_CHARSET。
5. 系统区域设置(Windows,慎重处理,建议不要修改):
- 打开'控制面板' → '区域' → '管理' → '更改系统区域设置'。
- 选择'中文 (简体,中国)',取消勾选'Beta 版:使用 Unicode UTF-8 提供全球语言支持'。
- 重启电脑生效。
注意: 对于已有乱码文件,可使用 File→ Open With Encoding…选择正确编码重新加载。
三、Git 编码设置
核心目标: 确保 Git 命令行和日志正确显示中文文件名和内容。
配置步骤(在 Git Bash 中执行):
- 设置全局编码参数:
git config --global core.quotepath false # 直接显示中文文件名
git config --global i18n.commitEncoding utf-8 # 提交信息编码
git config --global i18n.logOutputEncoding utf-8 # 日志输出编码
git config --global gui.encoding utf-8 # 图形界面编码
-
终端编码设置:
- 右键 Git Bash 窗口标题栏,选择 Options→ Text。

