使用Yocto工具链子shell构建Qt项目时CMake执行失败

核心原因 #

问题出在Bash的启动模式差异：

• 直接进入的容器shell是交互式shell，会自动加载~/.bashrc，其中的source /opt/.../environment-setup-...语句能正确初始化Yocto工具链环境。
• 而/bin/bash -c '...'或docker exec启动的是非交互式shell，默认情况下Bash不会加载~/.bashrc——如果你的~/.bashrc开头有Ubuntu默认的[ -z "$PS1" ] && return判断（非交互式shell无PS1变量），会直接跳过后续所有配置，包括Yocto工具链的source操作。

你提到“父shell和子shell环境变量完全一致”，大概率是对比时的操作误差（比如手动在子shell中source了.bashrc再查看env），实际非交互式子shell并未加载工具链环境。

排查步骤 #

1. 验证非交互式shell是否加载了.bashrc：
   在容器中执行：

   /bin/bash -c 'echo $PATH'
   

   对比父shell的echo $PATH，如果子shell的PATH未包含Yocto工具链的路径（比如/opt/my-distro/2.5.3/sysroots/x86_64-pokysdk-linux/usr/bin/aarch64-poky-linux），则证明.bashrc未被加载。
2. 检查.bashrc开头的条件判断：
   查看~/.bashrc第一行附近是否有类似：

   # If not running interactively, don't do anything
   [ -z "$PS1" ] && return
   

   这行代码会导致非交互式shell直接退出.bashrc，不执行后续的source语句。

解决方法 #

方法1：修改.bashrc跳过交互式判断 #

将source /opt/my-distro/2.5.3/environment-setup-aarch64-poky-linux语句移到.bashrc开头的交互式判断之前，比如：

# 先加载Yocto工具链，再处理交互式判断
source /opt/my-distro/2.5.3/environment-setup-aarch64-poky-linux

# If not running interactively, don't do anything
[ -z "$PS1" ] && return
# ... 后续原有.bashrc内容

方法2：执行cmake时手动加载工具链 #

在子shell命令中显式source工具链脚本，再执行cmake：

/bin/bash -c 'source /opt/my-distro/2.5.3/environment-setup-aarch64-poky-linux && cmake /src'

Azure流水线中直接用这个命令替换原有的cmake调用即可。

方法3：强制子shell加载.bashrc #

使用bash --rcfile参数指定加载.bashrc，确保非交互式shell也能加载配置：

/bin/bash --rcfile ~/.bashrc -c 'cmake /src'

方法4：全局配置工具链（适合容器环境） #

将source工具链的语句放到/etc/bash.bashrc（全局bash配置），这样所有bash实例（无论交互/非交互）都会自动加载：

echo "source /opt/my-distro/2.5.3/environment-setup-aarch64-poky-linux" >> /etc/bash.bashrc

为什么qmake没有问题？ #

qmake直接依赖环境变量（比如QT_DIR、PATH），如果你的qmake调用是在已经加载工具链的环境中执行的，或者qmake本身被Yocto工具链的环境正确指向；而CMake的交叉编译依赖工具链脚本设置的一系列变量（比如CMAKE_SYSROOT、CMAKE_C_COMPILER等），这些变量是通过source工具链脚本时自动注入的，非交互式shell未加载脚本时，CMake无法自动识别这些参数。

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