RTX 4060双系统下Ubuntu 20.04UE4.27Airsim环境搭建避坑指南附545驱动配置最近不少朋友换了新机器尤其是搭载了RTX 4060这类新显卡的笔记本想在双系统环境下搞点有意思的开发比如用AirSim做无人机仿真再结合ROS搞点机器人研究。想法很美好但真动手时从显卡驱动到双系统引导再到UE4和AirSim的编译每一步都可能踩坑。我自己也是从一堆黑屏、报错和莫名其妙的依赖问题里爬出来的这篇指南就想把这些“坑”和“填坑”的经验系统地分享给同样在路上的你。我们主要面向使用RTX 4060显卡希望在Windows和Ubuntu 20.04双系统环境下搭建起UE4.27和AirSim开发环境的开发者。整个过程会涉及BIOS设置、NVIDIA驱动安装、双系统兼容性调整以及一系列编译和配置的细节。准备好了吗我们开始。1. 双系统与显卡驱动的基石BIOS与NVIDIA 545驱动在RTX 4060上安装Ubuntu第一步往往不是插U盘而是进BIOS。很多新电脑尤其是游戏本为了平衡性能和续航会采用混合显卡模式比如NVIDIA Optimus。这种模式在Windows下工作良好但在Linux下尤其是需要直接调用GPU进行图形渲染和计算的场景比如UE4就可能造成黑屏、无法识别独显等问题。核心操作将显卡模式从“混合”切换到“独显直连”这个选项在BIOS里的名称可能因品牌而异常见的有Graphics Mode、Display Mode、GPU Configuration等。你需要找到并设置为Discrete Graphics、dGPU Only或类似的选项。以我手头的暗影精灵为例步骤大致如下重启电脑在开机Logo出现时反复按F10不同品牌可能是F2、Del等进入BIOS设置界面。使用方向键导航到Configuration或Advanced选项卡。找到Graphics或Display相关设置。将Graphics Mode从Hybrid或Switchable改为Discrete。保存并退出通常是F10然后选择Yes。完成这一步后系统在启动时就会直接使用RTX 4060为后续驱动安装和UE4运行扫清了一个大障碍。接下来是驱动。对于RTX 40系显卡特别是较新的型号Ubuntu 20.04自带的驱动仓库可能版本较旧无法完美支持。因此我们选择直接从NVIDIA官方安装最新的驱动。545版本驱动在RTX 4060上的兼容性和稳定性表现不错。安装NVIDIA 545驱动步骤首先我们需要禁用系统自带的nouveau开源驱动因为它会与官方驱动冲突。# 打开黑名单配置文件 sudo nano /etc/modprobe.d/blacklist-nouveau.conf在打开的文件中添加以下两行内容blacklist nouveau options nouveau modeset0保存并退出按CtrlX然后按Y最后回车。接着更新内核初始化文件并重启sudo update-initramfs -u sudo reboot重启后按CtrlAltF3进入文本终端tty3登录你的账户。然后停止图形界面服务sudo service gdm3 stop # 如果你用的是Ubuntu默认的GDM也可能是lightdm现在添加NVIDIA官方驱动PPA并安装# 添加PPA sudo add-apt-repository ppa:graphics-drivers/ppa sudo apt update # 安装545版本驱动 sudo apt install nvidia-driver-545安装完成后重启系统sudo reboot重启进入桌面后打开终端输入nvidia-smi。如果看到类似下面的输出显示你的RTX 4060和驱动版本为545.xx那么恭喜你驱动安装成功了。--------------------------------------------------------------------------------------- | NVIDIA-SMI 545.29.06 Driver Version: 545.29.06 CUDA Version: 12.3 | |------------------------------------------------------------------------------------- | GPU Name Persistence-M | Bus-Id Disp.A | Volatile Uncorr. ECC | | Fan Temp Perf Pwr:Usage/Cap | Memory-Usage | GPU-Util Compute M. | | | | MIG M. | || | 0 NVIDIA GeForce RTX 4060 ... Off | 00000000:01:00.0 On | N/A | | N/A 52C P8 10W / N/A | 200MiB / 8192MiB | 0% Default | | | | N/A | -------------------------------------------------------------------------------------注意安装驱动后如果遇到循环登录或黑屏可以尝试在GRUB引导时在Linux内核行末尾添加nomodeset参数临时进入系统然后检查驱动安装日志/var/log/nvidia-installer.log寻找线索。2. UE4.27 源码编译耐心与细节的考验有了稳定的驱动我们就可以着手构建仿真环境的核心——Unreal Engine 4.27。虽然Epic Games提供了启动器但对于AirSim这类需要源码集成的项目从GitHub克隆并编译源码是更可靠的方式。这个过程耗时较长取决于你的CPU和SSD速度可能需要1-3小时且对网络稳定性有一定要求。首先确保你的系统满足基本的编译依赖。打开终端执行以下命令安装必要工具和库sudo apt update sudo apt install build-essential git cmake python3 python3-pip clang-12 lld-12 libxinerama-dev libxcursor-dev libxrandr-dev libfreetype6-dev libglew-dev libglm-dev libopenal-dev libogg-dev libvorbis-dev libssl-dev libudev-dev libx11-dev libxcb-icccm4-dev libxcb-image0-dev libxcb-keysyms1-dev libxcb-randr0-dev libxcb-render-util0-dev libxcb-shape0-dev libxcb-sync-dev libxcb-xfixes0-dev libxcb-xinerama0-dev libxcb-xkb-dev libxkbcommon-dev libxkbcommon-x11-dev接下来我们需要获取UE4的源代码。访问Epic Games的GitHub仓库https://github.com/EpicGames/UnrealEngine你需要有一个关联了Epic账户的GitHub账号并接受邀请才能访问。克隆仓库注意这是一个巨大的仓库约30GB# 进入你准备存放UE4源码的目录例如 ~/Development cd ~/Development git clone --depth 1 --branch 4.27 https://github.com/EpicGames/UnrealEngine.git cd UnrealEngine克隆完成后运行附带的设置脚本它会下载一些额外的二进制组件./Setup.sh这个步骤会下载约8GB的数据请保持网络通畅。完成后开始编译引擎./GenerateProjectFiles.sh makemake命令是编译的主体会占用大量CPU和内存。你可以通过-j参数指定并行编译的线程数以加快速度例如make -j 8假设你的CPU有8个逻辑核心。编译过程中终端会输出大量信息只要没有出现红色的错误Error并停止就让它安心运行。提示编译过程非常消耗资源建议关闭不必要的应用程序。如果内存不足例如小于16GB可能会在链接阶段因内存溢出OOM而失败此时可以尝试减少-j参数的值或者增加系统的交换空间swap。编译成功后你会在Engine/Binaries/Linux目录下找到UnrealEditor可执行文件。为了便于启动可以创建一个桌面快捷方式或别名。一个简单的方法是在~/.bashrc文件末尾添加别名alias ue4-editor~/Development/UnrealEngine/Engine/Binaries/Linux/UnrealEditor保存后执行source ~/.bashrc之后在终端输入ue4-editor即可启动UE4编辑器。首次启动会进行着色器编译等初始化工作稍等片刻即可看到熟悉的虚幻引擎编辑器界面。3. AirSim 集成与项目配置解决“打不开”的魔咒AirSim是微软开源的无人机、汽车仿真平台它作为UE4的一个插件存在。将其成功集成到我们刚编译好的UE4.27中是搭建仿真环境的关键一步。很多人在这里会遇到项目文件如经典的Blocks.uproject无法打开的问题报错信息五花八门比如“缺少模块”或“null codes”。正确的集成路径如下首先克隆AirSim的源码到本地。建议选择一个与UE4源码目录同级或独立的路径不要放在UE4目录内部。cd ~/Development git clone https://github.com/microsoft/AirSim.git cd AirSimAirSim需要用到rpclib和MavLinkCom等子模块使用以下命令更新git submodule update --init --recursive接下来是为UE4构建AirSim插件。AirSim提供了一个非常方便的构建脚本。在AirSim根目录下执行./setup.sh ./build.shbuild.sh脚本会自动检测你的UE4安装路径。如果它没有正确找到比如你自定义了UE4源码路径你可能需要手动指定。脚本运行后它会在AirSim/Unreal/Plugins目录下生成编译好的插件文件。现在我们准备用AirSim创建一个UE4项目。最简单的方法是使用它自带的示例项目。进入AirSim/Unreal/Environments目录你会看到Blocks等项目文件夹。我们需要将编译好的插件复制到这些项目中。# 假设你的AirSim在 ~/Development/AirSim # 进入Blocks项目目录 cd ~/Development/AirSim/Unreal/Environments/Blocks # 将插件文件夹链接或复制到项目的Plugins目录 ln -s ~/Development/AirSim/Unreal/Plugins Plugins # 或者使用复制命令 # cp -r ~/Development/AirSim/Unreal/Plugins ./关键一步修复项目文件直接双击Blocks.uproject很可能失败。这是因为项目文件需要“升级”或“重新生成”以匹配你的UE4.27引擎版本。我们需要使用命令行工具来完成这个操作。首先找到你编译好的UE4引擎的Engine/Binaries/Linux目录下的UnrealBuildTool和UE4Editor相关路径。更简单的方法是使用UE4自带的命令行工具来重新生成项目文件# 进入Blocks项目目录 cd ~/Development/AirSim/Unreal/Environments/Blocks # 使用绝对路径指向UE4的GenerateProjectFiles脚本 # 将 /path/to/your/UnrealEngine 替换为你的实际路径例如 ~/Development/UnrealEngine /path/to/your/UnrealEngine/GenerateProjectFiles.sh -projectpwd/Blocks.uproject -game -engine这个命令会重新解析.uproject文件并生成所需的Visual Studio或Xcode项目文件在Linux下主要是Makefile。完成后再次尝试通过ue4-editor Blocks.uproject命令或在文件管理器中双击打开项目。如果遇到关于“IDE”或“null codes”的错误一个常见的解决方案是手动编辑Blocks.uproject文件用文本编辑器打开确保其EngineAssociation字段指向正确的引擎版本。对于从源码编译的引擎这个值可能是一个特定的哈希值。一个更稳妥的办法是先直接用UE4编辑器创建一个空白的C项目然后将AirSim的Plugins文件夹和Content下的资产复制过去再重新编译。4. ROS Noetic 与 AirSim ROS 节点的联姻对于机器人开发者来说仿真的价值在于能与ROS机器人操作系统通信从而测试算法。Ubuntu 20.04对应的ROS发行版是Noetic Ninjemys。我们先搭建基础的ROS环境再集成AirSim的ROS节点。安装ROS Noetic按照ROS官方Wiki的步骤进行以下是精简版# 设置软件源 sudo sh -c echo deb http://packages.ros.org/ros/ubuntu $(lsb_release -sc) main /etc/apt/sources.list.d/ros-latest.list # 添加密钥 sudo apt install curl curl -s https://raw.githubusercontent.com/ros/rosdistro/master/ros.asc | sudo apt-key add - # 安装完整版ROS包含ROS、rqt、rviz等 sudo apt update sudo apt install ros-noetic-desktop-full # 初始化rosdep sudo rosdep init rosdep update # 设置环境变量每次打开新终端都需要建议写入.bashrc echo source /opt/ros/noetic/setup.bash ~/.bashrc source ~/.bashrc安装ROS编译工具和依赖推荐使用catkin_tools作为构建工具它比传统的catkin_make更友好。同时安装一些AirSim ROS节点需要的依赖。# 安装python3的catkin_tools sudo apt install python3-osrf-pycommon python3-catkin-tools # 安装必要的ROS包 sudo apt install ros-noetic-tf2-sensor-msgs ros-noetic-tf2-geometry-msgs ros-noetic-mavros*构建AirSim ROS节点现在我们为AirSim构建ROS工作空间和节点。# 创建ROS工作空间 mkdir -p ~/airsim_ros_ws/src cd ~/airsim_ros_ws/src # 克隆AirSim ROS节点代码 git clone https://github.com/microsoft/AirSim.git # 注意这里克隆的是整个AirSim仓库但我们只需要其中的ROS部分 # 实际上更清晰的做法是直接使用AirSim源码目录下的ros文件夹 # 假设你的AirSim源码在 ~/Development/AirSim可以这样操作 # cd ~/airsim_ros_ws/src # ln -s ~/Development/AirSim/ros ./airsim_ros # 我们这里按标准流程来先克隆再选择正确的分支/目录 cd AirSim git checkout ros # 切换到ros分支如果存在或者直接使用master分支下的ros目录实际上AirSim的ROS节点位于其主仓库的ros文件夹内。更高效的做法是直接从你的AirSim源码目录链接过来# 回到工作空间的src目录 cd ~/airsim_ros_ws/src # 删除刚才克隆的整个仓库如果克隆了的话 rm -rf AirSim # 创建指向ros文件夹的符号链接 ln -s ~/Development/AirSim/ros ./airsim_ros接下来解决一个常见的编译依赖问题empy。这是一个Python模板库版本不兼容会导致catkin build失败。# 确保使用pip3安装指定版本的empy pip3 install empy3.3.2现在使用catkin build构建工作空间cd ~/airsim_ros_ws catkin buildcatkin build会自动配置并编译src目录下的所有包。如果一切顺利你会看到成功的构建日志。最后别忘了source一下新生成的环境设置source ~/airsim_ros_ws/devel/setup.bash # 同样可以将这行添加到 ~/.bashrc 中永久生效5. 联合仿真实战让无人机在RViz中飞起来环境全部就绪是时候让所有部件联动起来了。联合仿真的流程可以概括为启动UE4仿真环境 - 启动AirSim ROS节点 - 在ROS中发送控制指令或使用RViz可视化。第一步启动UE4仿真环境打开终端导航到你的AirSim项目例如Blocks目录。使用命令启动UE4编辑器并加载项目ue4-editor Blocks.uproject。在UE4编辑器中点击工具栏的“播放”Play按钮。此时你应该能看到一个简单的方块世界并且窗口标题会显示“AirSim: Blocks”。保持这个窗口运行。第二步配置并启动AirSim ROS节点AirSim ROS节点需要知道如何连接到UE4中的仿真器。这通过一个ROS参数文件settings.json来配置。首先在AirSim ROS包的config目录下找到或创建一个settings.json文件。一个基本的配置示例如下{ SettingsVersion: 1.2, SimMode: Multirotor, LocalHostIp: 127.0.0.1, ApiServerPort: 41451, ViewMode: SpringArmChase, ClockSpeed: 1.0, Vehicles: { Drone1: { VehicleType: SimpleFlight, X: 0, Y: 0, Z: 0 } } }这个配置将仿真模式设为多旋翼无人机Multirotor并创建了一架名为“Drone1”的无人机。将该文件保存为~/airsim_ros_ws/src/airsim_ros/config/settings.json。现在在一个新的终端窗口中启动AirSim ROS节点# 确保已经source了工作空间环境 source ~/airsim_ros_ws/devel/setup.bash # 启动主节点 roslaunch airsim_ros_pkgs airsim_node.launch如果一切正常这个终端会开始输出一些状态信息并且不会报错退出。同时你应该能在ROS系统中看到新的话题topics和服务services例如/airsim_node/Drone1/odom_local_ned无人机位姿、/airsim_node/Drone1/imu惯性测量数据等。第三步使用RViz进行可视化再打开一个新的终端启动RViz并加载一个针对AirSim配置好的RViz配置文件。source ~/airsim_ros_ws/devel/setup.bash roslaunch airsim_ros_pkgs rviz.launch如果RViz成功启动但里面空空如也通常是因为话题没有正确订阅或者坐标系TF树没有建立。请检查以下几点话题订阅在RViz左侧的Displays面板中添加一个“MarkerArray”显示并将其Topic设置为/airsim_node/Drone1/debug/front_cam如果配置了相机或添加“PointCloud2”显示订阅点云话题。添加“TF”显示以查看坐标系。坐标系确保“Global Options”中的“Fixed Frame”设置为odom_local_ned或world_ned取决于AirSim节点的TF广播。AirSim默认使用NED北-东-地坐标系这与ROS常用的ENU东-北-天不同需要注意转换。常见问题如果RViz中看不到无人机模型或传感器数据可以尝试先关闭所有节点和UE4编辑器然后严格按照UE4 - AirSim ROS节点 - RViz的顺序重新启动。有时候第一次启动时资源加载不完整重启一次就能解决。第四步发送控制指令你可以通过ROS话题来操控无人机。例如在一个新终端中可以使用rostopic pub命令让无人机起飞# 发布起飞指令 rostopic pub /airsim_node/Drone1/takeoff std_msgs/Empty {} -1 # 发布降落指令 rostopic pub /airsim_node/Drone1/land std_msgs/Empty {} -1更复杂的控制比如定点飞行则需要编写ROS节点或使用已有的控制包如mavros与PX4结合。至此一个基于RTX 4060、Ubuntu 20.04、UE4.27和AirSim的ROS仿真环境就基本搭建并运行起来了。剩下的就是根据你的具体研究或项目需求在这个平台上开发算法、测试控制器了。整个过程虽然步骤繁多但每一步的坑基本都有迹可循耐心和仔细查阅文档、Issue是解决问题的最佳伙伴。