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把录音数据异步传给 UI（比如更新波形图），但保存文件操作仍应在 done() 里做
完整可运行示例（精简核心逻辑）
import javax.sound.sampled.*; import java.io.*; import java.util.Arrays;public class SimpleRecorder { private TargetDataLine line; private ByteArrayOutputStream audioData = new ByteArrayOutputStream(); private volatile boolean isRecording = 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 头构造和线程模型这两处，错一个就录出来打不开。
