Pico SDK编译报‘error: unknown directive’的原因及CMake编译器配置问题

问题原因 #

编译Pico SDK的汇编代码时，CMake错误使用了AppleClang而非ARM交叉编译器arm-none-eabi-gcc，导致汇编指令无法识别，出现unknown directive、unknown CPU name等报错。

解决方案 #

1. 运行CMake时直接指定编译器路径 #

在cmake命令中显式指定C、C++和汇编编译器的路径，替换为你实际安装的arm-none-eabi工具链路径：

cmake .. \
-DCMAKE_C_COMPILER=/usr/local/bin/arm-none-eabi-gcc \
-DCMAKE_CXX_COMPILER=/usr/local/bin/arm-none-eabi-g++ \
-DCMAKE_ASM_COMPILER=/usr/local/bin/arm-none-eabi-gcc

注：如果通过Homebrew安装工具链，默认路径通常是/usr/local/bin/arm-none-eabi-xxx，可通过which arm-none-eabi-gcc命令查看实际路径。

2. 调整环境变量优先找到交叉编译器 #

将arm-none-eabi工具链的bin目录添加到系统PATH最前面，让CMake优先选择交叉编译器：

export PATH=/usr/local/bin:$PATH

执行上述命令后，删除原build目录，重新运行cmake ..即可。

3. 使用Pico SDK自带的工具链文件（推荐） #

Pico SDK提供了预配置的工具链文件，直接指定该文件即可自动配置交叉编译环境：

cmake .. -DCMAKE_TOOLCHAIN_FILE=/path/to/pico-sdk/cmake/preload/toolchains/arm-none-eabi-gcc.cmake

注：替换/path/to/pico-sdk为你本地Pico SDK的实际安装路径。

额外注意事项 #

• 确保已正确安装ARM交叉编译工具链，Mac上可通过brew install arm-none-eabi-gcc完成安装。
• 执行干净构建：删除之前生成的build目录，再重新运行cmake命令，避免旧缓存影响编译器检测结果。

内容的提问来源于stack exchange，提问作者Berik