Arduino无源蜂鸣器演奏《千本樱》：从频率表到代码实现

很多人的 Arduino 启蒙项目是 Blink：让板载 LED 一秒一闪。但灯会闪之后，真正让朋友觉得“有点东西”的，往往是让蜂鸣器唱歌。用 UNO 板和无源蜂鸣器演奏《千本樱》，在嵌入式社区已经被玩过很多轮，但它至今仍然是一个值得认真做的项目，因为它把“乐谱数字化—音符频率换算—方波控制—硬件发声”整条链路压缩在一个非常小的工程里。

这篇文章不会只贴一段代码让你抄完就关掉，而是会从蜂鸣器选型、接线、频率表、节拍计算讲起，最后给出一段可以直接上传运行的《千本樱》副歌简化示例，并说明常见坑和工程化改进方向。如果你正在学 Arduino，或者准备给学生、朋友做一个有“声音效果”的硬件 Demo，这篇文章会帮你少走很多弯路。

先说判断：这个项目能否成功，关键不在于接线，而在于你选对了蜂鸣器类型，并把乐谱准确翻译成“频率 + 时长”的数组。很多人失败，都是因为把有源蜂鸣器当成无源蜂鸣器来用。下面先把这件事说清楚。

1. 为什么这个“过时”项目值得再做一遍

如果你去搜硬件入门教程，近几年讨论的内容已经从“如何点灯”变成了“如何跑大模型、如何接 ROS、如何做 AIoT”。但这并不意味着 UNO 板失去了价值，恰恰相反，UNO 加蜂鸣器是理解“数字世界如何控制物理世界”的最小闭环之一。

这个项目到底难在哪？接线其实 10 分钟就能完成，真正花时间的是三件事：

• 理解蜂鸣器类型：有源蜂鸣器内部自带振荡电路，通电就响；无源蜂鸣器需要外部给不同频率的方波，才能发出不同音高。
• 理解乐谱数字化：把一首曲子的主旋律拆解成一个个音符，再把每个音符映射为频率值，把每个节拍映射为毫秒时长。
• 理解播放逻辑：Arduino 的tone()函数生成方波，delay()控制每个音持续多久，什么时候停止。

从这个角度看，这个项目就是一个微缩版的“信号处理 + 播放器设计”。你写出来的代码，本质上是一个只输出单音旋律的播放器框架。以后换一首歌，不需要改结构，只需要换音符数组和节拍数组。

有开发经验的读者可能会问：为什么不用 ESP32、树莓派 Pico，或者直接上音频模块？这些方案确实能播放更高保真的音乐，但学习曲线完全不同。UNO 板的优势是确定性高、接线简单、调试没有网络依赖，而且tone()的行为非常透明。对一个新手来说，先用最简方案跑通一次，比一开始就陷入音频解码器和 DMA 配置要友好得多。

所以，这个项目适合谁？它适合刚学完点灯和串口输出、想做下一个硬件项目的 Arduino 新手；也适合需要在教学、社团展示、技术分享中做一个低成本听觉效果的开发者。它的上限不高，但作为“第一首硬件音乐”，体验感很强。

2. 先分清：有源蜂鸣器和无源蜂鸣器

市面上常见的蜂鸣器主要有两种：有源蜂鸣器和无源蜂鸣器。这个“源”指的不是电源，而是“振荡源”。理解这一点，你就能明白为什么这个项目不能选错。

有源蜂鸣器内部集成了一个固定频率的振荡器，只要给它直流电压，它就能发出一个固定音调的声音。换句话说，它的发声频率由内部电路决定，外部无法改变。好处是电路简单，坏处是它只能发出“嘀——”的声音，无法用来演奏旋律。如果把它接到 D8 引脚，无论你tone()写多少频率，听到的都只有一个固定音调。

无源蜂鸣器内部没有振荡源，它相当于一个电磁线圈加振动膜片，必须由外部输入一定频率的方波，膜片才会以这个频率振动并发出对应音高的声音。Arduino 的tone(pin, frequency)正是做这件事的：它让指定引脚输出一个指定频率的方波信号，从而驱动无源蜂鸣器发声。

两类蜂鸣器外观可能非常像，怎么区分？常用办法有几种：

这里也给一个更稳妥的判断方式：如果你手头有万用表，可以用二极管挡测蜂鸣器两个引脚之间的漏极特性，或者直接接一个 3V 电池，能响的是有源，不响但能听到“嗒”的一声的是无源。不过要注意，直接给蜂鸣器通电时要控制时间，测试完尽快断开。

网络热词里出现了“三脚压电陶瓷蜂鸣器”，这里顺带说一句：三脚压电蜂鸣器通常不是给 Arduino 直接用来播放旋律的，它有驱动、反馈、地三个引脚，往往需要配合专用振荡驱动电路或按数据手册接线。新手如果手上是这种蜂鸣器，不要想当然把三个脚中的两个接到 D8 和 GND，那样大概率不会正常工作。本文的示例基于最常见的两脚无源蜂鸣器或蜂鸣器模块。

结论：用 UNO 演奏《千本樱》，一定要选无源蜂鸣器。

3. 物料准备与最小接线方案

这个项目的硬件成本很低。核心物料如下：

软件环境方面，推荐使用 Arduino IDE 2.x。打开 IDE 后，在“工具 > 开发板 > 开发板管理器”中确认 Arduino AVR Boards 已安装，然后在“工具 > 开发板”里选择Arduino Uno。把板子通过 USB 连到电脑后，在“工具 > 端口”中选中对应串口。如果你的兼容板需要特定驱动，请参考该板卡厂商说明，这里不展开。

接线方案有两种，优先推荐第一种。

3.1 方案一：使用无源蜂鸣器模块

这是最稳妥的做法。模块板载了三极管驱动电路和必要的限流电阻，我们只需要把控制信号接到 UNO 的数字引脚即可。

很多模块引脚标识是S、VCC、GND，对应信号、电源、地。如果模块指示灯在发声时会同步变化，说明驱动正常。

3.2 方案二：使用两脚裸蜂鸣器

如果没有模块，只有两脚裸蜂鸣器，可以按下面的方式接：

• 正极引脚（通常长脚或标有+）接 UNO 数字引脚 D8。
• 负极引脚接 GND。

但要注意：UNO 的 ATmega328P 单个数字引脚的驱动能力通常只有 20mA 左右，最大不应超过 40mA。如果蜂鸣器工作电流较大，直接把裸蜂鸣器接在引脚上，可能出现声音很小、板子自动复位甚至引脚损坏的情况。为了安全，请优先使用模块，或者使用 S8050 三极管、ULN2003 达林顿阵列等外部驱动方案。

U 型说明：ULN2003 的驱动方式与普通晶体管不同，它是集电极开路反向驱动，蜂鸣器的一端接直流电源正极，另一端接到 ULN2003 的输出引脚，输入引脚由 Arduino 控制。这样当输入为高电平时，输出端内部导通到地，蜂鸣器形成通路。这种接法不要和模块的“信号接 D8、电源接 5V”搞混。

在最简单的教学接线中，我们默认使用蜂鸣器模块，并把控制引脚接到 D8。这样即使后续代码里修改了引脚号，也只需要改一行常量定义。

4. 播放声音的核心原理：频率、节拍与 tone()

在写代码之前，先理解两个核心概念：音高和节拍。

声音由振动产生，振动频率越高，听感音高越高。乐谱上的不同音符，本质上是不同的频率。比如音乐标准音 A4（a¹）的频率是 440Hz，C5 的频率是 523Hz，G5 的频率是 784Hz。

频率和音名的对应关系不是随意定的。每高一个纯八度，频率翻倍；每个八度内平均分为 12 个半音，相邻半音的频率比是 2 的 1/12 次方。所以 A4 = 440Hz，A5 = 880Hz，C5 = 440 × 2^(3/12) ≈ 523Hz。实际项目中我们不需要每次都算，直接查频率表即可。下面是一张本文会用到的自然音名频率表：

Arduino 的tone()函数就是用来输出指定频率方波的。常见的用法有两种：

// 在指定引脚上输出频率为 523Hz 的方波，持续 500ms tone(8, 523, 500); // 开始输出频率为 784Hz 的方波，直到调用 noTone() 停止 tone(8, 784); noTone(8);

节拍方面，一首曲子的速度通常用 BPM（Beats Per Minute）表示，也就是每分钟多少拍。每拍时长为：

一拍时长(ms) = 60000 / BPM

例如 BPM = 160 时，一拍时长为 60000 / 160 = 375ms。一个四分音符占一拍，八分音符占半拍，十六分音符占四分之一拍。于是，某个音符的持续毫秒数可以这样算：

int durationMs = 60000 / BPM * 4 / noteDurations[i];

其中noteDurations[i]是一个表示音符种类的整数：4 表示四分音符，8 表示八分音符，16 表示十六分音符。这个计算其实等价于：先把四分音符时长算出来，再根据声部种类除以对应倍数。理解了这个公式，后面写乐谱数组就会很快。

tone()的原理是让引脚按照指定频率切换高低电平，生成方波。无源蜂鸣器内部有电磁线圈和振膜，方波信号让振膜快速振动，于是就能听到声音。频率越高，振膜振动越快，音高越高；方波持续时间越长，听到的音符越长。整个播放流程就是：逐个读取乐谱数组中的音符频率和节拍，调用tone()播放，停一拍或预留一点间隔，再播下一个音。

5. 完整示例：用 UNO 演奏《千本樱》副歌节选

下面给出一个可以直接编译上传的示例。项目文件结构是：

千本樱_demo/ ├── 千本樱_demo.ino └── pitch.h

由于《千本樱》全曲速度很快、音符非常密集，这里给出的示例是副歌核心动机的简化版本，用于演示完整的“频率 + 节拍”播放流程。你完全可以用同样的结构，在后面继续扩充melody[]和noteDurations[]数组，把它换成完整版或者任何你喜欢的曲子。

5.1 音符频率头文件

在项目文件夹中新建一个pitch.h文件，内容如下：

// 文件路径：千本樱_demo/pitch.h #ifndef PITCH_H #define PITCH_H // 自然音名频率定义，单位 Hz #define NOTE_C4 262 #define NOTE_CS4 277 #define NOTE_D4 294 #define NOTE_DS4 311 #define NOTE_E4 330 #define NOTE_F4 349 #define NOTE_FS4 370 #define NOTE_G4 392 #define NOTE_GS4 415 #define NOTE_A4 440 #define NOTE_AS4 466 #define NOTE_B4 494 #define NOTE_C5 523 #define NOTE_CS5 554 #define NOTE_D5 587 #define NOTE_DS5 622 #define NOTE_E5 659 #define NOTE_F5 698 #define NOTE_FS5 740 #define NOTE_G5 784 #define NOTE_GS5 831 #define NOTE_A5 880 #define NOTE_AS5 932 #define NOTE_B5 988 #define NOTE_C6 1047 #define NOTE_CS6 1109 #define NOTE_D6 1175 #define NOTE_DS6 1245 #define NOTE_E6 1319 #define NOTE_F6 1397 #define NOTE_FS6 1480 #define NOTE_G6 1568 #define NOTE_GS6 1661 #define NOTE_A6 1760 #define NOTE_AS6 1865 #define NOTE_B6 1976 #endif

这是一个很常见的“音名转频率”头文件。如果你需要更低的音（比如 C2、D2）或者更高的音，按照每个八度频率翻倍的规律继续加宏定义即可。注意，这里的频率是整数近似值，对蜂鸣器播放来说足够准确，不会影响旋律辨识度。

5.2 主程序

新建千本樱_demo.ino，内容如下：

// 文件路径：千本樱_demo/千本樱_demo.ino #include "pitch.h" // 副歌核心动机的简化示意版本 // 你可以把这段数组理解为：从左到右，每个数字代表一个音符频率 int melody[] = { NOTE_E5, NOTE_E5, NOTE_E5, NOTE_E5, NOTE_G5, NOTE_G5, NOTE_G5, NOTE_G5, NOTE_A5, NOTE_A5, NOTE_A5, NOTE_A5, NOTE_G5, NOTE_F5, NOTE_E5, NOTE_D5, NOTE_E5, NOTE_E5, NOTE_E5, NOTE_E5, NOTE_G5, NOTE_G5, NOTE_G5, NOTE_G5, NOTE_A5, NOTE_A5, NOTE_G5, NOTE_F5, NOTE_E5, NOTE_D5, NOTE_C5, NOTE_D5 }; // 每个音符对应的节拍种类 // 4 表示四分音符，8 表示八分音符，16 表示十六分音符 int noteDurations[] = { 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8 }; const int buzzerPin = 8; const int tempoBpm = 160; void setup() { pinMode(buzzerPin, OUTPUT); } void loop() { int melodySize = sizeof(melody) / sizeof(melody[0]); for (int i = 0; i < melodySize; i++) { // 计算单个音符持续毫秒数 int durationMs = 60000 / tempoBpm * 4 / noteDurations[i]; // 频率为 0 表示休止符 if (melody[i] != 0) { tone(buzzerPin, melody[i], durationMs); } // 音符之间留一点间隙，避免音头叠加造成浑浊 delay(durationMs * 1.30); noTone(buzzerPin); } // 整段播完后停 2 秒，再循环播放 delay(2000); }

这段代码的逻辑很直接：

• melody[]数组存放的是每一个音符的频率，来自pitch.h中的宏定义。
• noteDurations[]数组存放的是每一个音符的节拍种类，和melody[]一一对应。
• durationMs通过 BPM 和节拍种类计算得出，单位是毫秒。
• tone(buzzerPin, melody[i], durationMs)让 D8 引脚输出指定频率方波，并持续指定时间。
• delay(durationMs * 1.30)是为了在每个音符之间留出一定的间隔。如果你发现声音太拖沓，可以把1.30改成1.05或1.0。

上传后，蜂鸣器会循环播放这段副歌。这个程序本身不依赖外部库，直接用 Arduino 自带的tone()函数实现，因此非常容易移植到其它兼容 UNO 的开发板上。

5.3 进阶：非阻塞播放

上面的示例用了delay()，它的缺点是播放过程中程序被阻塞，做不了其它事情。如果老师或同学问“怎么让蜂鸣器放音乐的同时 LED 还在闪烁”，你需要的是非阻塞写法。

思路是使用millis()做时间判断，每次到时间就播放下一个音符，而主循环里可以做 LED 闪烁等其它任务。下面是一个最小结构示例：

// 文件路径：nonblocking_buzzer/nonblocking_buzzer.ino #include "pitch.h" struct SongNote { uint16_t freq; uint16_t durationMs; }; SongNote song[] = { {NOTE_E5, 187}, {NOTE_E5, 187}, {NOTE_E5, 187}, {NOTE_G5, 187}, {NOTE_A5, 187}, {NOTE_A5, 187}, {NOTE_G5, 187}, {NOTE_F5, 375} }; const int buzzerPin = 8; const int songLength = sizeof(song) / sizeof(song[0]); int currentIndex = 0; unsigned long nextNoteTime = 0; void setup() { pinMode(buzzerPin, OUTPUT); pinMode(LED_BUILTIN, OUTPUT); nextNoteTime = millis(); } void loop() { unsigned long now = millis(); // 音乐任务：非阻塞播放 if (now >= nextNoteTime && currentIndex < songLength) { tone(buzzerPin, song[currentIndex].freq, song[currentIndex].durationMs); nextNoteTime = now + song[currentIndex].durationMs * 1.30; currentIndex++; if (currentIndex >= songLength) { currentIndex = 0; nextNoteTime = now + 500; // 播完后等 500ms 再循环 } } // 其它任务：LED 闪烁，每 250ms 翻转一次 static unsigned long lastLedTime = 0; if (now - lastLedTime >= 250) { digitalWrite(LED_BUILTIN, !digitalRead(LED_BUILTIN)); lastLedTime = now; } }

这个版本的优点很明显：主循环不再被delay()卡死，播放音乐的同时可以处理按键、显示、传感器读取等任务。后续想加一个“按按键才开始播放”的功能，只需要在音乐任务前面加一个条件即可。

6. 上传运行与结果验证

代码写好后，按照下面的步骤操作：

1. 把pitch.h和千本樱_demo.ino放到同一个项目文件夹中。
2. 用 Arduino IDE 打开千本樱_demo.ino。
3. 在“工具 > 开发板”中选择Arduino Uno。
4. 在“工具 > 端口”中选择板子对应的 COM 口。
5. 点击“上传”按钮，等待编译和烧录完成。

正常情况下，上传完成后蜂鸣器会立即开始循环播放。因为这段旋律是副歌核心动机，你会听到一个非常快的节奏轮廓，能明显感受到它在模仿《千本樱》的风格。

如果蜂鸣器没有发出声音，不要先怀疑代码，第一步要检查接线：

• 模块是否接对了VCC、GND、I/O三根线？
• 信号线是否确实插在 UNO 的 D8 引脚上？
• 如果是裸蜂鸣器，正负极是否接反？

排除接线问题后，可以用一个极简程序做最小测试，确认蜂鸣器本身和 D8 引脚是否正常：

// 文件路径：tone_test/tone_test.ino void setup() { tone(8, 523, 500); } void loop() { }

如果这个程序能让蜂鸣器发出 500ms 的 523Hz 声音，说明硬件链路没问题，问题大概率出在乐谱数组或节拍计算上。

判断程序“成功”的标准不只是“响了”，还包括：

• 不同音高的切换是否明显。
• 节奏是否稳定，没有断断续续的感觉。
• 播放完成后是否能按预期循环。

如果听起来只有“嘀嘀嘀”的同一个音调，最可能的原因是：你手上拿的是有源蜂鸣器，不是无源蜂鸣器。

7. 常见问题与排查思路

下面是这个项目最常遇到的问题，按现象整理成表格：

这里特别想强调一个有源蜂鸣器的问题：有源蜂鸣器接通电源就会响，如果把它接到tone()控制引脚，你可能会听到它一直在响，或者只会发出一个固定音色。很多新手在这时会以为是tone()频率没设置对，反复改数字，却没有意识到硬件本身就不支持变音。这是整个项目最常见、也最容易忽略的一个坑。

另一个容易被忽略的问题是 USB 线。很多 USB 线只能供电，不能传数据，表现为插上后电脑完全没有反应，或者 IDE 端口列表里找不到设备。遇到这种情况，先换一根确定支持数据传输的线，再去看 Arduino IDE 是否能识别板子。

8. 从 Demo 到工程项目：五个工程建议

跑通 Demo 后，如果想把它做得更专业、更可维护，下面几条工程建议值得参考。

8.1 把乐谱数据和播放逻辑彻底分离

在上面示例中，melody[]和noteDurations[]是数据，播放逻辑是循环遍历。下一首曲子最直接的做法是把这两个数组换掉。但更好的做法是用结构体把频率和节拍绑在一起：

struct Note { uint16_t freq; uint8_t duration; }; Note senbonSakura[] = { {659, 8}, {659, 8}, {659, 8}, {784, 8}, // 继续补充... };

这样每首歌的数据更紧凑，换歌时只要定义一个Note xxx[]数组，播放函数不需要改。这是“数据与逻辑分离”思想在嵌入式编程里的经典体现。

8.2 用常量管理引脚和参数

示例代码中，buzzerPin、tempoBpm都使用const int定义，这是好习惯。建议把用到的引脚号、BPM、音符间隔系数统一放到文件头部，不要散落在函数中。这样以后修改接线或调整速度，只需要改常量区域。

8.3 不要只依赖 delay()

Demo 可以用delay()，但工程代码中要警惕阻塞式设计。只要你在delay()期间无法响应按键、传感器和通信，就说明它可能阻塞了其它任务。更好的方式是用millis()做非阻塞时间调度，或者使用简单的状态机。播放音乐的同时让 LED 呼吸闪烁，就是最直接的练手题目。

8.4 关于驱动电路的安全边界

UNO 引脚不是万能的电源输出口。驱动蜂鸣器时，优先使用蜂鸣器模块或外部驱动电路，降低引脚过载风险。尤其在焊接、接线不规范或使用大功率蜂鸣器时，电流问题会成为项目不稳定因素。如果使用 ULN2003 等驱动芯片，注意先阅读数据手册确认输入输出逻辑，避免接线方向错误。

8.5 理解单音蜂鸣器的边界

最后说一个容易被忽略的认知问题：tone()在 UNO 上同一时刻只能在一个引脚上输出方波，也就是说，它天然是单音的。像《千本樱》原曲中的和弦、和声，只靠一个无源蜂鸣器是无法还原的，常见的做法是只演奏主旋律。如果确实想要多声部或和弦，你需要换用能解码音频文件的方案，比如音频解码模块、MP3 模块，或者用 ESP32 做更底层的 PWM 音频输出。

这不是说方案二更好，而是说，单音蜂鸣器项目的价值就是帮助你理解最基础的发声原理。它能做到什么、不能做到什么，都是很清晰的边界。

9. 下一步可以继续做什么

跑通这段《千本樱》副歌之后，你实际上已经掌握了一个极小的“播放器框架”。下一步可以从以下方向继续深入：

• 把一首完整的歌曲从简谱转换成melody[]和noteDurations[]数组，体验完整的乐谱数字化工作流。
• 增加按键控制，用不同按键触发不同乐句，或者控制播放/暂停。
• 增加显示模块，在 LCD 或 OLED 上显示当前播放的音符名称，做一个迷你音乐播放器。
• 把播放逻辑改造成状态机，体验嵌入式里更实用的“非阻塞”架构。
• 尝试用tone()播放不同频率组合，做一些简单的“警笛声”或“游戏音效”，理解频率包络如何影响听感。

一个刚开始只亮 LED 的板子，现在能唱歌了。这个跨越看起来不大，但它背后的核心能力，是把你听到的音乐拆解成数字频率、再把数字频率还原成声音。掌握这个思路以后，再去玩舵机、传感器、PWM 调光，你会发现很多硬件控制逻辑其实是相通的。