JUCE C++ 框架完整指南：从一个窗口到跨平台音频插件

JUCE C++ 框架完整指南：从一个窗口到跨平台音频插件

【免费下载链接】JUCEJUCE is an open-source cross-platform C++ application framework for desktop and mobile applications, including VST, VST3, AU, AUv3, LV2 and AAX audio plug-ins.项目地址: https://gitcode.com/GitHub_Trending/ju/JUCE

JUCE C++ 框架是开源的：一套代码同时写桌面应用、移动应用和 6 种标准格式的音频插件（插件即可以装进 Pro Tools 这类 DAW 数字音频工作站的效果程序）。本文给你一份三阶段路线图，一个下午就能编译出仓库里的演示程序，没有音频背景也能上手。

下面这张海边照片是 JUCE C++ 框架仓库自带的真实资源，供 Graphics 演示使用，运行 GraphicsDemo 时你看到的就是它。

做完之后你手里有什么 📦

跟着走完这篇文章，你手里得到的不是一堆笔记，而是四样能跑起来的东西，每一样都在仓库里有现成入口：

你得到	说明	对应项目模块
跨平台 GUI 应用	同一套代码跑 macOS、Windows、Linux、iOS、Android	examples/CMake/GuiApp/，juce_gui_basics
音频插件	同一份源码编译成 VST3、AU、AAX、LV2 等格式	juce_audio_plugin_client，examples/CMake/AudioPlugin/
插件宿主	加载、测试别人的插件，不依赖商业 DAW	extras/AudioPluginHost/
DSP（数字信号处理）原型	振荡器、滤波器、FFT、失真，开箱即用	juce_dsp，examples/DSP/
两套工程模板	CMake（构建配置工具）与 GUI 工具 Projucer 任选	docs/CMake API.md，extras/Projucer/

产出物是能跑的程序，不是一堆笔记。

它和常见做法差在哪 ⚖️

常见做法是：选一个平台 SDK，只为一个系统写代码；音频和界面各用一套库，互相打通很费劲。JUCE 反过来：界面、窗口、音频 I/O 都是同一个框架里平级的模块（模块是 JUCE 可自由裁剪的子库，用到哪个才链接哪个）：

维度	常见做法	JUCE
技术栈	每个平台一套原生 SDK，或用 JS 类跨端封装	C++17 单一代码库，模块按需开关
目标平台	通常 1-2 个	桌面 3 + 移动 2，外加 6 种插件格式
音频支持	单独的音频库，与界面交互弱	音频与界面同框架，共享事件循环
工程管理	手写构建文件	CMake API 或 Projucer 一键导出工程

一套代码，5 个平台，6 种插件格式。

三阶段路线图：热身 → 主干 → 进阶 🗺️

全程约 4-6 周：热身 1 个周末，主干 2-3 周（每周 10-15 小时），进阶 2-4 周。每阶段都有明确完成标志，你随时知道自己走到哪了。

阶段一 热身：半天编译出演示（1 个周末，3-5 小时）

• 目标：环境就绪，编译并运行仓库自带的 DemoRunner 演示合集。
• 包含：CMake 3.22+ 的安装、克隆仓库（命令在文末）、配置与构建。
• 预计时长：3-5 小时，视机器而定；Linux 用户先按 docs/Linux Dependencies.md 装齐依赖再动手。
• 完成标志：打开 DemoRunner，点一个菜单项，窗口有响应。

cd JUCE cmake . -B cmake-build -DJUCE_BUILD_EXAMPLES=ON -DJUCE_BUILD_EXTRAS=ON cmake --build cmake-build --target DemoRunner

阶段二 主干：GUI 应用 + 第一个插件（2-3 周）

• 目标：读懂官方骨架，做出自己的窗口，并编译、加载出第一个音频插件。
• 包含：juce_core、juce_graphics、juce_gui_basics、juce_gui_extra 四个界面模块，加上 examples/CMake/GuiApp/ 与 examples/CMake/AudioPlugin/ 两个骨架；插件侧走 juce_audio_plugin_client，同一份源码可产出 VST3 或 AU。
• 完成标志：编译出 GuiAppExample 并改掉了主界面文字；AudioPlugin 示例编译后能被宿主加载出声。

cmake --build cmake-build --target GuiAppExample

两个骨架文件夹里的 CMakeLists.txt 每一步都有注释注释，读通一份就懂了整套工程结构。

阶段三 进阶：选一条道走深（2-4 周）

• 目标：选一条道，做出一个能拿得出手的功能。
• 包含（任选一到两条）：DSP 道，juce_dsp + examples/DSP/；宿主道，extras/AudioPluginHost/ 自己写宿主；测试道，extras/UnitTestRunner/ 搭单元测试；无界面道，juce_audio_processors_headless 的 LV2 与无 GUI 场景。
• 完成标志：你加的功能能编译、能过一遍自测，并能用一句话说清楚它做了什么。

节奏完全由你定，完成标志是唯一标尺。

不踩坑的省时技巧 💡

1. 从模板开始，不从空文件开始：整份复制 examples/CMake/GuiApp/ 再改，它的 CMakeLists.txt 每一步都带注释。
2. 配置前先查版本：运行 cmake --version，低于 3.22 会直接卡住；编译端最低要求 C++17，Linux 是 g++ 7.0 或 Clang 6.0。
3. 按目标构建，不做全量构建：加 --target 只编你要的那个演示，比整仓构建快得多，省下的时间够你多读一个模块。
4. 升级前先读 CHANGE_LIST.md：9.0.0 新增 SVG 解析器、可变字体、macOS CoreAudio 新实现，升级前知道改了什么，比升级后调试省时。
5. 卡住时读 CMake API：docs/CMake API.md 列了所有入口函数的参数，比盲猜快得多。
6. 别猜模块依赖：JUCE C++ 框架的 CMake 系统会自动解析模块间依赖，你只需在 CMakeLists 里链接顶层模块（如 juce::juce_gui_extra），其余自动带入。

你可能想问 ❓

Q：我只想写桌面界面应用，需要懂音频吗？A：不需要。界面相关只用 juce_core、juce_graphics、juce_gui_basics、juce_gui_extra 几个模块，不链接就不会编译任何音频代码，从 GuiApp 示例开始即可。

Q：完全免费吗？授权怎么算？A：框架是 AGPLv3（要求衍生作品开源的开源协议）与商业授权双许可：开源分发走 AGPLv3，闭源商业产品走商业授权。全文以 LICENSE.md 为准。

Q：系统要求高吗，老机器跑得动吗？A：编译端最低 C++17、macOS/iOS 需 Xcode 12.4+、Windows 需 Visual Studio 2019+、Linux 需 g++ 7.0 或 Clang 6.0+、Android 需 NDK 26；部署端最低可到 macOS 10.11、Windows 10 1607、iOS 12、Android 7。

Q：Projucer 和 CMake 能一起用吗？A：不冲突，是两条官方路线。Projucer 是 JUCE 的工程配置图形工具（源码在 extras/Projucer/，需自己从仓库源码编译），可导出 Xcode、Visual Studio、Android Studio、Linux Makefile 工程；CMake 是另一条路线。选定一条，保持一致即可。

Q：AAX 插件要签名，新手玩得转吗？A：代码本身能正常编译；但要在商业版 Pro Tools 里运行，需要 Avid 免费提供的 PACE 签名工具，前期测试用 Pro Tools Developer 版本，流程见 README 的 AAX Plug-Ins 一节。

今晚就能开始的 3 步 🚀

1. 克隆仓库（复制即可执行）：

git clone https://gitcode.com/GitHub_Trending/ju/JUCE

2. 回到「阶段一 热身」，按顺序执行那三条配置与构建命令，下午结束前你就能打开 DemoRunner。
3. 把两份文档加进常用标签页：README.md（入门、系统要求、授权入口）和 docs/CMake API.md（CMake 全部入口），以后卡壳先翻这里。

现在把第一条命令贴进终端，下午结束前你手里会有一个能响应鼠标的程序。

【免费下载链接】JUCEJUCE is an open-source cross-platform C++ application framework for desktop and mobile applications, including VST, VST3, AU, AUv3, LV2 and AAX audio plug-ins.项目地址: https://gitcode.com/GitHub_Trending/ju/JUCE