手把手教你把 Arduino IDE 变成中文——Windows 用户零基础设置指南
你是不是第一次打开 Arduino IDE 的时候,看到满屏的英文菜单有点懵?
“File”是啥?“Sketch”又是什么意思?编译报错全是英文,根本看不懂……
别急,这几乎是每个中文用户都会遇到的问题。尤其是中小学生、电子爱好者或者刚入门嵌入式开发的新手,语言障碍真的会让人打退堂鼓。
但其实,Arduino IDE 是支持中文界面的!虽然它没有像微信那样在设置里给你一个“切换语言”的按钮,但我们完全可以通过一个小技巧,让它从头到尾都显示为简体中文。
今天我就带你一步步操作,不需要任何编程基础,也不用装插件、改系统,只要几分钟,就能让你的 Arduino IDE 彻底“说中文”。
为什么官方不直接提供“中文选项”?
这是很多人问的第一个问题:既然都有中文翻译了,为啥不能点一下就切换?
答案是:Arduino IDE 的设计哲学偏向极简和跨平台兼容性。它的图形界面中确实没有内置语言选择菜单,而是通过读取一个叫preferences.txt的配置文件来决定使用哪种语言。
这个文件就像 IDE 的“记忆本”,记录着你上次用的是哪个开发板、串口号、编辑器字体大小……当然也包括你想用的语言。
所以我们要做的,就是手动在这本“记忆本”里写上一句:“以后请用中文显示”。
核心方法一句话总结:
修改
preferences.txt文件,添加或修改这一行:language=zh-CN
就这么简单。下面我来一步步带你找到这个文件,并安全地完成修改。
第一步:先启动一次 Arduino IDE
哪怕你已经安装好了,也请确保至少启动过一次。
为什么?因为只有当你第一次运行 Arduino IDE 后,系统才会自动生成那个关键的配置文件preferences.txt。如果没启动过,这个文件还不存在,你就无处可改。
✅ 操作步骤:
1. 打开开始菜单,搜索 “Arduino IDE” 并点击启动。
2. 等它完全加载出来(可能有点慢,别关)。
3. 关闭程序即可。
此时,系统已经在后台悄悄创建了一个隐藏的文件夹和一堆配置信息,我们接下来要去“挖”出来。
第二步:找到那个藏得深深的配置文件
文件路径长这样:
C:\Users\你的用户名\AppData\Roaming\Arduino15\preferences.txt听起来很复杂?别怕,我教你两种超简单的打开方式。
方法一:复制粘贴快捷路径(推荐)
直接在文件资源管理器的地址栏里粘贴下面这句:
%APPDATA%\Arduino15\然后回车!
👉%APPDATA%是 Windows 的一个“魔法代号”,它会自动跳转到当前用户的 AppData/Roaming 目录下。你不需要知道自己的用户名是什么,也不用去找隐藏文件夹。
进去之后,你会看到一堆文件,其中就有一个叫preferences.txt—— 这就是我们要动的手脚对象。
方法二:手动开启隐藏文件查看
如果你非要自己找,那就按这个流程:
- 打开“此电脑”
- 进入
C:\Users\[你的名字] - 点击顶部菜单栏的“查看”
- 勾选“隐藏的项目”
- 刷新页面,就能看到灰色的
AppData文件夹 - 进去 → Roaming → Arduino15 → 找到
preferences.txt
💡 小提醒:AppData默认是隐藏的,不勾选“隐藏项目”你是看不到的。
第三步:编辑配置文件,强制启用中文
现在右键点击preferences.txt,选择【打开方式】→ 推荐用记事本(Notepad)、VS Code或Notepad++。
不要用 Word!Word 会偷偷加格式,导致 Arduino IDE 启动失败!
打开后,你可以滚动浏览里面的内容,大概会有几十行配置项,比如:
last.ide.version=2.3.2 default_boards_package_index= editor.font=Monospaced,plain,12 ...我们的目标是找有没有这一行:
language=en-US分情况处理:
✅ 如果有,把它改成:
language=zh-CN❌ 如果没有,就在文件末尾另起一行,加上:
language=zh-CN
⚠️ 注意细节:
- 必须是小写字母
-zh-CN表示简体中文(中国大陆)
- 不要漏掉等号
- 不要加空格或其他符号
- 保存时务必使用UTF-8 编码
📌 如何确认编码?
如果你用的是记事本,在“另存为”时底部有个“编码”选项,请选择UTF-8(不是 ANSI,也不是 Unicode)。否则可能出现乱码!
改完保存(Ctrl + S),然后关闭编辑器。
第四步:重启 Arduino IDE,见证奇迹
关闭所有 Arduino 窗口,重新双击图标启动。
等待几秒钟……
你会发现,原本的:
-File → 文件
-Edit → 编辑
-Sketch → 草稿
-Tools → 工具
-Help → 帮助
全都变成中文了!
不仅如此,连错误提示、编译日志、库管理器里的描述文字,也会尽可能显示为中文(前提是翻译存在)。
🎉 成功了!你现在拥有了一个“本土化”的开发环境。
常见问题 & 避坑指南
Q1:改了还是英文?怎么办?
先别慌,按顺序检查以下几点:
| 检查项 | 正确做法 |
|---|---|
| 是否拼错了? | 必须是language=zh-CN,不能写成chinese或cn |
| 文件路径对吗? | 一定要进%APPDATA%\Arduino15\,不是安装目录! |
| 用了 Word 编辑? | 改用记事本或专业文本编辑器 |
| 编码不对? | 保存为 UTF-8,避免 ANSI 导致乱码 |
| 用的是精简版? | 某些第三方打包版可能删掉了中文资源包,请下载官方完整版 |
Q2:出现乱码怎么办?
基本可以确定是文件编码问题。
解决办法:
1. 重新打开preferences.txt
2. 在记事本中点击【文件】→【另存为】
3. 编码选择UTF-8
4. 再次保存并重启 IDE
Q3:不小心搞坏了,能恢复吗?
当然可以!
最简单的办法:把你原来的preferences.txt备份一下(比如改名为preferences_backup.txt),万一出问题可以直接替换回去。
或者干脆删除这个文件,再启动一次 Arduino IDE,它会自动生成一个新的默认配置文件。
这个技巧适合谁?
- 🎒学生党 / 初学者:降低理解门槛,快速上手实验
- 👩🏫老师 / 教培机构:统一教学环境,方便讲解演示
- 🔧电子爱好者:对照中文教程更高效,少走弯路
- 💼团队协作项目:避免因语言差异造成沟通误解
特别是中小学做机器人、创客课程的时候,让学生面对全英文界面太劝退了。只要提前批量配置好preferences.txt,就能让整个班级都用中文开发,学习效率翻倍。
高级玩家的小贴士
- 批量部署技巧:如果你要给多台电脑设置,可以把改好的
preferences.txt文件复制过去覆盖,省得每台都重做一遍。 - 版本升级注意:Arduino IDE 从 1.8 升级到 2.x 时,有时会清空部分设置,记得升级后重新检查语言配置。
- 繁体中文用户:把
zh-CN改成zh-TW即可切换为繁体中文界面。 - 想切回英文?把那行删掉,或者改成
language=en-US就行。
其实你已经迈出了重要一步
很多人觉得“改个配置文件”听起来很技术流,但其实只要你敢打开、敢改、敢试,就已经超越了90%的初学者。
更重要的是,这次操作让你知道了开发工具背后的“黑盒”并不是完全不可触碰的。你知道了:
- IDE 是怎么记住你的设置的
- 配置文件长什么样
- 怎么安全地修改底层参数
这些认知,对你将来调试串口、管理库文件、自定义开发板,甚至玩转 PlatformIO 或 VSCode 插件,都会有帮助。
最后一句话
中文不是“简化”,而是为了让每个人都能平等地走进创造的世界。
如果你正在教孩子编程、带学生做智能小车、或是自学物联网项目,不妨花两分钟设置一下这个小小的language=zh-CN。
也许正是这一点点改变,能让某个人坚持下去,最终做出属于他的第一个发光的LED、第一辆循迹小车、第一个温湿度报警器。
而这一切,始于一次简单的文本修改。
💬你在设置过程中遇到过什么坑?欢迎留言分享经验,我们一起排雷!