把 FreeRTOS 在本地跑起来：安装与配置实操教程-育师

把 FreeRTOS 在本地跑起来：安装与配置实操教程

【免费下载链接】FreeRTOS'Classic' FreeRTOS distribution. Started as Git clone of FreeRTOS SourceForge SVN repo. Submodules the kernel.项目地址: https://gitcode.com/GitHub_Trending/fr/FreeRTOS

FreeRTOS 是用 C 语言编写的开源实时操作系统内核，采用 MIT 许可，是资源受限嵌入式设备上做多任务调度、任务间通信与定时控制的常见选择。这篇文章带你走完整套 FreeRTOS 安装与配置流程：环境自检、拉取源码、挑选示例、编译并验证结果。读完并按步骤操作后，你应该能独立完成从干净环境到 demo 成功运行的全部设置。

先判断：现在装合适吗

动手前先核对三件事：

你手上有目标硬件板卡，或可用的交叉编译器/仿真器。只打算读源码的话，选能在 PC 上跑的 Windows/Posix 示例即可。
你熟悉git clone、git submodule这类基础 Git 命令。
你清楚一个预期：FreeRTOS 仓库本身是内核加一批示例，不会"装完即跑"，必须选一个匹配你开发环境的示例工程来编译。

三条都不满足时，建议先把板卡和工具链准备好，再回来执行本文。

环境自检

需要确认的点不多，够用就行：

Git 与终端

git --version

能打印出版本号即可。Windows 上建议在 Git Bash 里操作。

目标平台与编译器

确认你的板卡（或仿真器）以及打算用的工具链：GCC、Keil、IAR、MPLAB 等。Demo 示例目录下的目录名基本遵循"架构_板卡_编译器"的命名，例如CORTEX_M4F_STM32F407ZG-SK、ARM7_LPC2106_GCC，直接看目录名就能对上号。

IDE 或 Makefile

进入示例目录看顶层文件：有Makefile的通常用make编译；带.uvprojx、.ewp等工程文件的，用对应 IDE 打开。以目录内实际文件为准。

拉取源码

⚠️ 关键点：这个仓库用 Git 子模块管理内核等依赖组件。克隆时必须带上子模块参数，否则本该有源码的目录会是空的。

git clone --recurse-submodules https://gitcode.com/GitHub_Trending/fr/FreeRTOS

--recurse-submodules的作用是一次性下载仓库引用的全部子模块内容，包括内核、网络与协议等附加库。

如果克隆时忘了加这个参数，或中途失败导致内容不完整，进目录补拉即可：

cd FreeRTOS git submodule update --init --recursive

执行完成后，FreeRTOS/Source/目录下应该能看到内核源码文件。仍然为空，就重新执行上面的 submodule 命令。

Windows 用户的特殊处理

仓库包含符号链接，Windows 上需先允许 Git 创建它们：

git config --global core.symlinks true

若仍报权限错误，用管理员权限终端执行，或在系统中开启"开发者模式"。否则 Git 会把符号链接写成包含目标路径的普通文本文件。

选择示例工程

FreeRTOS/Demo/下覆盖了大量硬件与工具链组合，不必逐一看，按三轴筛选：

硬件架构与板卡：先看目录前缀，如CORTEX_M0_...、AVR_...、RISC-V_...。
编译器：后缀通常标明工具链，如_GCC、_IAR、_Keil、_MPLAB。
IDE 类型：目录里有 Makefile 就走命令行编译；有工程文件就用对应 IDE 打开。

确定工程后，先读该目录内的 README，里面写明了该平台的构建与下载方式。

配置与编译要点

各示例之间的差异主要集中在四处：

编译器路径：Makefile 或 IDE 中指定的工具链必须已安装，且在PATH中。
目标硬件参数：内核型号、时钟等通常已配置好；若你的板卡与示例不同，需自行核对修改。
工程文件：部分工程用make构建，部分必须在 IDE 中打开后编译。
FreeRTOSConfig.h：节拍频率、堆栈大小、堆分区等宏配置，先用示例默认值，别一开始就改。

配置完成后按工程说明编译。成功的标志是构建通过，并产出可烧录的固件文件（.hex/.bin 等，具体形态因平台而异）。

验证与排错

配置成功的直接信号：编译通过，demo 烧录后能观察到预期行为，例如 LED 闪烁、串口周期性输出。

卡住时对照这几个高频问题：

FreeRTOS/Source/是空的——子模块没拉下来，执行git submodule update --init --recursive。
Windows 下符号链接变成文本文件——执行git config --global core.symlinks true后，用管理员权限重新克隆。
找不到编译器——核对 Makefile 或 IDE 中的工具链路径与PATH。
链接报错、符号未定义——头文件包含路径或链接脚本缺失，检查工程是否完整收录了示例的源文件与包含目录。
程序烧录后无响应——先确认节拍中断是否启用，再核对FreeRTOSConfig.h中时钟与节拍频率是否与实际板卡一致。