Java录音必须用TargetDataLine，需指定AudioFormat、open后start，并在独立线程中read；保存WAV须手动写RIFF头，Swing中应使用SwingWorker避免EDT阻塞。
Java录音用 TargetDataLine 而不是 AudioSystem.getLine() 直接开线程读取
Java标准音频 API 中，录音必须通过 TargetDataLine 获取音频流。它代表“输入设备”的数据通道，不能用 Clip 或 SourceDataLine 替代。常见错误是调用 AudioSystem.getLine() 后没 cast 成 TargetDataLine，或忘记调用 line.open() 就 start —— 这会抛 IllegalStateException。
关键步骤：
- 用
AudioFormat明确指定采样率（如44100）、位深（16）、声道数（1或2），WAV 要求 PCM_SIGNED -
AudioSystem.getTargetDataLine(format)获取 line，检查是否为null（设备不可用时返回 null） - 调用
line.open(format, bufferSize)，bufferSize建议设为format.getFrameSize() * format.getFrameRate() / 10（约 100ms 缓冲） - 必须在单独线程中调用
line.start()后循环line.read(buffer, 0, buffer.length)，主线程阻塞会导致 UI 冻结
保存为 WAV 文件必须手动写 RIFF 头，AudioSystem.write() 不支持实时流
很多人误以为 AudioSystem.write() 能直接把正在录音的 TargetDataLine 写成 WAV —— 它只接受 AudioInputStream，而录音过程是持续写入字节数组，没有现成流。所以必须自己构造 WAV 文件头（44 字节 RIFF/WAVE 格式），再追加原始 PCM 数据。
WAV 头关键字段（小端序）：
立即学习“Java免费学习笔记（深入）”；
- Riff chunk ID：
"RIFF"（4 字节） - 文件总大小 =
36 + dataLength（4 字节，注意：不包含前 8 字节） - Wave chunk ID：
"WAVE"（4 字节） - fmt subchunk：
"fmt "+ 长度16+1（PCM）+ 通道数 + 采样率 + 字节率 + 块对齐 + 位深度 - data subchunk：
"data"+dataLength（4 字节）+ 实际音频字节
漏写或字节序错位会导致 Windows 播放器提示“无法播放此文件”。
Swing 界面需用 SwingWorker 控制录音启停，避免 EDT 阻塞
录音线程和 Swing UI 不能混在同一上下文。点击“开始”就 new Thread().start() 是危险的 —— 如果用户快速连点“开始/停止”，可能触发 line.start() 在已运行状态下调用，抛异常；更糟的是，stop 逻辑若在 EDT 中调用 line.stop() + line.close()，但录音线程还在 read，会引发 IOException 或数据截断。
正确做法：
- 定义一个
volatile boolean isRecording标志位 - 录音线程里用
while (isRecording && line.isOpen())循环读取 - “停止”按钮触发
isRecording = false，再等线程自然退出（不要 interrupt） - 用
SwingWorker<void byte></void>把录音数据异步传给 UI（比如更新波形图），但保存文件操作仍应在 done() 里做
完整可运行示例（精简核心逻辑）
import javax.sound.sampled.*;
import java.io.*;
import java.util.Arrays;
<p>public class SimpleRecorder {
private TargetDataLine line;
private ByteArrayOutputStream audioData = new ByteArrayOutputStream();
private volatile boolean isRecording = false;</p><pre class='brush:java;toolbar:false;'>public void startRecording() throws LineUnavailableException {
AudioFormat format = new AudioFormat(
AudioFormat.Encoding.PCM_SIGNED,
44100, 16, 1, 2, 44100, false);
DataLine.Info info = new DataLine.Info(TargetDataLine.class, format);
if (!AudioSystem.isLineSupported(info)) {
throw new LineUnavailableException("Microphone not supported");
}
line = (TargetDataLine) AudioSystem.getLine(info);
line.open(format, 8192);
line.start();
isRecording = true;
new Thread(() -> {
byte[] buffer = new byte[1024];
while (isRecording && line.isOpen()) {
int bytesRead = line.read(buffer, 0, buffer.length);
if (bytesRead > 0) audioData.write(buffer, 0, bytesRead);
}
try {
saveAsWav(audioData.toByteArray(), "recording.wav");
} catch (IOException e) {
e.printStackTrace();
}
}).start();
}
public void stopRecording() {
isRecording = false;
if (line != null) {
line.stop();
line.close();
}
}
private void saveAsWav(byte[] audioBytes, String filename) throws IOException {
try (DataOutputStream out = new DataOutputStream(new FileOutputStream(filename))) {
// RIFF header
writeString(out, "RIFF");
out.writeInt(36 + audioBytes.length); // file size - 8
writeString(out, "WAVE");
// fmt subchunk
writeString(out, "fmt ");
out.writeInt(16); // subchunk1Size
out.writeShort((short) 1); // audioFormat (PCM)
out.writeShort((short) 1); // channels
out.writeInt(44100); // sampleRate
out.writeInt(44100 * 2); // byteRate
out.writeShort((short) 2); // blockAlign
out.writeShort((short) 16); // bitsPerSample
// data subchunk
writeString(out, "data");
out.writeInt(audioBytes.length);
out.write(audioBytes);
}
}
private void writeString(DataOutputStream out, String s) throws IOException {
for (char c : s.toCharArray()) out.writeByte((byte) c);
}}
这个类可直接集成进 Swing 主窗口，绑定 JButton 的 actionPerformed。注意：真实项目中要加异常弹窗、录音时禁用按钮、支持取消保存等，但 WAV 头构造和线程模型这两处，错一个就录出来打不开。
