Mac系统Arduino安装指南：手把手教学-洪萨配资

Mac上安装Arduino全攻略：从零开始，一次搞定

你是不是刚入手了一块Arduino开发板，满怀期待地插上Mac电脑，却发现IDE打不开、串口找不到、程序传不上去？别急——这几乎是每个新手都会踩的坑。尤其是用Mac系统的用户，虽然系统流畅稳定，但面对非App Store应用和底层驱动时，总会遇到各种“权限警告”“设备未识别”的提示。

别担心，这篇文章就是为你写的。
我们不堆术语，不抄手册，而是像朋友一样，手把手带你走完在Mac上搭建Arduino开发环境的每一步。从下载到点亮第一个LED，中间所有可能卡住你的地方，我都帮你提前排好了雷。

一、先搞清楚：你要装的是什么？

很多人以为“安装Arduino”就是下载一个软件，其实不然。完整的开发环境包含三个关键部分：

Arduino IDE（编程界面）
USB转串驱动（让电脑认得开发板）
开发板核心包（告诉IDE怎么编译代码）

少任何一个，都可能导致上传失败或无法通信。

所以我们接下来就按这个顺序来，一步步打通关。

二、第一步：下载并安装 Arduino IDE

✔ 去哪儿下？千万别错！

一定要去官网下载：👉 https://www.arduino.cc

❌ 不要从第三方网站、百度搜索结果或者某些“汉化版”链接下载！
很多捆绑了广告插件甚至恶意脚本，后期莫名其妙弹窗、崩溃都是它们惹的祸。

点击首页的“Software” → 选择 macOS 版本 → 下载.dmg文件。

✔ 安装过程：拖进去就行？

是的，macOS上的Arduino IDE是绿色免安装的，只需要把图标拖进Applications文件夹即可。

但注意！第一次打开时，大概率会弹出这个提示：

“Arduino”已损坏，无法打开。你应该将它移到废纸篓。

别信！这不是真的损坏，而是macOS的安全机制在作怪。

🔧 怎么绕过“已损坏”警告？

方法一：右键 → 打开

不要用双击启动！
在应用程序中找到 Arduino，右键点击 → 选择「打开」
这时候系统会弹出确认框：“仍要打开吗？” → 点「打开」

这样就能成功运行一次。之后再双击就可以正常打开了。

方法二：手动放行（推荐长期使用）

进入：

系统设置 → 隐私与安全性 → 安全性

你会看到类似提示：“已阻止使用未认证开发者开发的App”。
点一下“仍要打开”。

⚠️ 提示只会在首次尝试运行被拦截的应用时出现，如果没看到，请先通过方法一触发一次。

三、第二步：连接开发板，解决串口识别问题

现在打开Arduino IDE，插上你的Arduino板子（比如最常见的 Uno R3），然后看菜单栏：

工具 → 端口

如果这里显示一堆/dev/cu.xxx的选项，并且你能看到类似Arduino Uno的名字，那恭喜你，驱动已经OK！

但如果：
- 端口列表为空？
- 或者只有一个奇怪的名字但不是Arduino？
- 或者端口是灰色不可选？

那就说明：你的Mac还没认出这块板子。

原因很简单：不同的开发板用了不同的USB芯片，有些需要额外驱动。

📌 常见USB转串芯片及是否需要驱动？

芯片型号	常见于	macOS是否原生支持	是否需手动安装驱动
ATmega16U2	官方Arduino Uno	✅ 是	❌ 否
CH340 / CH341	国产克隆板	❌ 否（M1/M2除外）	✅ 必须
CP2102	NodeMCU、ESP-01等	✅ 自macOS 10.14起内置	❌ 否

也就是说：

如果你是买的官方板或正品授权板 → 大概率不用装驱动；
如果是淘宝几十块的“兼容Uno”，基本都是CH340 →必须装驱动！

💾 如何安装 CH340 驱动？

前往厂商官网下载最新版本：
👉 http://www.wch.cn/download/CH341SER_MAC_ZIP.html

注意：虽然是中文网站，但这是国产芯片WCH（南京沁恒）的正规官网，安全可靠。

下载后解压，运行.pkg安装包。按照提示一步步完成安装，最后重启电脑。

安装完成后，重新插入Arduino板，再回到IDE里看“端口”菜单，应该就能看到了。

💡 小技巧：终端输入下面命令，快速查看当前有哪些串口设备：

ls /dev/cu.*

插拔前后对比，新增的那个就是你的Arduino！

🍏 Apple Silicon（M1/M2芯片）用户特别提醒

目前大多数Arduino工具链都已经支持ARM架构的Mac，包括官方IDE 2.x版本。

但如果你遇到某些旧版插件或第三方核心不兼容的情况，可以这样做：

右键点击 Arduino 应用 → 显示简介 → 勾选「使用Rosetta打开」
这样可以让x86架构的程序在M系列芯片上模拟运行

不过对于绝大多数用户来说，直接原生运行完全没问题，无需开启Rosetta。

四、第三步：配置开发板类型与上传测试程序

现在IDE能识别设备了，下一步是告诉它：“我要烧录的是哪种板子？”

✅ 正确设置开发板型号

路径：

工具 → 开发板 → Arduino AVR Boards → Arduino Uno

注意：一定要选对！如果你用的是 Nano、Mini、Mega，也得对应选择。否则编译参数错误，上传会失败。

✅ 设置正确的串口端口

继续在“工具”菜单里：

工具 → 端口 → 选择 /dev/cu.usbmodemXXXX 或 /dev/cu.wchusbserialXXXX

通常Uno类板子是usbmodem开头，CH340的是wchusbserial开头。

只要前面驱动装好了，这里就会有可选项。

五、实战：上传第一个程序 —— 让LED闪烁起来！

别急着写复杂项目，先用最经典的Blink程序验证整个流程是否通畅。

🔁 如何加载Blink示例？

菜单路径：

文件 → 示例 → 01.Basics → Blink

你会看到一段代码自动打开：

void setup() { pinMode(LED_BUILTIN, OUTPUT); } void loop() { digitalWrite(LED_BUILTIN, HIGH); delay(1000); digitalWrite(LED_BUILTIN, LOW); delay(1000); }

这段代码的作用就是控制板载LED每秒闪一次。

注：LED_BUILTIN是Arduino定义好的常量，不同板子对应的引脚不同。Uno上它是D13，Nano也是，Mega则是其他引脚——但你不需要记，用宏就行。

▶️ 编译 + 上传

点击左上角的✅（勾号图标）先编译，确保没有语法错误。

然后点击➡️（箭头图标）上传程序。

如果一切顺利，你会看到底部状态栏显示：

正在上传到开发板... 上传成功

紧接着，你手上的Arduino板子那个小LED就开始一秒一闪了！

🎉 恭喜！你的Mac + Arduino环境已经完全跑通！

六、常见问题 & 实战避坑指南

即使跟着步骤做，有时候也会翻车。以下是我在教学过程中总结出的Top 3高频故障，附带解决方案。

❌ 问题1：端口是灰色的，没法选？

表现：端口存在，但在菜单里是灰色，无法点击。

原因：另一个程序占用了串口（比如串口助手、Python脚本、旧的IDE实例）。

解决办法：
- 关闭所有可能读取串口的软件；
- 重启Arduino IDE；
- 重新插拔USB线；
- 终端执行ps aux | grep cu查看是否有进程占用；

❌ 问题2：上传失败，提示“stk500_recv(): programmer is not responding”

典型错误信息：

avrdude: stk500_recv(): programmer is not responding avrdude: initialization failed, rc=-1

可能原因：
- 板子没进Bootloader模式
- USB线只能充电不能传数据
- 核心包未正确安装
- 选择了错误的开发板型号

排查步骤：
1. 换一根带数据传输功能的USB线（很多手机充电线不行！）
2. 确保选择了正确的开发板（Uno不能当成Nano用）
3. 手动复位法：在点击“上传”的瞬间，快速按一下板子上的RESET按钮
4. 清理缓存：删除~/Library/Arduino15目录下的临时文件重试

❌ 问题3：开发板管理器打不开 / 加载不出来？

当你想添加ESP32、STM32等非AVR开发板时，需要用“开发板管理器”。

但有时会卡住、加载不出内容。

解决方法：

添加代理镜像源（国内用户必备）

默认服务器在国外，容易连不上。

可以在：

Arduino IDE → 首选项 → Additional Boards Manager URLs

添加以下地址（多个用英文逗号分隔）：

https://mirrors.cloud.tencent.com/arduino/package_index.json, https://dl.espressif.com/dl/package_esp32_index.json

前者是国内加速镜像，后者是ESP32官方源。

保存后重启IDE，再去“开发板管理器”搜索 esp32，就能顺利安装了。

七、进阶建议：让开发更高效

当你熟悉基础操作后，可以考虑这些提升效率的做法：

✅ 使用库管理器自动安装常用库

比如你想控制舵机、OLED屏幕、WiFi模块……
不用自己找GitHub下载，直接在：

工具 → 管理库

搜索关键词（如 Servo、WiFiNINA、Adafruit GFX），一键安装。

✅ 备份你的配置

重要的项目前，建议导出首选项：
- 找到~/Library/Arduino15/preferences.txt
- 复制备份，换电脑时直接替换即可恢复所有设置

✅ 探索 PlatformIO（高级用户）

如果你觉得Arduino IDE太简陋，可以试试 VS Code + PlatformIO 插件。

功能更强、支持更多平台、调试更方便，适合做大型项目。

但对于初学者，还是建议先从Arduino IDE入手，打好基础再说。

最后一句话

你现在手里的Mac，已经不只是写文档、剪视频的工具了——
它已经成为一台真正的硬件开发站。

一块小小的Arduino，加上几根电线和传感器，就能做出温度监控、智能灯控、自动化门铃……甚至是你想象中的任何东西。

而这一切的起点，就是今天你亲手完成的这次安装。

所以，别停下。
去点亮下一个LED，去读取第一组传感器数据，去发送第一条串口消息。

创造的世界，已经在你面前打开了大门。

如果你在过程中遇到了我没提到的问题，欢迎留言交流。我们一起解决。

Mac系统Arduino安装指南：手把手教学