如何将编译后的C++项目导出为树莓派3（ARM 32位）可执行文件

问题根源 #

你的程序在目标机器上提示command not found，大概率不是真的找不到文件，核心问题是动态链接库依赖缺失——你本地编译时用了动态链接的wiringPi库，而全新系统的树莓派3B没有安装这个库，导致程序无法加载依赖；另外也可能是文件权限丢失或编译架构不兼容。

解决步骤 #

1. 先排查基础问题 #

• 给目标机器上的可执行文件添加执行权限：

  chmod +x FileName
  

• 确认文件路径和存在性：

  ls -l ./FileName
  

  确保你在正确的目录下执行sudo ./FileName。

2. 静态编译（推荐） #

静态编译会把wiringPi库的代码直接打包进可执行文件，无需目标机器安装依赖库。

• 首先确保你有wiringPi的静态库（.a文件）：
  如果是源码安装的wiringPi，重新编译生成静态库：

  git clone https://github.com/WiringPi/WiringPi.git
  cd WiringPi
  ./build static
  

  静态库会生成在/usr/local/lib/libwiringPi.a。
• 编译你的C++程序时，指定静态链接：

  g++ your_source.cpp -o FileName -static -lwiringPi -lpthread
  

  -static强制静态链接wiringPi，-lpthread是wiringPi依赖的线程库，必须加上。

3. 动态链接+打包依赖库 #

如果静态编译遇到问题（比如某些系统库无法静态链接），可以选择打包动态依赖库：

• 查看本地程序依赖的动态库：

  ldd ./FileName
  

  找到wiringPi相关的库（比如libwiringPi.so.2.50）。
• 编译时指定运行时库路径，让程序从自身目录加载库：

  g++ your_source.cpp -o FileName -lwiringPi -Wl,-rpath='$ORIGIN' -lpthread
  

  -Wl,-rpath='$ORIGIN'告诉程序运行时优先从当前可执行文件所在目录找依赖库。
• 将可执行文件和依赖的libwiringPi.so.*文件一起复制到树莓派3B的同一个目录，直接运行即可。

4. 确保架构兼容性 #

树莓派4B（32位系统）和3B都是ARMv7架构，默认编译选项兼容，但如果你的编译命令加了特定ARMv8优化，需要调整：

g++ your_source.cpp -o FileName -lwiringPi -march=armv7-a -lpthread

-march=armv7-a确保编译出的程序能在所有ARMv7架构的树莓派上运行。

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