JUCE能可靠构建跨平台音频插件和独立应用，但必须严格遵循其项目结构、构建配置及音频线程处理约定，否则将导致各平台音频异常；Projucer是必需元构建工具，需正确启用Audio Plugin Client模块、选择对应Target类型并分别配置AU/VST3/AAX导出选项；processBlock()中严禁阻塞操作与动态内存分配，参数更新须通过AudioProcessorValueTreeState，非实时任务应移交后台线程；各平台权限与签名要求（如macOS Hardened Runtime、Windows ASIO初始化顺序、Linux ALSA用户组）必须显式满足。
JUCE 能可靠地构建跨平台音频插件（VST3/AU/AAX）和独立应用，但前提是项目结构、构建配置和音频线程处理必须严格遵循其约定——偏离会导致 macOS 音频卡顿、Windows 插件加载失败或 Linux ALSA 权限异常。
初始化 Projucer 并生成正确 Target
Projucer 是 JUCE 项目的元构建工具，不是可选辅助；直接手写 CMakeLists.txt 或 Xcode/VS 工程极易遗漏音频后端绑定。生成时必须确认以下三项：
-
Audio Plugin Client模块在Modules页中已启用（否则JucePluginCharacteristics.h不生成） - Target 类型选
Audio Plugin或Standalone Application，不能混用；同一项目不可同时导出为插件+独立版，需建两个 Target - macOS 的
Audio Unit和VST3必须分别勾选，AU 需额外开启Enable Audio Unit Extensions，否则无法通过 App Store 审核
音频回调中的线程安全与实时约束
processBlock() 运行在高优先级音频线程，任何阻塞、动态内存分配或 GUI 调用都会导致 xruns（爆音）。JUCE 不自动保护该函数，需手动规避：
- 禁止调用
new/delete、std::vector::resize()、juce::String构造 —— 预分配缓冲区，用juce::AudioBuffer管理音频数据 - 参数更新必须走
AudioProcessorValueTreeState+ParameterID，而非直接读取 UI 控件值；UI 改变参数时调用setValueNotifyingHost() - 如需执行非实时任务（如文件读写、FFT 分析），用
juce::ThreadPool或juce::Timer拖到后台线程，绝不可在processBlock()中wait()
插件格式兼容性关键配置
不同宿主对插件二进制格式和符号导出要求差异极大，常见失败点集中在链接层：
- VST3：必须导出
GetPluginFactory()符号，Projucer 会自动生成；若手动修改JucePluginCharacteristics.h中的JucePlugin_Name，需同步更新info.plist（macOS）或module.def（Windows）中的模块名 - AU：macOS 12+ 强制要求签名 + Hardened Runtime，Projucer 导出时勾选
Enable Hardened Runtime，且证书需含audio-unit权限 - AAX：仅支持 Windows/macOS，需 Avid 提供的 SDK 路径填入 Projucer 的
AAX SDK Path字段；调试时宿主（Pro Tools）必须运行在与插件相同的架构（Intel/Apple Silicon）下
独立应用的音频设备选择与权限
独立版不是“插件套个窗口”，其音频 I/O 行为由 AudioDeviceManager 控制，且各平台权限模型不同：
- macOS：首次启动会弹系统麦克风权限框，但若
Info.plist缺少NSMicrophoneUsageDescription，弹窗直接失败并静默禁用输入 - Windows：ASIO 需用户手动选择驱动，但默认不启用；必须在代码中调用
deviceManager->addAudioCallback (this)后，再deviceManager->setAudioDeviceSetup()指定 ASIO 设备，否则回退到 WASAPI 低性能模式 - Linux：ALSA 设备名（如
hw:0,0）需硬编码传入setAudioDeviceSetup()，udev 规则未配置时普通用户无权访问/dev/snd/，需加audio用户组或改规则
void AudioProcessorPlayer::audioDeviceIOCallback (const float** inputChannelData,
int numInputChannels,
float** outputChannelData,
int numOutputChannels,
int numSamples) noexcept
{
// ✅ 正确：只做纯计算，buffer 复用
juce::dsp::ProcessContextReplacing context (*getMainBusBuffer());
processor.process (context);
// ❌ 错误：此处 new、File::loadFileAsData、AlertWindow::showMessageBoxAsync 都会崩溃
}
跨平台音频开发最难的部分不在 API 调用，而在每个平台对“实时性”的物理定义不同：macOS Core Audio 要求回调在 5ms 内完成，Windows WASAPI 共享模式容忍 20ms，而 Linux JACK 可能要求 sub-millisecond 精度。JUCE 封装了这些，但没封装你的算法复杂度。
