首页/资讯中心/详情

UE5 Linux服务器端开发环境一键部署与VSCode远程调试指南

UE5 Linux服务器端开发环境一键部署与VSCode远程调试指南
📅 发布时间：2026/8/2 3:33:41

1. 项目概述：为什么要在Linux上部署UE5服务器端环境？

如果你是一名UE5开发者，尤其是专注于多人在线游戏、云游戏或需要高并发处理的后端服务，那么将开发环境迁移到Linux服务器上，几乎是一个必然的选择。这不仅仅是“为了酷”或者“技术极客”的偏好，而是实打实的性能、成本和运维优势驱动的结果。我自己从Windows开发环境转向Linux服务器部署，最初也是被项目逼的——一个需要同时模拟上千名玩家的压力测试环境，在Windows Server上光是操作系统本身的开销就让人头疼，更别提许可成本了。而在Ubuntu上，同样的硬件资源，能稳定承载的并发连接数和计算密度明显更高。

这个项目的核心，就是解决从零开始，在一台纯净的Ubuntu 22.04.4服务器上，快速搭建一套完整的、可用于实际开发的UE5服务器端环境。这里的“服务器端”不仅指编译一个Server目标的游戏，更包括一整套能让开发者高效工作的工具链：从UE5引擎源码的获取、编译，到项目代码的编辑、调试，再到日常的版本管理和自动化构建。我们最终的目标是得到一个通过VSCode可以无缝进行远程开发、设断点、单步调试的“本地化”体验，尽管所有计算实际上都在远端的Linux服务器上完成。

为什么是Ubuntu 22.04.4 LTS？长期支持版意味着长达五年的稳定更新和维护，这对于需要7x24小时运行的服务器环境至关重要。其软件仓库的成熟度、社区支持以及云服务商（如AWS、Azure、腾讯云）的镜像优化都做得非常好，能避免很多稀奇古怪的依赖问题。而VSCode的远程开发扩展（Remote-SSH）已经非常成熟，它允许我们将本地的IDE界面与远程服务器的文件系统、终端和调试器深度集成，完美解决了Linux服务器缺乏图形化IDE的痛点。

简单来说，这个过程手动操作的话，涉及几十个步骤，包括安装超过20GB的依赖库、处理各种编译工具链的版本冲突、配置复杂的调试符号路径等，稍有不慎就会卡住几个小时。因此，我将其提炼并自动化成了一个脚本，并结合VSCode的配置，形成了这篇可以“抄作业”的完整指南。无论你是要在公司内网部署一个专用的UE5编译服务器，还是在云上快速拉起一个临时的开发测试环境，这套方案都能让你在1-2小时内从零进入可开发状态。

2. 环境准备与自动化脚本设计思路

在开始敲命令之前，我们必须先理清整个部署流程的骨架和关键决策点。盲目执行脚本遇到报错时，你会一头雾水；理解了背后的逻辑，你才能灵活应对各种变数，比如不同的Ubuntu版本、特定的硬件环境（尤其是ARM架构）或是公司内部的代理设置。

2.1 服务器基础环境考量

首先，你需要一台运行Ubuntu 22.04.4的服务器。它可以是：

  • 物理服务器：公司机房里的机器。
  • 本地虚拟机：使用VMware Workstation或VirtualBox在本地电脑上创建。这对于前期学习和测试非常友好。
  • 云服务器：例如AWS EC2、Google Cloud Compute Engine、阿里云ECS等。建议选择计算优化型实例，并确保有至少100GB的SSD存储空间。

注意：无论哪种方式，请确保你拥有root权限或可以通过sudo执行特权命令。后续所有操作都基于此前提。

对于资源配置，UE5的编译是个资源吞噬兽，尤其是内存。以下是经过实测的最低推荐配置和舒适配置：

资源类型最低配置 (仅编译空项目)推荐配置 (舒适开发)说明
CPU核心4核8核或以上编译过程高度并行，核心数直接影响速度。
内存16 GB32 GB 或以上低于16GB在链接阶段极易因内存不足（OOM）而失败。32GB可以流畅编译大型项目。
存储空间100 GB200 GB 或以上UE5引擎源码+编译产出约80GB，还需为项目、IDE、缓存留足空间。务必使用SSD，机械硬盘的编译时间可能是数倍。
网络稳定的互联网连接高速、低延迟连接需要从GitHub克隆UE5源码（约1.5GB初始，后续更大）和下载大量依赖。

2.2 自动化脚本的核心逻辑与分层设计

手动部署的痛点在于步骤琐碎、依赖复杂、易出错且难以重现。自动化脚本的价值就在于将这一过程标准化、可重复化。我设计的脚本遵循了“分层处理、清晰日志、错误中断”的原则。

脚本主要分为以下几个阶段，每个阶段都有明确的检查点和回滚（或报错）机制：

  1. 系统更新与基础工具安装：首先更新软件包列表，安装git,curl,wget,build-essential,cmake等构建和下载工具。这是所有后续操作的基础。
  2. 安装UE5编译所需的特定依赖：这是最关键也是最容易出错的一步。UE5官方有提供Setup.sh脚本，但它假设了一些前提。我们的脚本会提前安装所有必要的库，如libxml2-dev,libgl1-mesa-dev,zlib1g-dev,libpng-dev等。特别是对于Ubuntu 22.04，需要处理一些软件包名称或版本的变化。
  3. 安装并配置合适的编译工具链：重点是clang和lld。UE5默认使用其自带的特定版本Clang进行Linux编译，但系统需要先有一个基础的Clang来构建这个自带的工具链。脚本会安装一个较新版本的Clang（如14或15），并设置update-alternatives来管理默认编译器。
  4. 获取UE5引擎源码：通过git克隆Epic Games的UnrealEngine仓库。这里涉及访问权限，脚本会引导你配置GitHub个人访问令牌（PAT）或使用已配置的SSH密钥。重要提示：你必须拥有一个链接了GitHub账户的Epic Games账户，并同意开发者协议。
  5. 运行UE5自带的设置脚本：在依赖齐全后，运行引擎目录下的./Setup.sh。这个脚本会下载特定的.NET SDK、Android SDK等大量第三方依赖（约10-20GB）。我们的前置工作就是为了确保这个脚本能一路绿灯。
  6. 编译UE5引擎：运行./GenerateProjectFiles.sh生成Makefile，然后使用make进行编译。脚本会在这里提供并行编译选项（如make -j $(nproc)），以充分利用多核CPU。
  7. 安装并配置VSCode远程开发环境：在服务器上安装VSCode Server，并在本地VSCode中配置Remote-SSH连接。同时，安装C++、CMake Tools等必要插件，并生成适用于UE5 Linux开发的launch.json和tasks.json调试配置文件。

整个脚本被设计为可幂等执行。即，如果中途因网络或依赖问题失败，修复问题后重新运行脚本，它会根据已完成的步骤跳过或继续，而不是盲目从头开始（通过检查目录、文件存在性等方式实现）。

3. 自动化部署脚本详解与实操

下面，我将拆解脚本的关键部分，并解释每一段命令的作用。你可以将这些代码块保存为一个文件，例如setup_ue5_linux_dev.sh。

3.1 脚本开头：环境检查与变量定义

#!/bin/bash # UE5 Linux开发环境一键部署脚本 # 适用于 Ubuntu 22.04.4 LTS # 作者：你的名字 set -e # 遇到任何命令执行失败就立即退出，避免错误累积 # 颜色定义，用于输出高亮 RED='\033[0;31m' GREEN='\033[0;32m' YELLOW='\033[1;33m' NC='\033[0m' # No Color # 关键路径定义 - 你可以根据需要修改 UE5_REPO_DIR="$HOME/UnrealEngine" # UE5源码克隆目录 VSCODE_DATA_DIR="$HOME/.vscode-server" # VSCode远程服务器数据目录 log_info() { echo -e "${GREEN}[INFO]${NC} $1" } log_warn() { echo -e "${YELLOW}[WARN]${NC} $1" } log_error() { echo -e "${RED}[ERROR]${NC} $1" } # 检查是否为Ubuntu 22.04 if ! grep -q "22.04" /etc/os-release; then log_warn "此脚本主要针对 Ubuntu 22.04.4 测试，当前系统版本可能不兼容。" read -p "是否继续？ (y/N): " -n 1 -r echo if [[ ! $REPLY =~ ^[Yy]$ ]]; then exit 1 fi fi

set -e是安全脚本的基石，它能防止某个步骤失败后脚本还继续运行，导致后续操作在错误的状态下进行，让问题更难排查。定义颜色函数让终端输出更具可读性，成功、警告和错误信息一目了然。

3.2 阶段一：安装系统依赖与基础工具

install_system_deps() { log_info "阶段1: 更新系统并安装基础工具..." sudo apt-get update -y sudo apt-get upgrade -y # 基础开发工具 sudo apt-get install -y \ git git-lfs \ curl wget tar zip unzip \ build-essential \ cmake ninja-build \ pkg-config \ software-properties-common # UE5 Linux编译核心依赖 (来自官方文档及实践补充) sudo apt-get install -y \ clang-14 lld-14 libstdc++-12-dev \ libxml2-dev libgl1-mesa-dev \ libx11-dev libxrandr-dev libxinerama-dev libxcursor-dev \ libxss-dev libwayland-dev libxkbcommon-dev \ zlib1g-dev libpng-dev libfreetype6-dev \ libssl-dev libsqlite3-dev \ libasound2-dev libpulse-dev \ libavcodec-dev libavformat-dev libavutil-dev libswscale-dev \ libwebp-dev libopus-dev libogg-dev \ libudev-dev libdrm-dev # 设置clang-14和lld-14为默认版本（如果系统有多个版本） sudo update-alternatives --install /usr/bin/clang clang /usr/bin/clang-14 100 sudo update-alternatives --install /usr/bin/clang++ clang++ /usr/bin/clang++-14 100 sudo update-alternatives --install /usr/bin/lld lld /usr/bin/lld-14 100 log_info "系统依赖安装完成。" }

这里有几个关键点：

  • git-lfs：必须安装。UE5的二进制资产（如纹理、模型）使用Git LFS管理，没有它你拉取不到完整资源。
  • clang-14和lld-14：Ubuntu 22.04官方仓库中的较新版本，作为宿主编译器足够用。UE5自带的工具链会在此基础上构建。
  • libwayland-dev等图形库：即使做纯服务器端开发，某些引擎模块可能仍需要这些头文件来编译。安装它们可以避免潜在的编译错误。
  • update-alternatives：这是一个关键技巧。它帮你管理系统中的多版本软件链接。确保后续clang、clang++命令调用的是我们安装的版本14。

3.3 阶段二：获取UE5引擎源码

clone_ue5_source() { log_info "阶段2: 获取UE5引擎源码..." if [ -d "$UE5_REPO_DIR/.git" ]; then log_info "检测到已存在的UE5仓库，尝试更新..." cd "$UE5_REPO_DIR" git pull origin release git submodule update --init --recursive return fi log_warn "请确保你的Epic Games账户已关联GitHub，并拥有访问 UnrealEngine 仓库的权限。" log_warn "如果需要使用个人访问令牌(PAT)，请在接下来的URL中使用格式：https://<你的令牌>@github.com/EpicGames/UnrealEngine.git" read -p "请输入UE5仓库的Git克隆URL (默认使用SSH格式 git@github.com:EpicGames/UnrealEngine.git): " repo_url repo_url=${repo_url:-"git@github.com:EpicGames/UnrealEngine.git"} git clone --depth 1 --branch release "$repo_url" "$UE5_REPO_DIR" cd "$UE5_REPO_DIR" # 初始化并更新子模块（这步耗时较长，且需要稳定网络） log_info "初始化并更新Git子模块，这可能需要很长时间并下载大量数据..." git submodule update --init --recursive }
  • --depth 1：只克隆最近的一次提交，可以极大加快克隆速度，减少初始下载量。对于首次搭建环境来说足够了。
  • --branch release：克隆release分支，这是最稳定的版本分支。你也可以指定具体的版本标签，如5.3。
  • git submodule update --init --recursive：这是最耗时、最吃网络的一步。UE5使用了大量第三方库作为子模块（如PhysX, Intel TBB等）。这一步会拉取所有这些依赖的特定版本。务必保证网络稳定，如果中断，可以重新运行此命令继续。

3.4 阶段三：运行UE5设置与编译

setup_and_build_ue5() { log_info "阶段3: 运行UE5设置脚本..." cd "$UE5_REPO_DIR" # 运行官方设置脚本，它会下载.NET SDK等额外依赖 ./Setup.sh log_info "生成项目文件..." ./GenerateProjectFiles.sh log_info "开始编译UE5引擎 (使用所有CPU核心，这需要很长时间)..." # 计算可用的CPU核心数 NUM_CORES=$(nproc) make -j $NUM_CORES # 验证编译是否成功 if [ -f "Engine/Binaries/Linux/UnrealServer" ]; then log_info "UE5引擎编译成功！" ./Engine/Binaries/Linux/UnrealServer --version else log_error "编译可能失败，未找到 UnrealServer。请检查上面的编译输出日志。" exit 1 fi }
  • ./Setup.sh：这是Epic官方的环境准备脚本。它会检查环境，并下载Windows、Android等平台所需的SDK（即使你不需要，它也会下载一部分）。在我们的前置依赖都装好的情况下，它应该能顺利运行。
  • ./GenerateProjectFiles.sh：生成用于编译的Makefile或Ninja构建文件。
  • make -j $NUM_CORES：启动并行编译。$(nproc)会自动获取你系统的CPU核心数。编译时间从半小时到数小时不等，取决于你的机器性能。在此期间，请保持终端连接稳定，避免中断。
  • 最后检查UnrealServer是否存在，这是Linux服务器端的目标可执行文件，也是我们后续调试的对象。

3.5 阶段四：配置VSCode远程开发

这一步无法完全通过脚本在服务器端完成，因为涉及本地VSCode的操作。但脚本可以准备好服务器端的环境。

setup_vscode_remote() { log_info "阶段4: 准备VSCode远程开发环境..." # 安装VSCode Server所需的基础依赖（通常已安装） sudo apt-get install -y \ wget \ ca-certificates \ libkrb5-dev \ gnupg log_info "VSCode远程开发环境基础已就绪。" log_info "请在你的本地电脑上执行以下操作：" echo "1. 安装VSCode，并安装官方扩展 'Remote - SSH' (ms-vscode-remote.remote-ssh)。" echo "2. 使用Remote-SSH连接到这台服务器：$USER@$(hostname -I | awk '{print $1}')" echo "3. 连接成功后，在VSCode的扩展商店中，安装以下插件：" echo " - C/C++ (ms-vscode.cpptools)" echo " - CMake Tools (ms-vscode.cmake-tools)" echo " - C++ Intellisense (austin.code-gnu-global) [可选，用于更好的代码导航]" echo "4. 连接后，打开服务器上的UE5引擎目录: $UE5_REPO_DIR" }

脚本在这里主要是提示。真正的魔法发生在你本地VSCode通过Remote-SSH连接上来之后。连接时，VSCode会自动在服务器端安装一个轻量级的vscode-server，使得本地UI能与服务器端的文件、终端和运行时环境交互。

3.6 主执行流程

main() { log_info "开始部署UE5 Linux服务器端开发环境..." install_system_deps clone_ue5_source setup_and_build_ue5 setup_vscode_remote log_info "自动化脚本执行完毕！" log_info "接下来，请按照上述提示配置你的本地VSCode进行远程连接和调试。" } # 执行主函数 main

将以上所有代码块按顺序组合，就得到了完整的自动化脚本。给脚本添加执行权限并运行：

chmod +x setup_ue5_linux_dev.sh ./setup_ue5_linux_dev.sh 2>&1 | tee setup.log # 同时输出到屏幕和日志文件

tee命令非常有用，它能把所有输出（包括错误信息2>&1）既显示在终端，也保存到setup.log文件中，方便后续排查问题。

4. VSCode远程调试配置实战

当服务器端的UE5引擎编译成功，并且你通过VSCode Remote-SSH连接上来之后，就进入了最激动人心的环节：配置调试。目标是能在本地的VSCode里，对运行在Linux服务器上的UE5服务器程序（或编辑器）设断点、查看变量、单步执行。

4.1 配置C/C++插件与编译数据库

UE5使用自定义的构建系统（UnrealBuildTool），不是标准的CMake或Makefile项目。因此，VSCode的C/C++插件需要知道如何解析代码，比如头文件路径、宏定义等。最有效的方法是让插件使用compile_commands.json文件。

  1. 生成 compile_commands.json： 在服务器终端，进入UE5引擎目录，运行以下命令（这需要先编译通过）：

    cd ~/UnrealEngine ./Engine/Build/BatchFiles/Linux/GenerateProjectFiles.sh -game -engine -vscode

    -vscode参数会告诉构建系统生成VSCode所需的配置文件，其中就包括compile_commands.json，它通常位于引擎根目录或Engine目录下。

  2. 配置C/C++插件： 在远程连接的VSCode中，打开命令面板（Ctrl+Shift+P），输入C/C++: Edit Configurations (UI)。

    • 在Compiler path中，填入/usr/bin/clang++（这是我们之前设置的默认版本）。
    • 在IntelliSense mode中选择linux-clang-x64。
    • 最关键的一步：在Configuration provider下拉框中，选择ms-vscode.cmake-tools。即使我们不是CMake项目，这个插件也能帮我们找到compile_commands.json。
    • 或者，你也可以直接在.vscode/c_cpp_properties.json中指定compileCommands路径：
      { "configurations": [ { "name": "Linux", "compileCommands": "${workspaceFolder}/compile_commands.json", // ... 其他配置 } ] }

    配置完成后，代码中的跳转、查看定义、错误波浪线应该基本正常了。

4.2 创建调试配置 (launch.json)

这是调试的核心。我们需要创建一个启动配置，来告诉VSCode如何启动和附加到我们的UE5程序。

在VSCode中打开~/UnrealEngine文件夹，然后进入调试视图（Ctrl+Shift+D），点击“创建 launch.json 文件”，选择C++ (GDB/LLDB)。

将配置替换为如下内容，这里提供了两种最常用的场景：

{ "version": "0.2.0", "configurations": [ { "name": "(gdb) 启动 UnrealEditor (Linux)", "type": "cppdbg", "request": "launch", "program": "${workspaceFolder}/Engine/Binaries/Linux/UnrealEditor", "args": [ "${workspaceFolder}/YourProject/YourProject.uproject", "-debug" ], "stopAtEntry": false, "cwd": "${workspaceFolder}", "environment": [], "externalConsole": false, "MIMode": "gdb", "setupCommands": [ { "description": "为 gdb 启用整齐打印", "text": "-enable-pretty-printing", "ignoreFailures": true } ], "preLaunchTask": "Build UE5 Editor (Development)" }, { "name": "(gdb) 启动 UnrealServer (Linux)", "type": "cppdbg", "request": "launch", "program": "${workspaceFolder}/Engine/Binaries/Linux/UnrealServer", "args": [ "${workspaceFolder}/YourProject/YourProject.uproject", "-log" ], "stopAtEntry": false, "cwd": "${workspaceFolder}", "environment": [], "externalConsole": false, "MIMode": "gdb", "setupCommands": [ { "description": "为 gdb 启用整齐打印", "text": "-enable-pretty-printing", "ignoreFailures": true } ] }, { "name": "(gdb) 附加到已运行的 UnrealServer 进程", "type": "cppdbg", "request": "attach", "program": "${workspaceFolder}/Engine/Binaries/Linux/UnrealServer", "processId": "${command:pickProcess}", "MIMode": "gdb", "setupCommands": [ { "description": "为 gdb 启用整齐打印", "text": "-enable-pretty-printing", "ignoreFailures": true } ] } ] }

配置解析：

  • program: 指定要调试的可执行文件路径。UnrealEditor是带界面的编辑器，UnrealServer是纯服务器。
  • args: 启动参数。-debug让编辑器等待调试器连接；-log让服务器输出日志到控制台。
  • MIMode: 指定调试器为gdb。在Linux上，这是最通用的选择。你也可以安装lldb并配置为lldb。
  • preLaunchTask: 这是一个高级功能，可以在启动调试前自动执行一个构建任务（需要配置tasks.json），确保你调试的是最新编译的代码。
  • 附加调试：对于服务器进程，通常它已经在运行。attach配置允许你选择一个正在运行的进程ID进行附加调试，这对于调试线上问题或长时间运行的服务器非常有用。

4.3 配置构建任务 (tasks.json) 实现一键编译

为了让preLaunchTask生效，我们需要定义对应的构建任务。在命令面板输入Tasks: Configure Task，然后选择Create tasks.json file from template->Others。

编辑生成的.vscode/tasks.json文件：

{ "version": "2.0.0", "tasks": [ { "label": "Build UE5 Editor (Development)", "type": "shell", "command": "cd ${workspaceFolder} && make UnrealEditor Linux Development -j $(nproc)", "group": { "kind": "build", "isDefault": true }, "problemMatcher": ["$gcc"], "presentation": { "echo": true, "reveal": "always", "focus": false, "panel": "dedicated", "showReuseMessage": false, "clear": true } }, { "label": "Build MyGame Server (Development)", "type": "shell", "command": "cd ${workspaceFolder} && ./Engine/Build/BatchFiles/Linux/Build.sh MyGame Linux Development -Project=\"${workspaceFolder}/MyGame/MyGame.uproject\" -Target=\"MyGameServer\" -WaitMutex -Verbose", "group": "build", "problemMatcher": ["$gcc"] } ] }
  • label: 任务名称，与launch.json中的preLaunchTask对应。
  • command: 具体的构建命令。第一个任务直接使用make编译整个引擎的编辑器。第二个任务展示了如何使用UE5的构建脚本Build.sh来编译特定项目的服务器目标（MyGameServer）。你需要将MyGame替换为你的实际项目名。
  • problemMatcher: 告诉VSCode如何从构建输出中提取错误和警告信息，这样就能在“问题”面板中点击错误直接跳转到代码行。

配置完成后，你可以按Ctrl+Shift+B默认执行第一个构建任务，或者在调试时选择带有preLaunchTask的配置，VSCode会在启动调试器前自动编译。

5. 常见问题、排查技巧与性能优化

即使有自动化脚本，在实际部署中你仍可能遇到各种问题。下面是我在多次部署中积累的“避坑指南”。

5.1 编译阶段常见错误与解决

  1. 内存不足 (OOM Killer)现象：编译过程中终端进程突然被杀死，系统日志（dmesg或/var/log/kern.log）显示Out of memory: Killed process ... (make)。解决：

    • 增加交换空间：如果物理内存不足，可以创建交换文件。
      sudo fallocate -l 8G /swapfile # 创建8GB交换文件 sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile # 永久生效，编辑 /etc/fstab，添加: /swapfile none swap sw 0 0
    • 减少并行编译任务：编辑脚本或手动编译时，将make -j $(nproc)改为make -j 2或更小的数字，减少内存峰值压力。
    • 升级硬件：这是根本解决方案，建议服务器至少配备32GB内存。

  2. Git子模块更新失败现象：git submodule update过程中网络超时或报错。解决：

    • 重试命令。Git会尝试断点续传。
    • 如果某个特定子模块反复失败，可以尝试手动进入该子模块目录进行git pull。
    • 检查网络连接，特别是如果服务器在海外，GitHub克隆可能较慢，可以考虑配置代理（需在安全合规前提下进行）。

  3. 缺少特定头文件或库现象：编译错误提示fatal error: xxx.h: No such file or directory或cannot find -lxxx。解决：

    • 使用apt-file search xxx.h来查找包含该头文件的软件包。
    • 通常是因为我们的依赖列表有遗漏。根据错误信息，使用sudo apt-get install libxxx-dev安装对应的开发包。然后重新运行./Setup.sh和编译。

5.2 VSCode调试配置问题

  1. 断点不生效（显示为灰色空心圆）原因：VSCode没有加载到正确的调试符号，或者源代码路径不匹配。排查：

    • 确保你编译的是Development或Debug配置，而不是Shipping。Shipping配置会剥离调试信息。
    • 检查launch.json中的program路径是否正确指向了编译出的可执行文件。
    • 在VSCode调试控制台输入-exec info sources（GDB命令），查看调试器加载的源文件列表，确认是否包含你设断点的文件。
    • 尝试在setupCommands中添加源代码映射（如果代码路径在编译和调试时不同）：
      "setupCommands": [ ..., { "description": "映射源代码路径", "text": "directory /home/user/UnrealEngine", "ignoreFailures": false } ]

  2. “无法连接到远程扩展主机”或SSH连接频繁断开原因：网络不稳定或SSH超时设置过短。解决：

    • 在本地SSH配置文件中（~/.ssh/config）为你的服务器主机添加以下参数，增加连接保活：
      Host my-ue5-server HostName your.server.ip User yourusername ServerAliveInterval 60 ServerAliveCountMax 5 TCPKeepAlive yes
    • 确保服务器防火墙开放了SSH端口（默认22）。

5.3 性能优化与日常使用建议

  1. 使用ccache加速后续编译： UE5代码库巨大，首次编译后，后续修改代码再编译，可以使用ccache来缓存编译结果，极大提升增量编译速度。

    sudo apt-get install -y ccache # 在~/.bashrc中添加 export CCACHE_SLOPPINESS=clang_index_store,file_stat_matches,include_file_ctime,include_file_mtime,ivfsoverlay,pch_defines,time_macros export CCACHE_MAXSIZE=20G # 设置缓存大小 # 让UE5构建系统使用ccache # 编辑 ~/UnrealEngine/Engine/Build/BatchFiles/Linux 下的构建脚本，在调用编译器命令前加上 `ccache` # 更简单的方法：设置符号链接 sudo ln -s /usr/bin/ccache /usr/local/bin/gcc sudo ln -s /usr/bin/ccache /usr/local/bin/g++ sudo ln -s /usr/bin/ccache /usr/local/bin/clang sudo ln -s /usr/bin/ccache /usr/local/bin/clang++

    注意：使用符号链接是一种全局方法，可能会影响其他项目。更推荐研究UE5构建系统的参数来集成ccache。

  2. 将引擎源码放在高性能存储上： 编译过程会产生海量的小文件读写（.o目标文件、.cpp源文件）。使用高性能NVMe SSD与使用SATA SSD或机械硬盘，编译时间可能有数倍差距。对于云服务器，选择配备本地NVMe存储的实例类型。

  3. 使用tmux或screen管理长时间任务： 编译UE5可能需要数小时。为了防止SSH会话断开导致编译中断，务必在tmux或screen会话中运行编译命令。

    sudo apt-get install -y tmux tmux new -s ue5build # 在新会话中运行编译脚本 ./setup_ue5_linux_dev.sh # 按 Ctrl+b, 然后按 d 分离会话 # 重新连接：tmux attach -t ue5build

  4. 定期清理中间文件： 编译产生的Intermediate和Saved目录可以非常大。在确定不需要调试旧版本时，可以安全删除项目目录下的Binaries和Intermediate文件夹，下次编译时会重新生成。引擎本身的中间文件位于Engine/Intermediate，清理需谨慎。

这套从自动化脚本到VSCode深度调试的完整方案，已经在我参与的多个UE5服务器项目中得到了验证。它最大的价值在于将复杂的、易出错的手动流程标准化，让开发者能快速获得一个“开箱即用”的、生产力强大的Linux开发环境，从而更专注于游戏逻辑本身，而不是和环境搏斗。当你第一次在本地VSCode里成功命中一个运行在远端Linux服务器上的UE5服务器断点时，那种感觉会让你觉得所有的前期折腾都是值得的。