给项目加一块掉电不丢的存储,SD 卡是最省事的答案。几十块的开发板配一个十几块的 SPI 卡座板,就能把传感器数据写成文件、拔下来带走,跟树莓派拿它当硬盘是一个思路。不过这块小板子接上去容易,卡认不认、格式化对不对,坑都藏在看不见的地方。这次把 MicroSD 卡模块接 Arduino 的完整链路拆一遍:电平转换怎么过、四根 SPI 线怎么排、文件系统挑哪种、代码跑起来是什么效果。

一、先分清卡:FAT16/FAT32/exFAT 的分界线
SD 卡是 1999 年 8 月由 SanDisk、松下、东芝三家联手推出的,2000 年 1 月这三家成立了 SD 协会来定标准。常见规格里,SD/SDSC 是标准容量卡,上限 2GB,早期卡用 FAT16 文件系统,后来的用 FAT32;SDHC 是高容量卡,2GB 到 32GB,同样走 FAT32;SDXC 是扩展容量卡,32GB 起步到 2TB,文件系统换成了 exFAT;再往上还有 2TB 到 128TB 的 SDUC。miniSD 这种中间规格 2008 年之后就停产了,不用考虑。
速度标识也要看清。老的 Class 1 到 Class 10 分级,现在随便一张正经卡都能跑赢,基本失去参考价值;SDHC/SDXC 卡可以走 UHS 总线,UHS-I 的速率是 50 到 104 MB/s,UHS-II 156 MB/s,UHS-III 312 到 624 MB/s,最新的 SD Express 规格能到 985 MB/s。但 Arduino 总线本身就跑不快,这些上限一张也吃不满,买卡别为速度等级多花一分钱。
结论先给:给 Arduino 选卡就认 SDHC,2GB 到 32GB、FAT32 格式、Class 10 足够。SDXC 的 exFAT 文件系统 Arduino SD 库不认,卡插上去初始化直接失败,这是新手翻车最多的一步。

二、电平转换是分水岭:两种模块两种接法
SD 卡本体是 3.3V 逻辑器件,标准 SD 卡走 SPI 总线;SDHC/SDXC 还能切到 one-bit SD 总线,那种模式下工作电压降到 1.8V。microSD 卡和标准 SD 卡电气兼容,只是引脚排布不同,卡包装里附的塑料 SD 转接卡干的就是重新排线这件事。
市面上的卡座板分两类,这里别踩。全尺寸 SD 卡模块很多不带电平转换,板上的稳压器只负责把 5V 供电降到 3.3V,逻辑信号仍然按 3.3V 算,接 Uno、Mega 这类 5V 逻辑板要自己补电平转换芯片或者电阻分压阵列,否则读出来的数据是乱码。microSD 模块则反过来,板载电平转换加稳压器,天生为 5V 逻辑准备,只留一个 5V 电源输入,Uno 直插就能用。

四根线照着接 Uno:MOSI 接 11,MISO 接 12,SCK 接 13,CS 接 4。换 Mega 引脚全变:MISO 50、MOSI 51、SCK 52、CS 53。CS 理论上可以用任意数字脚,代码里对应改就行。用带 SD 卡座的扩展板要留个心眼,有些板子把 CS 固定在 6 脚或 10 脚,查不到资料就拿万用表量一下走线。
| SPI 信号 | Arduino Uno | Arduino Mega |
|---|---|---|
| MISO | 12 | 50 |
| MOSI | 11 | 51 |
| SCK | 13 | 52 |
| CS | 4(可换其他脚) | 53(可换其他脚) |
三、SD 库的三条规矩:格式、文件名、目录
Arduino IDE 自带的 SD 库支持 SDSC 和 SDHC 卡上的 FAT16、FAT32 两种文件系统,exFAT 明确不在支持列表里,重新格式化卡的时候千万别顺手选成 exFAT。第二条规矩是文件名沿用老的 8.3 约定:主名不超过 8 个字符,扩展名最多 3 个字符,TESTFILE.TXT 合法,MYNICEFILE.FILE 这种不行。第三条,需要目录就在路径里用正斜杠分隔,例如 /LOG/DATA.TXT。
我的习惯是格式化在电脑上做完再插到模块上,写完的数据也拔下来直接在电脑上读,FAT32 双向通用,省去中间环节变量。

四、ReadWrite 实测:写入、追加、读回
官方示例 ReadWrite 是最短的完整闭环,IDE 里从 File 菜单的 Examples 找到 SD 分组就能打开。核心三步:SD.begin(4) 用 CS 脚 4 初始化,失败就停在死循环里报错;SD.open("test.txt", FILE_WRITE) 打开文件写入一行,写完必须 close,SD 库一次只能开一个文件;然后不带参数重新 SD.open("test.txt") 只读打开,逐字节吐给串口监视器。
/*
SD card read/write
This example shows how to read and write data to and from an SD card file
The circuit:
* SD card attached to SPI bus as follows:
** MOSI - pin 11
** MISO - pin 12
** CLK - pin 13
** CS - pin 4 (for MKRZero SD: SDCARD_SS_PIN)
created Nov 2010
by David A. Mellis
modified 9 Apr 2012
by Tom Igoe
This example code is in the public domain.
*/
#include "SPI.h"
#include "SD.h"
File myFile;
void setup() {
// Open serial communications and wait for port to open:
Serial.begin(9600);
while (!Serial) {
; // wait for serial port to connect. Needed for native USB port only
}
Serial.print("Initializing SD card...");
if (!SD.begin(4)) {
Serial.println("initialization failed!");
while (1);
}
Serial.println("initialization done.");
// open the file. note that only one file can be open at a time,
// so you have to close this one before opening another.
myFile = SD.open("test.txt", FILE_WRITE);
// if the file opened okay, write to it:
if (myFile) {
Serial.print("Writing to test.txt...");
myFile.println("testing 1, 2, 3.");
// close the file:
myFile.close();
Serial.println("done.");
} else {
// if the file didn't open, print an error:
Serial.println("error opening test.txt");
}
// re-open the file for reading:
myFile = SD.open("test.txt");
if (myFile) {
Serial.println("test.txt:");
// read from the file until there's nothing else in it:
while (myFile.available()) {
Serial.write(myFile.read());
}
// close the file:
myFile.close();
} else {
// if the file didn't open, print an error:
Serial.println("error opening test.txt");
}
}
void loop() {
// nothing happens after setup
}FILE_WRITE 有个行为值得记住:文件不存在就新建,存在则在末尾追加。实测每按一次 Uno 的复位键,串口监视器就多一行 testing 1, 2, 3.,数据是一次次追加而不是覆盖。不想堆行就改成先删后建。

五、DataLogger 实测与选卡建议
DataLogger 示例把 A0、A1、A2 三路模拟量读数写进卡里,是不带时间戳的极简记录仪,要时间戳就得自己加 RTC 模块。接线在三个电位器上,拧动旋钮,卡里的数值跟着变,拔下来在电脑上打开就是一列列原始读数,DumpFile 示例可以把卡里的文件原样倒回串口核对。


最后给结论。卡选 SDHC、容量 16GB 或 32GB、FAT32 格式化;模块选带电平转换的 microSD 卡座板,Uno、Mega 直插四根线搞定。全尺寸 SD 卡座板更便宜,但多半没有电平转换,配 5V 板要额外补转换芯片,这笔账要算进去。UHS-II、SD Express 这类高速卡的钱花在 Arduino 上是浪费,慢总线吃不到;省下的预算拿去买靠谱品牌的卡更实际,劣质卡坏一次文件就够喝一壶。截至 2026 年 11 月,这类模块电商价格仍在十几元一档,入门成本几乎可以忽略。











FILE_WRITE追加这个细节太真实了,我当时还以为程序出bug了怎么每复位一次多一行,原来是特性哈哈。
想问下8.3文件名这条是对所有SD库版本都生效吗?之前写个长文件名好像也能建出来,就是电脑上看着名字怪怪的。
电平转换这段写得好,网上很多便宜的全尺寸SD卡座真没带转换芯片,接5V板读出来全是乱码,血泪教训。
这波总结到位,第一次给Uno接卡座就是被exFAT坑的,卡在电脑上好好的,插模块上初始化直接失败,重格成FAT32才救回来。