这次我们来看一个非常经典的 Arduino 入门项目用一块 UNO 板和一颗蜂鸣器演奏旋律。项目本身不复杂但把乐谱转成频率数组、用tone()输出方波、再控好时值这几个点串起来之后你就能把任意一首有简谱的曲子在硬件上放出来。标题里的《Aoharu》只是一个例子评论区还能继续点歌方法是一样的。这个项目最能说明 Arduino 的“软硬结合”思路硬件上只有开发板、蜂鸣器、杜邦线三样东西成本很低软件上却涉及音符频率表、数组结构、定时控制、串口交互这些知识点。做一遍之后再看其他需要输出 PWM 信号或者播放音频的传感器项目会顺手很多。文章会按完整流程走一遍先讲蜂鸣器选型再讲电路连接然后是代码实现和曲谱转换方法接着是串口点歌扩展最后给一份常见问题和排查清单。如果你手里正好有 UNO 板和一个无源蜂鸣器按顺序操作大概十几分钟就能跑出第一段旋律。1. 核心能力速览能力项说明项目类型Arduino 硬件编程 方波音频输出旋律播放核心硬件Arduino UNO 开发板、无源蜂鸣器、杜邦线开发环境Arduino IDE 或 VS Code PlatformIO编程语言Arduino C/C主要功能播放单曲旋律、多曲目切换、串口点歌、按键切歌硬件门槛极低普通小尺寸蜂鸣器可直接由 IO 口驱动接口能力数字 IO 输出方波、串口接收命令是否支持批量任务不适用于嵌入式实时播放场景适合场景入门教学、创客小作品、桌面音乐盒、互动点歌装置从表里能看出来这个项目不追求音质和复杂功能核心价值是把“频率”和“时间控制”两个基础概念落到真实硬件上。和跑大模型不同这类项目没有显存、GPU 一说Arduino UNO 的存储空间非常有限但播放几十个音符的旋律绰绰有余。2. 适用场景与使用边界这个项目适合三类人。第一类是刚接触 Arduino 的初学者想找一个不烧硬件、不复杂、又能看到实际效果的小项目第二类是创客爱好者想给桌面摆件或小盒子加上“会唱歌”的功能第三类是准备做互动展品或课堂教具的人可以用按键或串口让观众现场点歌。它能解决的问题很明确让单片机按照指定频率和时值输出音频信号。这个能力可以延伸到蜂鸣器提示音、报警器、电子门铃、音乐闹钟、简易乐器等场景。使用边界也要说清楚。蜂鸣器播放的是方波单音音色接近老式电子表不是 Hi-Fi 音乐不可能还原原曲的编曲、和声和乐器层次。tone()函数同一时间只能在一个引脚上工作所以做不了多声部和弦。另外如果曲子速度很快、音符很多用小喇叭播放时会有比较明显的“电子味”这是硬件特性决定的不是代码 bug。合规方面同样需要留意。曲谱本身可能有版权自己对照公开简谱学习、练习、做小作品没有问题但如果要商用、公开发布带背景音乐的视频内容建议确认谱面来源和授权情况。评论区点歌这种玩法本质是“用户提供曲名、作者找谱并转录”做出来自己玩可以直接拿别人的完整曲谱发布还是要谨慎。3. 硬件准备与必要说明开始接线前先把硬件清单确认一下Arduino UNO 开发板一块Nano 也可以代码基本通用蜂鸣器一只建议选“无源蜂鸣器”杜邦线两根公对公或公对母都可以面包板可选方便固定蜂鸣器如果要串口点歌还需要一根能连接电脑的数据线。核心问题在于蜂鸣器选型。很多人第一次做这个项目结果不响或者只会“滴”一声原因就是买成了有源蜂鸣器。有源蜂鸣器内部集成了振荡源通电就会自己发出固定频率的声音通常只能发出“滴——”的长音或短音。无源蜂鸣器内部没有振荡源需要外部输入一个交流方波才会发声所以它才能被tone()控制成不同频率从而播放旋律。快速区分方法有两个一是看引脚无源蜂鸣器通常可以插进面包板底部能看到线圈或小电路板二是通电测试直接接 3V 电源如果一接上就响就是有源的如果不响很可能是无源需要给它脉冲信号才响。更稳妥的做法是购买时直接看商品页面标注“无源”或“有源”。还有一种三脚压电陶瓷蜂鸣器多出一根反馈或驱动引脚。它的用法要按具体型号确认一般规格书上会标明哪个脚接电源正、哪个脚接地、哪个脚接 IO。如果只是做旋律播放普通两脚无源蜂鸣器更省事没必要为了三脚型号费劲查资料。小尺寸无源蜂鸣器的工作电流只有几十毫安Arduino 的 IO 口可以直接驱动不需要额外放大电路。如果你用的是功率比较大的蜂鸣器、喇叭或者蜂鸣器模块IO 口可能带不动这时可以用三极管或 ULN2003APG 这类达林顿驱动芯片做一个开关放大再接到蜂鸣器上。4. 电路连接与引脚分配电路连接非常简单用两根杜邦线就能搞定。蜂鸣器引脚接法正极通常标注 Arduino UNO 数字引脚 D8负极通常标注 -Arduino UNO GND具体操作确认蜂鸣器正负极如果引脚没有标注可以看外壳丝印一般有号的一端是正极将正极接到 UNO 的 D8 引脚将负极接到 GND如果蜂鸣器脚距比较宽不便直接插到开发板先插到面包板上再用杜邦线转接。这里把 D8 选作输出脚是因为它在 Arduino UNO 上是支持tone()的常规数字引脚之一。换到 D9、D10 也可以只要代码里同步改引脚编号就行。连接完成后先不要写播放代码可以先用一小段测试代码确认蜂鸣器能出声避免后面排查时把所有问题混在一起。#define BUZZER_PIN 8 void setup() { pinMode(BUZZER_PIN, OUTPUT); } void loop() { tone(BUZZER_PIN, 440, 200); delay(500); }这段代码会让蜂鸣器以 440Hz 的频率响 200 毫秒然后静音 500 毫秒循环执行。如果听到“滴”声说明硬件接线没有问题可以继续往下写旋律播放。5. 代码实现音符频率与旋律数组Arduino 播放旋律的核心思路是把每一个音符换算成频率和时值按顺序放进数组然后用tone()按数组顺序逐个输出。常见的音符频率表如下这里给出常用的 C4 到 B5 区间音符频率Hz音符频率HzC4262C5523D4294D5587E4330E5659F4349F5698G4392G5784A4440A5880B4494B5988如果曲子需要升调或降调可以在这个基础上加半音频率或者直接找完整的音符频率表替换。结构上建议用一个结构体数组每个元素包含两个字段音符频率和节拍数。这样代码读起来清晰也方便以后换歌。#define BUZZER_PIN 8 #define TEMPO 240 struct Note { int freq; int beats; }; const Note melody[] { {E4, 1}, {E4, 1}, {F4, 1}, {G4, 1}, {G4, 1}, {F4, 1}, {E4, 1}, {D4, 1}, {C4, 1}, {C4, 1}, {D4, 1}, {E4, 1}, {E4, 2}, {D4, 2}, }; void setup() { pinMode(BUZZER_PIN, OUTPUT); } void playMelody(const Note song[], int count) { int beatMs 60000 / TEMPO; for (int i 0; i count; i) { int duration beatMs * song[i].beats; if (song[i].freq 0) { delay(duration); continue; } tone(BUZZER_PIN, song[i].freq, duration * 0.9); delay(duration); noTone(BUZZER_PIN); delay(30); } } void loop() { int count sizeof(melody) / sizeof(melody[0]); playMelody(melody, count); delay(2000); }说明几个关键的代码点TEMPO是每分钟四分音符的数量数值越大曲子越快越小越慢可以按原曲速度调整结构体里的beats表示这个音符占多少拍比如四分音符是 1二分音符是 2八分音符是 0.5频率为 0 时表示休止符不发音只等待对应时值tone()的第三个参数设置持续时长乘 0.9 是为了让每个音符之间有一点小空隙避免音头粘连noTone()放在delay()之后是为了确保当前音符播放完成后再关闭输出。这段代码里的示例旋律是《欢乐颂》的片段作为跑通流程的测试曲目。你不需要弄清楚它具体是什么歌只需要验证整体框架能不能正常工作。6. 把《Aoharu》简谱转换成播放数组框架跑通之后下一步就是把标题里的《Aoharu》换成数组。这个过程可以分成四步第一步是找谱子。最简单的方式是搜索“曲名 简谱”比如“《Aoharu》 简谱”也可以找网友整理的音符串。找谱时优先选择来源清晰、节奏标注完整的版本。第二步是把简谱的音名转换成频率。在音符频率表里查对应的赫兹数。比如简谱1如果是 C 调就查 C4 或 C5 的频率具体用哪个八度要根据原曲音高和蜂鸣器实际听感来定同一段旋律整体高一个八度或低一个八度听感差别很大可以对比着挑一个顺耳的。第三步是决定节拍。每首曲子的拍号不同四四拍的情况下一个小节通常有四拍。看简谱里的减时线和附点减时线越多时值越短。如果谱子上没有标注就按原曲节奏估一个大概边听边改TEMPO。第四步是把查到的音名和时值填进数组。以《欢乐颂》片段为例转换后就是前面代码里的样子。换成《Aoharu》时只需要把melody[]数组里的音符替换掉其他地方不用动。对于没有现成代码基础的人最简单的工作流是先把整首曲子的简谱按小节抄下来标注每个音符的八度再对照频率表填数。这一步虽然繁琐但做一次就能完全理解“音符频率”和“节拍时值”这两个概念。有一点要提醒如果公开的《Aoharu》简谱本身是用户自己扒谱整理的用于学习调试通常没问题但不要把它包装成自己的原创内容发布。自己做实验无所谓发布和商用前先确认授权。7. 串口点歌与多曲目切换扩展“评论区点歌”这个玩法放到 Arduino 上可以有几种实现方式。最简单的是把多首曲子做成一个歌单通过串口发数字编号来切换。比如发1播放《Aoharu》发2播放另一首发3切到第三首。多曲目版本的核心思路是把每首歌的旋律数组独立出来写一个通用的playMelody()函数在loop()里读取串口命令根据命令选择对应的数组。下面先给一个多曲目播放的框架#define BUZZER_PIN 8 #define TEMPO 240 struct Note { int freq; int beats; }; const Note song1[] { {E4, 1}, {E4, 1}, {F4, 1}, {G4, 1}, {G4, 1}, {F4, 1}, {E4, 1}, {D4, 1}, {C4, 1}, {C4, 1}, {D4, 1}, {E4, 1}, {E4, 2}, {D4, 2}, }; const Note song2[] { {C4, 1}, {C4, 1}, {G4, 1}, {G4, 1}, {A4, 1}, {A4, 1}, {G4, 2}, {F4, 1}, {F4, 1}, {E4, 1}, {E4, 1}, {D4, 1}, {D4, 1}, {C4, 2}, }; void playMelody(const Note song[], int count) { int beatMs 60000 / TEMPO; for (int i 0; i count; i) { int duration beatMs * song[i].beats; if (song[i].freq 0) { delay(duration); continue; } tone(BUZZER_PIN, song[i].freq, duration * 0.9); delay(duration); noTone(BUZZER_PIN); delay(30); } } void setup() { pinMode(BUZZER_PIN, OUTPUT); Serial.begin(9600); } void loop() { if (Serial.available() 0) { char cmd Serial.read(); if (cmd 1) { playMelody(song1, sizeof(song1) / sizeof(song1[0])); } else if (cmd 2) { playMelody(song2, sizeof(song2) / sizeof(song2[0])); } } }这个版本在电脑上打开串口监视器波特率选择 9600发送1或2蜂鸣器就会播对应的曲子。如果你不想用串口可以加两个按键一个按键对应一首歌按下时调用playMelody()即可。如果做桌面音乐盒建议加一个 OLED 小屏幕显示当前歌曲名再接两个按键切换整体就是一个完整的小作品。OLED 用 I2C 接口接 A4、A5代码上只需要根据按键状态选择melody数组。8. PC 端串口点歌脚本串口点歌除了用 Arduino IDE 自带的串口监视器也可以写一个简单的 Python 脚本。这样以后想批量控制、或者接成“点歌台”的入口都会方便一些。先安装依赖库pip install pyserial然后写一个最简单的发送命令脚本import serial import time ser serial.Serial(COM3, 9600, timeout1) time.sleep(2) command input(输入歌曲编号) ser.write(command.encode()) ser.close()如果是在 Linux 下运行把COM3换成实际串口设备名比如/dev/ttyUSB0。运行脚本后输入1对应第一首歌就会播放。这里有一个细节要注意Arduino 的串口在重启后需要一点时间初始化所以 Python 脚本里加time.sleep(2)避免打开串口后立刻发送命令导致数据丢失。如果发了一次没反应再发一次基本就能对上。更完整的点歌系统可以设计成PC 端维护一个歌曲列表用户输入歌曲名Python 脚本查询后发送编号或者用 PyQt 写一个简单的图形界面点击按钮就发命令。对嵌入式项目来说串口就是它最简单、最稳定的“服务接口”。9. 资源占用、音质控制与性能观察Arduino UNO 的资源非常有限但也正因为有限观察资源占用反而很简单。编译时Arduino IDE 下方的输出窗口会显示 Skatch 使用字节数和全局变量使用字节数。比如一个几十个音符的旋律数组占用 Flash 也就几百到一两千字节SRAM 占用更小。只要你不是把所有歌曲一次性全塞进去UNO 的 32KB Flash 基本不用担心。真正的瓶颈是tone()函数的单通道限制和播放时的阻塞式delay()。播放过程中delay()会阻塞主循环这意味着一首歌播放期间程序做不了其他事情。如果你在播放的同时还要读取按键或串口命令就要换成非阻塞方式用millis()记录每个音符的开始时间和结束时间主循环里不断检查是否到了下一个音符。这样按键和串口就能在音符间隙被响应。音质方面有几个参数值得现场调整。TEMPO决定整体速度一般调到接近原曲节奏即可。tone()的 duration 乘以 0.9这个系数是给音符留呼吸数值调大音符之间空隙更大调小则更紧凑但容易产生粘连感。每播放完一个音符后的delay(30)也影响听感实际可以根据蜂鸣器型号微调。如果想要更清晰的两种音色可以换不同尺寸的蜂鸣器实验。小尺寸压电蜂鸣器声音偏亮、偏尖大尺寸磁性蜂鸣器声音更低沉。同一条旋律在不同蜂鸣器上听感差异明显这个属于硬件层面的调音空间。用电方面Arduino UNO 可以直接用 USB 供电也可以在VIN或5V引脚接外部 5V 电源。普通蜂鸣器功率很小USB 供电足够。如果外接大功率喇叭单独供电会更稳妥。10. 常见问题与排查方法问题现象可能原因排查方式解决方案接好线后完全不响蜂鸣器是有源蜂鸣器直接接 3V 听是否有固定“滴”声更换为无源蜂鸣器或用驱动脉冲测试上电后一直“滴”响不停有源蜂鸣器按无源方式接线检查蜂鸣器型号和封装更换无源蜂鸣器声音很小蜂鸣器功率小或驱动不足靠近听检查供电换更大尺寸蜂鸣器或加三极管/ULN2003 驱动只有第一个音符响蜂鸣器正负极接反核对引脚标注调换正负极旋律节奏不对TEMPO设置不合适对比原曲速度调整TEMPO数值音符之间粘连delay(30)太小听感判断增大音符间停顿时间串口发命令没反应波特率不一致或复位时序不对检查串口监视器波特率是否为 9600重启板子后重新发送命令播放时按按键不回delay()阻塞导致分析主循环逻辑改用millis()非阻塞播放编译报错数组越界或宏定义冲突查看编译器提示的行号检查数组长度和宏定义命名断电后重新上电不播loop()里没有自动播放逻辑检查loop()中是否调用了播放函数把播放调用放回loop()这里单独说一下“只有第一个音符响”的情况。很多人第一次接线会把正负极搞反导致tone()输出的信号没法驱动蜂鸣器正常振动。调换正负极是最快的验证方法。另外如果蜂鸣器是有源的tone()输出方波驱动它声音会一直固定在一个频率不会跟随旋律变化所以“是不是用成了有源蜂鸣器”永远要排在排查第一项。11. 最佳实践建议做这类 Arduino 小项目有几条经验值得记下来。先把工程文件按功能分开。一个文件夹放.ino主程序旋律数组可以拆到单独的.h或.cpp文件里这样以后加歌、换歌不需要反复改主程序逻辑。第一次测试时不要直接上整首曲子。先把一个简单旋律跑通比如前面给的《欢乐颂》片段或《小星星》确认接线和播放框架没问题以后再替换成完整曲目。这样可以避免“哪里都没错但就是不响”时无法定位问题。调试旋律时可以先用Serial.println()打印当前播放的音符频率和时值确认代码走到了预期位置。尤其遇到休止符和长音时打印输出能帮你快速定位是代码问题还是听感问题。批量实验时建议用 USB 供电开发板自带稳压比外部乱接电源安全。桌面音乐盒如果做成长期运行的成品要加一个电源开关并且注意播放音量蜂鸣器持续响会很吵。做一个能长期保存的“曲库管理”方法单独维护一个文本文件每一行写“歌曲名 简谱”用导入工具转换成数组。手动改代码也不是不行但曲目多到十几首以后维护成本明显上升。12. 总结与下一步这个项目最值得尝试的点是用最简单的硬件完整走通“乐谱到音频输出”的链路。写代码之前你以为难点在 Arduino 语法实际操作之后你会发现难点在“怎么把简谱的时值转成数组”这个转变会逼着你去理解音频频率和节拍的本质。最优先验证的功能是先让蜂鸣器响起一个单音然后播放一段短旋律最后再换完整曲子。最容易踩的坑是用了有源蜂鸣器而不自知白白改了半天代码其次是节奏完全不对因为TEMPO和音符时值没有匹配。下一步可以扩展的方向很多给作品加 OLED 显示歌名用按键做切歌把串口点歌界面做成网页或小程序甚至用多个蜂鸣器做简单合奏。这类扩展都不需要重新理解基本原理只要在当前框架上做加法就行。建议把这套“结构体数组 通用播放函数 串口命令选择曲目”的代码保存下来后面做提示音、闹钟、门铃项目时直接复用。整个流程跑通以后评论区点歌就真的只是“换一个数组”的事情了。 
长河君 · 2026/9/2 3:12:13 · 阅读 1.2k 用Arduino UNO驱动蜂鸣器：从简谱到旋律播放的入门实战
这次我们来看一个非常经典的 Arduino 入门项目用一块 UNO 板和一颗蜂鸣器演奏旋律。项目本身不复杂但把乐谱转成频率数组、用tone()输出方波、再控好时值这几个点串起来之后你就能把任意一首有简谱的曲子在硬件上放出来。标题里的《Aoharu》只是一个例子评论区还能继续点歌方法是一样的。这个项目最能说明 Arduino 的“软硬结合”思路硬件上只有开发板、蜂鸣器、杜邦线三样东西成本很低软件上却涉及音符频率表、数组结构、定时控制、串口交互这些知识点。做一遍之后再看其他需要输出 PWM 信号或者播放音频的传感器项目会顺手很多。文章会按完整流程走一遍先讲蜂鸣器选型再讲电路连接然后是代码实现和曲谱转换方法接着是串口点歌扩展最后给一份常见问题和排查清单。如果你手里正好有 UNO 板和一个无源蜂鸣器按顺序操作大概十几分钟就能跑出第一段旋律。1. 核心能力速览能力项说明项目类型Arduino 硬件编程 方波音频输出旋律播放核心硬件Arduino UNO 开发板、无源蜂鸣器、杜邦线开发环境Arduino IDE 或 VS Code PlatformIO编程语言Arduino C/C主要功能播放单曲旋律、多曲目切换、串口点歌、按键切歌硬件门槛极低普通小尺寸蜂鸣器可直接由 IO 口驱动接口能力数字 IO 输出方波、串口接收命令是否支持批量任务不适用于嵌入式实时播放场景适合场景入门教学、创客小作品、桌面音乐盒、互动点歌装置从表里能看出来这个项目不追求音质和复杂功能核心价值是把“频率”和“时间控制”两个基础概念落到真实硬件上。和跑大模型不同这类项目没有显存、GPU 一说Arduino UNO 的存储空间非常有限但播放几十个音符的旋律绰绰有余。2. 适用场景与使用边界这个项目适合三类人。第一类是刚接触 Arduino 的初学者想找一个不烧硬件、不复杂、又能看到实际效果的小项目第二类是创客爱好者想给桌面摆件或小盒子加上“会唱歌”的功能第三类是准备做互动展品或课堂教具的人可以用按键或串口让观众现场点歌。它能解决的问题很明确让单片机按照指定频率和时值输出音频信号。这个能力可以延伸到蜂鸣器提示音、报警器、电子门铃、音乐闹钟、简易乐器等场景。使用边界也要说清楚。蜂鸣器播放的是方波单音音色接近老式电子表不是 Hi-Fi 音乐不可能还原原曲的编曲、和声和乐器层次。tone()函数同一时间只能在一个引脚上工作所以做不了多声部和弦。另外如果曲子速度很快、音符很多用小喇叭播放时会有比较明显的“电子味”这是硬件特性决定的不是代码 bug。合规方面同样需要留意。曲谱本身可能有版权自己对照公开简谱学习、练习、做小作品没有问题但如果要商用、公开发布带背景音乐的视频内容建议确认谱面来源和授权情况。评论区点歌这种玩法本质是“用户提供曲名、作者找谱并转录”做出来自己玩可以直接拿别人的完整曲谱发布还是要谨慎。3. 硬件准备与必要说明开始接线前先把硬件清单确认一下Arduino UNO 开发板一块Nano 也可以代码基本通用蜂鸣器一只建议选“无源蜂鸣器”杜邦线两根公对公或公对母都可以面包板可选方便固定蜂鸣器如果要串口点歌还需要一根能连接电脑的数据线。核心问题在于蜂鸣器选型。很多人第一次做这个项目结果不响或者只会“滴”一声原因就是买成了有源蜂鸣器。有源蜂鸣器内部集成了振荡源通电就会自己发出固定频率的声音通常只能发出“滴——”的长音或短音。无源蜂鸣器内部没有振荡源需要外部输入一个交流方波才会发声所以它才能被tone()控制成不同频率从而播放旋律。快速区分方法有两个一是看引脚无源蜂鸣器通常可以插进面包板底部能看到线圈或小电路板二是通电测试直接接 3V 电源如果一接上就响就是有源的如果不响很可能是无源需要给它脉冲信号才响。更稳妥的做法是购买时直接看商品页面标注“无源”或“有源”。还有一种三脚压电陶瓷蜂鸣器多出一根反馈或驱动引脚。它的用法要按具体型号确认一般规格书上会标明哪个脚接电源正、哪个脚接地、哪个脚接 IO。如果只是做旋律播放普通两脚无源蜂鸣器更省事没必要为了三脚型号费劲查资料。小尺寸无源蜂鸣器的工作电流只有几十毫安Arduino 的 IO 口可以直接驱动不需要额外放大电路。如果你用的是功率比较大的蜂鸣器、喇叭或者蜂鸣器模块IO 口可能带不动这时可以用三极管或 ULN2003APG 这类达林顿驱动芯片做一个开关放大再接到蜂鸣器上。4. 电路连接与引脚分配电路连接非常简单用两根杜邦线就能搞定。蜂鸣器引脚接法正极通常标注 Arduino UNO 数字引脚 D8负极通常标注 -Arduino UNO GND具体操作确认蜂鸣器正负极如果引脚没有标注可以看外壳丝印一般有号的一端是正极将正极接到 UNO 的 D8 引脚将负极接到 GND如果蜂鸣器脚距比较宽不便直接插到开发板先插到面包板上再用杜邦线转接。这里把 D8 选作输出脚是因为它在 Arduino UNO 上是支持tone()的常规数字引脚之一。换到 D9、D10 也可以只要代码里同步改引脚编号就行。连接完成后先不要写播放代码可以先用一小段测试代码确认蜂鸣器能出声避免后面排查时把所有问题混在一起。#define BUZZER_PIN 8 void setup() { pinMode(BUZZER_PIN, OUTPUT); } void loop() { tone(BUZZER_PIN, 440, 200); delay(500); }这段代码会让蜂鸣器以 440Hz 的频率响 200 毫秒然后静音 500 毫秒循环执行。如果听到“滴”声说明硬件接线没有问题可以继续往下写旋律播放。5. 代码实现音符频率与旋律数组Arduino 播放旋律的核心思路是把每一个音符换算成频率和时值按顺序放进数组然后用tone()按数组顺序逐个输出。常见的音符频率表如下这里给出常用的 C4 到 B5 区间音符频率Hz音符频率HzC4262C5523D4294D5587E4330E5659F4349F5698G4392G5784A4440A5880B4494B5988如果曲子需要升调或降调可以在这个基础上加半音频率或者直接找完整的音符频率表替换。结构上建议用一个结构体数组每个元素包含两个字段音符频率和节拍数。这样代码读起来清晰也方便以后换歌。#define BUZZER_PIN 8 #define TEMPO 240 struct Note { int freq; int beats; }; const Note melody[] { {E4, 1}, {E4, 1}, {F4, 1}, {G4, 1}, {G4, 1}, {F4, 1}, {E4, 1}, {D4, 1}, {C4, 1}, {C4, 1}, {D4, 1}, {E4, 1}, {E4, 2}, {D4, 2}, }; void setup() { pinMode(BUZZER_PIN, OUTPUT); } void playMelody(const Note song[], int count) { int beatMs 60000 / TEMPO; for (int i 0; i count; i) { int duration beatMs * song[i].beats; if (song[i].freq 0) { delay(duration); continue; } tone(BUZZER_PIN, song[i].freq, duration * 0.9); delay(duration); noTone(BUZZER_PIN); delay(30); } } void loop() { int count sizeof(melody) / sizeof(melody[0]); playMelody(melody, count); delay(2000); }说明几个关键的代码点TEMPO是每分钟四分音符的数量数值越大曲子越快越小越慢可以按原曲速度调整结构体里的beats表示这个音符占多少拍比如四分音符是 1二分音符是 2八分音符是 0.5频率为 0 时表示休止符不发音只等待对应时值tone()的第三个参数设置持续时长乘 0.9 是为了让每个音符之间有一点小空隙避免音头粘连noTone()放在delay()之后是为了确保当前音符播放完成后再关闭输出。这段代码里的示例旋律是《欢乐颂》的片段作为跑通流程的测试曲目。你不需要弄清楚它具体是什么歌只需要验证整体框架能不能正常工作。6. 把《Aoharu》简谱转换成播放数组框架跑通之后下一步就是把标题里的《Aoharu》换成数组。这个过程可以分成四步第一步是找谱子。最简单的方式是搜索“曲名 简谱”比如“《Aoharu》 简谱”也可以找网友整理的音符串。找谱时优先选择来源清晰、节奏标注完整的版本。第二步是把简谱的音名转换成频率。在音符频率表里查对应的赫兹数。比如简谱1如果是 C 调就查 C4 或 C5 的频率具体用哪个八度要根据原曲音高和蜂鸣器实际听感来定同一段旋律整体高一个八度或低一个八度听感差别很大可以对比着挑一个顺耳的。第三步是决定节拍。每首曲子的拍号不同四四拍的情况下一个小节通常有四拍。看简谱里的减时线和附点减时线越多时值越短。如果谱子上没有标注就按原曲节奏估一个大概边听边改TEMPO。第四步是把查到的音名和时值填进数组。以《欢乐颂》片段为例转换后就是前面代码里的样子。换成《Aoharu》时只需要把melody[]数组里的音符替换掉其他地方不用动。对于没有现成代码基础的人最简单的工作流是先把整首曲子的简谱按小节抄下来标注每个音符的八度再对照频率表填数。这一步虽然繁琐但做一次就能完全理解“音符频率”和“节拍时值”这两个概念。有一点要提醒如果公开的《Aoharu》简谱本身是用户自己扒谱整理的用于学习调试通常没问题但不要把它包装成自己的原创内容发布。自己做实验无所谓发布和商用前先确认授权。7. 串口点歌与多曲目切换扩展“评论区点歌”这个玩法放到 Arduino 上可以有几种实现方式。最简单的是把多首曲子做成一个歌单通过串口发数字编号来切换。比如发1播放《Aoharu》发2播放另一首发3切到第三首。多曲目版本的核心思路是把每首歌的旋律数组独立出来写一个通用的playMelody()函数在loop()里读取串口命令根据命令选择对应的数组。下面先给一个多曲目播放的框架#define BUZZER_PIN 8 #define TEMPO 240 struct Note { int freq; int beats; }; const Note song1[] { {E4, 1}, {E4, 1}, {F4, 1}, {G4, 1}, {G4, 1}, {F4, 1}, {E4, 1}, {D4, 1}, {C4, 1}, {C4, 1}, {D4, 1}, {E4, 1}, {E4, 2}, {D4, 2}, }; const Note song2[] { {C4, 1}, {C4, 1}, {G4, 1}, {G4, 1}, {A4, 1}, {A4, 1}, {G4, 2}, {F4, 1}, {F4, 1}, {E4, 1}, {E4, 1}, {D4, 1}, {D4, 1}, {C4, 2}, }; void playMelody(const Note song[], int count) { int beatMs 60000 / TEMPO; for (int i 0; i count; i) { int duration beatMs * song[i].beats; if (song[i].freq 0) { delay(duration); continue; } tone(BUZZER_PIN, song[i].freq, duration * 0.9); delay(duration); noTone(BUZZER_PIN); delay(30); } } void setup() { pinMode(BUZZER_PIN, OUTPUT); Serial.begin(9600); } void loop() { if (Serial.available() 0) { char cmd Serial.read(); if (cmd 1) { playMelody(song1, sizeof(song1) / sizeof(song1[0])); } else if (cmd 2) { playMelody(song2, sizeof(song2) / sizeof(song2[0])); } } }这个版本在电脑上打开串口监视器波特率选择 9600发送1或2蜂鸣器就会播对应的曲子。如果你不想用串口可以加两个按键一个按键对应一首歌按下时调用playMelody()即可。如果做桌面音乐盒建议加一个 OLED 小屏幕显示当前歌曲名再接两个按键切换整体就是一个完整的小作品。OLED 用 I2C 接口接 A4、A5代码上只需要根据按键状态选择melody数组。8. PC 端串口点歌脚本串口点歌除了用 Arduino IDE 自带的串口监视器也可以写一个简单的 Python 脚本。这样以后想批量控制、或者接成“点歌台”的入口都会方便一些。先安装依赖库pip install pyserial然后写一个最简单的发送命令脚本import serial import time ser serial.Serial(COM3, 9600, timeout1) time.sleep(2) command input(输入歌曲编号) ser.write(command.encode()) ser.close()如果是在 Linux 下运行把COM3换成实际串口设备名比如/dev/ttyUSB0。运行脚本后输入1对应第一首歌就会播放。这里有一个细节要注意Arduino 的串口在重启后需要一点时间初始化所以 Python 脚本里加time.sleep(2)避免打开串口后立刻发送命令导致数据丢失。如果发了一次没反应再发一次基本就能对上。更完整的点歌系统可以设计成PC 端维护一个歌曲列表用户输入歌曲名Python 脚本查询后发送编号或者用 PyQt 写一个简单的图形界面点击按钮就发命令。对嵌入式项目来说串口就是它最简单、最稳定的“服务接口”。9. 资源占用、音质控制与性能观察Arduino UNO 的资源非常有限但也正因为有限观察资源占用反而很简单。编译时Arduino IDE 下方的输出窗口会显示 Skatch 使用字节数和全局变量使用字节数。比如一个几十个音符的旋律数组占用 Flash 也就几百到一两千字节SRAM 占用更小。只要你不是把所有歌曲一次性全塞进去UNO 的 32KB Flash 基本不用担心。真正的瓶颈是tone()函数的单通道限制和播放时的阻塞式delay()。播放过程中delay()会阻塞主循环这意味着一首歌播放期间程序做不了其他事情。如果你在播放的同时还要读取按键或串口命令就要换成非阻塞方式用millis()记录每个音符的开始时间和结束时间主循环里不断检查是否到了下一个音符。这样按键和串口就能在音符间隙被响应。音质方面有几个参数值得现场调整。TEMPO决定整体速度一般调到接近原曲节奏即可。tone()的 duration 乘以 0.9这个系数是给音符留呼吸数值调大音符之间空隙更大调小则更紧凑但容易产生粘连感。每播放完一个音符后的delay(30)也影响听感实际可以根据蜂鸣器型号微调。如果想要更清晰的两种音色可以换不同尺寸的蜂鸣器实验。小尺寸压电蜂鸣器声音偏亮、偏尖大尺寸磁性蜂鸣器声音更低沉。同一条旋律在不同蜂鸣器上听感差异明显这个属于硬件层面的调音空间。用电方面Arduino UNO 可以直接用 USB 供电也可以在VIN或5V引脚接外部 5V 电源。普通蜂鸣器功率很小USB 供电足够。如果外接大功率喇叭单独供电会更稳妥。10. 常见问题与排查方法问题现象可能原因排查方式解决方案接好线后完全不响蜂鸣器是有源蜂鸣器直接接 3V 听是否有固定“滴”声更换为无源蜂鸣器或用驱动脉冲测试上电后一直“滴”响不停有源蜂鸣器按无源方式接线检查蜂鸣器型号和封装更换无源蜂鸣器声音很小蜂鸣器功率小或驱动不足靠近听检查供电换更大尺寸蜂鸣器或加三极管/ULN2003 驱动只有第一个音符响蜂鸣器正负极接反核对引脚标注调换正负极旋律节奏不对TEMPO设置不合适对比原曲速度调整TEMPO数值音符之间粘连delay(30)太小听感判断增大音符间停顿时间串口发命令没反应波特率不一致或复位时序不对检查串口监视器波特率是否为 9600重启板子后重新发送命令播放时按按键不回delay()阻塞导致分析主循环逻辑改用millis()非阻塞播放编译报错数组越界或宏定义冲突查看编译器提示的行号检查数组长度和宏定义命名断电后重新上电不播loop()里没有自动播放逻辑检查loop()中是否调用了播放函数把播放调用放回loop()这里单独说一下“只有第一个音符响”的情况。很多人第一次接线会把正负极搞反导致tone()输出的信号没法驱动蜂鸣器正常振动。调换正负极是最快的验证方法。另外如果蜂鸣器是有源的tone()输出方波驱动它声音会一直固定在一个频率不会跟随旋律变化所以“是不是用成了有源蜂鸣器”永远要排在排查第一项。11. 最佳实践建议做这类 Arduino 小项目有几条经验值得记下来。先把工程文件按功能分开。一个文件夹放.ino主程序旋律数组可以拆到单独的.h或.cpp文件里这样以后加歌、换歌不需要反复改主程序逻辑。第一次测试时不要直接上整首曲子。先把一个简单旋律跑通比如前面给的《欢乐颂》片段或《小星星》确认接线和播放框架没问题以后再替换成完整曲目。这样可以避免“哪里都没错但就是不响”时无法定位问题。调试旋律时可以先用Serial.println()打印当前播放的音符频率和时值确认代码走到了预期位置。尤其遇到休止符和长音时打印输出能帮你快速定位是代码问题还是听感问题。批量实验时建议用 USB 供电开发板自带稳压比外部乱接电源安全。桌面音乐盒如果做成长期运行的成品要加一个电源开关并且注意播放音量蜂鸣器持续响会很吵。做一个能长期保存的“曲库管理”方法单独维护一个文本文件每一行写“歌曲名 简谱”用导入工具转换成数组。手动改代码也不是不行但曲目多到十几首以后维护成本明显上升。12. 总结与下一步这个项目最值得尝试的点是用最简单的硬件完整走通“乐谱到音频输出”的链路。写代码之前你以为难点在 Arduino 语法实际操作之后你会发现难点在“怎么把简谱的时值转成数组”这个转变会逼着你去理解音频频率和节拍的本质。最优先验证的功能是先让蜂鸣器响起一个单音然后播放一段短旋律最后再换完整曲子。最容易踩的坑是用了有源蜂鸣器而不自知白白改了半天代码其次是节奏完全不对因为TEMPO和音符时值没有匹配。下一步可以扩展的方向很多给作品加 OLED 显示歌名用按键做切歌把串口点歌界面做成网页或小程序甚至用多个蜂鸣器做简单合奏。这类扩展都不需要重新理解基本原理只要在当前框架上做加法就行。建议把这套“结构体数组 通用播放函数 串口命令选择曲目”的代码保存下来后面做提示音、闹钟、门铃项目时直接复用。整个流程跑通以后评论区点歌就真的只是“换一个数组”的事情了。