企业官网建设流程全解析

第一次打开 UE 编辑器的人，往往会在同一个地方卡住：视口能转、模型能拖，可灯光一加整个场景是黑的，材质一挂颜色又不对，关了编辑器再重开发现刚才摆的东西全没了。这篇笔记按我刚开始接触 UE 时搭场景的真实顺序，把从新建项目、摆放模型、打光调氛围，到让角色真的能跑起来、能看帧率的整条链路捋一遍，中间穿插我自己踩过的坑和对应的排查方法。

内容面向三类读者：完全没用过 UE 的新手、从其他引擎转过来的开发者、以及只需要快速搭一个演示场景的美术或策划同学。读完之后，你应该能独立做出一个有地面、有建筑、有光照、有简单交互的可运行小场景，并且知道性能指标从哪里看、报错信息怎么定位。

1. 背景与核心概念：UE 的“搭场景”到底在搭什么

1.1 从一个空关卡说起

在 UE 里，“场景”在工程层面叫关卡（Level），落盘后是一个.umap文件。一个空关卡里几乎什么都没有，只有编辑器自带的天空盒视觉背景和一套默认的渲染设置。你在视口里看到的整个三维世界，本质上是一个容器，容器里装着一堆 Actor（演员），每个 Actor 又可以挂若干 Component（组件）。地面是一个 Actor、灯是一个 Actor、玩家出生点是一个 Actor、雾也是一个 Actor。理解这一点很关键，因为后面所有的“搭建”动作，说白了就是在往关卡里增加 Actor、调整它们的属性、调整它们之间的关系。

和 Unity 对比会更容易理解：UE 的 Actor 大致对应 GameObject，Component 大致对应 Component，关卡对应 Scene。区别在于 UE 的 Actor 默认带一个 Root Component（通常是 SceneComponent），所有位置变换都挂在这个根节点上，子组件相对根节点做偏移。第一次用 UE 的人常常搞不清“为什么我改了 Actor 的位置，里面的 Static Mesh 没跟着动”，原因就是位置信息记录在根组件上，你手动改了子组件相对变换，视觉上就会和 Actor 中心点错位。

关卡本身还分“持久关卡”和“子关卡”，做大型地图时会把建筑、植被、灯光拆到不同子关卡里按需加载。新手阶段完全不用管这套，一个关卡装完所有东西就行，等场景大到打开就卡的时候再考虑拆分。

1.2 六个必须先建立的概念

第一个是 Static Mesh（静态网格体）。它是导入引擎后的模型资源，特点是不可变形、可以做批处理和实例化，场景里的墙壁、地面、楼梯基本都是它。第二个是 Material（材质），控制表面“长什么样”，包括颜色、粗糙度、金属度、法线细节。第三个是 Material Instance（材质实例），基于母材质派生出来的可调参数副本，是实际项目里最常用的形式。第四个是 Light（光照），UE5 默认走的是实时全局光照方案，灯光参数和性能开销关联紧密。第五个是 Blueprint（蓝图），可视化脚本，用来给场景加逻辑。第六个是 World Settings（世界设置），关卡级别的参数都在这里，包括游戏模式、光照构建方式、重力等。

这六个概念里，前三个决定“看起来怎么样”，后三个决定“跑起来怎么样”。新手最容易只关注前三个，结果做出来的场景在编辑器里很好看，一运行帧率就崩了，或者灯光效果和编辑器预览完全不一致。所以从第一天起就要养成习惯：每摆完一批资产，就运行一次看看实际效果和帧率。

1.3 新手最容易混淆的四组概念

第一组是Level 和 Project。Project 是整个工程，包含所有关卡、资产、配置和代码；Level 只是其中一张地图。很多人第一次建完项目，关掉再打开发现进了一个空场景，以为是工程坏了，其实只是默认关卡没设置对，编辑器打开的是另一个空关卡。

第二组是Static Mesh 和 Skeletal Mesh。前者是刚性的、不能形变的网格，后者带骨骼、可以做动画。角色、带动画的机械臂用 Skeletal Mesh，墙壁地面桌子用 Static Mesh。把 Skeletal Mesh 当 Static Mesh 用会带来额外的动画开销。

第三组是Material 和 Material Instance。母材质定义的是一套逻辑和参数，实例只存参数值。项目里应该大量使用实例，因为改母材质会影响所有实例，而改实例只影响自己，且实例的编译开销小得多。新手常见的坏习惯是每个物体都复制一份母材质，最后项目里几百个独立材质，编译一次要等很久。

第四组是Blueprint 和 C++。蓝图适合做场景逻辑、交互原型、美术相关的效果控制；C++ 适合做底层系统、性能敏感的逻辑。场景搭建阶段九成以上的需求蓝图都能覆盖，不用一上来就写 C++。

2. 环境准备与项目初始化

2.1 硬件与软件环境的最低要求

UE 本身对硬件的要求不低，尤其是开了实时全局光照之后。经验参考值是：内存 16GB 起步、32GB 更稳，独立显卡显存 6GB 以上，工程盘留出 100GB 以上空间，因为一个中等规模的场景加上缓存文件很容易吃掉几十 G。固态硬盘基本是必须的，机械盘上打开一个稍大的关卡能等到怀疑人生。这些是社区里比较通用的经验值，官方文档给出的推荐配置会随版本变化，实际以你安装的版本说明为准。

软件方面，本文示例以 Unreal Engine 5 系列版本为例，具体小版本号请以你本机安装的实际版本为准。启动器里可以同时装多个版本，做不同项目时互不干扰。另外建议装好对应版本的 Visual Studio（即使只写蓝图，某些版本在创建 C++ 项目或打包时仍然需要编译工具链），以及一个 Git 客户端用于版本管理。

经验参考环境（非官方硬性要求） -------------------------------- 操作系统 : Windows 10/11 64 位（或对应版本的 macOS / Linux） 内存 : 16GB 起步，32GB 推荐 显卡 : 独立显卡，显存 6GB 以上 硬盘 : 固态硬盘，工程盘预留 100GB+ 引擎版本 : Unreal Engine 5.x（以本机实际安装为准） 编译工具 : 对应版本的 Visual Studio（打包或 C++ 项目需要） 版本管理 : Git + Git LFS

2.2 新建项目时的三个关键选择

打开启动器点“新建项目”，会看到一堆模板。模板分几大类：游戏类（Blank、Third Person、First Person、Top Down 等）、影视与动画类、建筑可视化类、产品设计类等。做场景搭建练习，最省事的是选Blank模板，它给你一个几乎空的关卡，没有任何多余内容干扰；如果想直接有一个能跑能跳的角色，选Third Person，它自带角色、动画和输入配置，省掉自己搭角色的时间。

第二个选择是项目设置里的Blueprint 还是 C++。纯场景搭建选 Blueprint 就行。第三个是目标平台，默认选桌面即可，如果明确要做移动端，可以在创建时勾选移动平台，引擎会自动调整一部分默认渲染设置，省得后面手动关闭一堆桌面端特性。

还有两个选项建议勾上：Starter Content（新手内容包，包含基础材质、粒子、道具模型，练习时非常有用）和Raytracing / Lumen 相关的默认渲染特性（如果显卡支持）。Starter Content 里的材质实例和贴图可以直接拿来改，比自己从零做材质快得多。

2.3 项目内容目录的规划约定

新建项目后，Content Browser 里会看到Content目录，所有资产都放在这里。第一次搭场景很容易乱：模型、材质、贴图、蓝图全堆在根目录，过两天自己都找不到。建议一开始就按类型建好文件夹，这是成本最低、收益最高的一条规范。

Content/ ├── Maps/ 关卡文件（.umap） ├── Meshes/ 静态网格体（SM_ 前缀） │ ├── Architecture/ 建筑类 │ └── Props/ 道具类 ├── Materials/ 材质（M_ 母材质，MI_ 材质实例） ├── Textures/ 贴图（T_ 前缀） ├── Blueprints/ 蓝图（BP_ 前缀） ├── Audio/ 音频 └── Python/ 编辑器脚本（启用 Python 插件后生效）

前缀约定是社区里通用的做法：SM_表示 Static Mesh，M_表示 Material，MI_表示 Material Instance，T_表示 Texture，BP_表示 Blueprint，L_表示 Level。好处是 Content Browser 里搜MI_就能列出所有材质实例，搜L_就能列出所有关卡，不用一层层翻文件夹。

2.4 编辑器界面速览与视口操作

UE 编辑器主界面由几块区域组成。中间最大的区域是Viewport（视口），你在这里摆放和查看场景。右侧是Outliner（大纲），列出当前关卡里的所有 Actor。Outliner 下方是Details（细节）面板，选中任何 Actor，它的所有可调参数都在这里。底部是Content Browser（内容浏览器），资产都在这里管理。左上角是Toolbar（工具栏），保存、运行、打包、设置入口都在上面。

视口操作和主流三维软件略有差别，第一次用会有点别扭，但记住几个就够用：按住鼠标右键拖动转视角，按住右键的同时用 WASD 前后左右移动，按住右键时滚动滚轮调整移动速度；按住 Alt 加鼠标左键做环绕观察，Alt 加中键平移，Alt 加右键推拉。选中一个 Actor 后按F键，视角会聚焦到它身上，这是最常用的一个键，找东西的时候非常救命。

变换操作的快捷键是W 移动、E 旋转、R 缩放，对应三个 Gizmo 工具。这些和主流三维软件一致，基本不用重新学。真正需要记住的是几个效率键：End把选中物体贴合到下方表面，摆道具时用得上；按住Alt拖动 Gizmo 是复制一份，比 Ctrl+C/Ctrl+V 快得多；G键临时隐藏选中的物体，用来查看被挡住的部分。

3. 场景搭建的核心操作拆解

3.1 摆放资产：从 Content Browser 到 Viewport

摆放一个静态网格体有两种方式。第一种是从 Content Browser 里直接把资产拖到视口里，引擎会在你鼠标指针所在的位置和深度生成一个 Actor，位置未必准确但很快。第二种是从 Content Browser 拖到 Outliner 里，Actor 会被创建在世界原点（0,0,0），然后在 Details 里手动填坐标。做建筑对齐的时候推荐第二种，因为可以精确控制坐标数值。

第三种方式是通过工具栏上的“快速添加”菜单（不同版本里位置略有差异），里面内置了立方体、球体、圆柱、平面等基础形状，以及各类光源、触发器、体积。做体块推敲和灯光测试的时候用这个最方便，不用先去内容浏览器翻资产。

摆放时要注意一个容易忽略的问题：模型的轴心和缩放。如果导入的模型轴心在角落而不是几何中心，旋转和缩放时就会出现诡异的偏移。遇到这种情况，可以在静态网格体编辑器里调整轴心位置，或者在场景里用一个空 Actor 作为父级，把子物体相对偏移调回中心。

3.2 变换与对齐：几个立刻能提升效率的快捷键

视口工具栏上有三组对齐开关：网格吸附（Grid Snap）、旋转吸附（Rotation Snap）、缩放吸附（Scale Snap）。默认的网格吸附间距是 10 单位，做建筑体块时建议改成 50 或 100，这样墙壁、地板会自动对齐到整数坐标，不会出现 0.3 单位的小缝隙。这一点在做室内场景时特别重要，缝隙在光照下会漏光。

对齐功能里最常用的是“贴地”（End 键）和“对齐到 Actor”（右键菜单里的 Snap 选项）。批量摆放同类物体时，可以选中多个 Actor 后统一设置坐标，或者在 Details 面板里锁定某一个轴的变换。UE 的 Details 面板支持多选编辑，选中一排灯，改一个灯的亮度，所有选中的灯会同步变化，这个特性在批量调参数时效率极高。

还有一个新手常踩的坑：缩放不均匀导致光照和法线错误。对静态网格体做非等比缩放（比如 X 拉长 Y 拉扁）时，法线方向会算错，表面看起来会出现奇怪的明暗。正确做法是在建模软件里改好形状，或者在引擎里用等比缩放加多个体块拼接。小范围的拉伸问题不大，但大范围的非等比缩放一定要避免。

3.3 光照系统：一套能跑起来的默认组合

UE 的光照是新手上手最难的部分，因为它不像传统离线渲染那样“打灯就是打灯”，实时全局光照需要一套组合拳才有效果。一套能立刻看到效果的最小组合是：一盏Directional Light（定向光）模拟太阳，一盏Sky Light（天空光）提供环境漫反射，一个Sky Atmosphere（天空大气）生成天空穹顶，再加一个Exponential Height Fog（指数高度雾）增加空间层次。

最小可用光照组合（可直接照抄） -------------------------------------------------- Directional Light 角度 -45 左右，Intensity 调到你满意 Mobility 建议设为 Movable Sky Light Source Type = Captured Scene Mobility 设为 Movable Sky Atmosphere 默认参数即可，可调 Rayleigh 散射系数 Exponential Height Fog Fog Density 从 0.02 起，慢慢加 Post Process Volume Infinite Extent (Unbound) 勾上

这里要特别说明 Mobility 的问题。UE 的灯光分 Static（静态）、Stationary（固定）、Movable（可移动）三档。静态灯需要“构建光照”才会产生效果，好处是运行时开销最低；可移动灯是实时计算的，能立刻看到效果但吃性能。新手阶段所有的灯都先设成 Movable，确认效果之后再考虑优化。很多人第一次打灯发现场景全黑，就是因为加的是 Static 灯但没点构建光照。

关于构建光照再补充一句：UE5 的实时全局光照方案本身是动态的，不需要像旧版本那样点“Build Lighting”才能看到间接光。但如果你想用传统的烘焙光照（Precomputed Lighting），Build 菜单里仍然有对应选项。这两套方案不要混用，同一个项目里选一套走到底。

3.4 材质：从母材质到材质实例

材质系统的核心思路是“母材质定义逻辑，实例只存参数”。新建一个材质，在节点图里用常量、贴图采样、数学运算连出一套通用效果，然后把需要变化的参数提升为 Parameter（选中节点按右键选 Convert to Parameter），保存。之后在 Content Browser 里右键这个材质，选“创建材质实例”，就能得到一个只含参数面板的 MI 文件。

材质里最基础的一组输入是 Base Color（基础颜色）、Metallic（金属度）、Specular（高光）、Roughness（粗糙度）、Emissive Color（自发光）、Normal（法线）。新手最常犯的错误是把 Metallic 拉到 1 又没给 Roughness，结果物体像一面完美的镜子，看起来非常假。真实的金属表面一定有粗糙度变化，哪怕是抛光金属，Roughness 也很少低于 0.1。

贴图导入后要检查几个设置：sRGB勾选状态（颜色贴图要勾，法线/粗糙度/金属度这类数据贴图要取消）、Compression Settings（颜色贴图用默认，法线贴图选 Normalmap，其他数据贴图选 Masks 或 Grayscale）、Texture Group（决定引擎按什么分辨率策略来流送）。这三项设置错了，表现就是颜色偏白、法线方向反、显存暴涨，报错信息还未必直接指向贴图。

3.5 组织与分层：Outliner、文件夹、Layer

Outliner 是场景的目录树，默认所有 Actor 平铺在一起。物体一多就完全没法找。两个改善手段：一是用文件夹（Folder）分组，选中一批 Actor 右键“Move To Folder”，可以建出“环境/建筑/灯光/道具”这样的层级；二是用Layer（层），把不同用途的物体分到不同层里，可以一键显示隐藏整层。

Outliner 顶部有搜索框，支持按名字和类型过滤。做复杂场景时，最常用的操作是：搜“Light”只看所有灯光，搜“BP_”只看所有蓝图，选中后批量改参数。另外，给每个 Actor 起有意义的名字（在 Details 面板顶部的标签字段改）比什么都重要，StaticMeshActor_12这种默认名字在后期排查问题时会让人抓狂。

4. 完整实战：搭一个能跑的小场景

4.1 场景规划与资产清单

动手之前先在纸上或脑子里定一个目标：一个 40 米见方的广场，中间有一个台子，四周有四面矮墙、两根柱子，两盏路灯，玩家出生在广场边缘，走到台子附近时路灯会亮起来。这个规模足够练到摆放、对齐、打光、材质、蓝图交互、性能查看这整套流程，又不至于复杂到自己都记不住摆了什么。

需要的资产清单：立方体（用于地面、矮墙、柱子，全部用引擎自带的基础形状缩放即可）、平面（可选，用于铺地面）、材质实例若干（地面、墙面、柱子各一种）、一盏 Directional Light、一盏 Sky Light、一个 Sky Atmosphere、一个 Exponential Height Fog、一个 Post Process Volume、一个 Player Start、一个蓝图（路灯交互）。全部用引擎自带资源，不需要额外下载任何东西。

4.2 铺地面与搭建筑体块

先做地面。从“快速添加”里拖一个 Cube 到场景，在 Details 面板里把 Location 设为 (0,0,0)，Scale 设为 (40,40,0.2)。这里 Cube 的原始边长是 100 单位，缩放 40 倍就是 4000 单位，差不多 40 米，厚度 0.2 倍即 20 单位。地面做完立刻按 Ctrl+S 保存关卡，养成摆几步就保存的习惯，UE 崩溃丢工作是很常见的事。

接着做中间台子：再拖一个 Cube，Location 设为 (0,0,30)，Scale 设为 (8,8,0.6)，得到一个 8 米见方、60 单位厚的台子。然后做四面矮墙，用四个 Cube 分别放在广场四边，Location 分别是 (1900,0,100)、(-1900,0,100)、(0,1900,100)、(0,-1900,100)，Scale 统一为 (40,0.4,2) 和 (0.4,40,2) 两种。这里的关键是用整数坐标和对齐到网格，保证四面墙严丝合缝，不会出现漏光的缝。

柱子用两个 Cube 拉高：Location 设为 (1200,1200,400)，Scale 设为 (1,1,8)，得到一根 8 米高的柱子。另一根放到对称位置 (-1200,-1200,400)。摆完之后选中所有体块，在 Outliner 里框选后右键 Move To Folder，建一个“Environment”文件夹收纳，避免 Outliner 里一堆Cube、Cube2、Cube3。

4.3 灯具与氛围：日光 + 天空 + 雾

基础体块搭好后，场景默认是漆黑一片（或只有很暗的环境光）。先拖一盏 Directional Light，旋转角度设为 Pitch -45、Yaw 45，模拟一个斜射的上午阳光。Intensity 先给默认值，Mobility 改成 Movable。然后拖一盏 Sky Light，Source Type 保持 Captured Scene，Mobility 改成 Movable，这时场景会明显亮起来一层。

接下来加 Sky Atmosphere，加上去之后天空会变成渐变的蓝色，效果比纯色背景自然很多。再拖一个 Exponential Height Fog，Fog Density 从 0.02 起步，慢慢往上加，雾太浓会让远处一片白，太淡又没有层次。最后拖一个 Post Process Volume，在 Details 面板里搜索“Infinite Extent”勾上，让后处理覆盖整个场景，然后可以调 Exposure（曝光）、Bloom（泛光）、Color Grading（调色）这些参数。

这一步最容易出问题的地方是曝光。UE5 默认开启自动曝光，从暗处走到亮处时画面会明显变亮，做场景预览时很干扰判断。可以在 Post Process Volume 里把 Metering Mode 设为 Manual，手动指定 EV100 值，画面亮度就稳定了。调试完成后记得把数值记下来，换了场景可以直接复用。

4.4 材质替换与细节调整

光照下来之后，纯灰色的体块看起来很单调。做三个材质实例：地面用一个深灰色、Roughness 0.85 的石材感；墙面用浅灰、Roughness 0.7；柱子用稍微偏暖的颜色。做法是从 Starter Content（如果创建项目时勾了的话）里找一个基础材质，右键创建实例，改 Base Color 和 Roughness 两个参数就够了。

替换材质的方式是：选中体块，在 Details 面板里找到 Static Mesh Component 下的 Materials 数组，点开把默认材质换成你做好的实例。如果体块是多个合并的，可以按材质槽位分别指定。这一步建议把所有材质的复用关系理清楚：同一个材质实例应该被多个物体共用，而不是每个物体一个实例。

细节方面可以加几样东西提升观感：给地面加一点微小的凹凸（用 Starter Content 里的法线贴图），给台子边缘加一圈稍微亮一点的颜色区分，在柱子底部加两个小方块当装饰。这些都不需要额外资源，用基础形状加材质实例就能做出来。

4.5 出生点、相机与关卡默认地图配置

从“快速添加”里拖一个 Player Start 到广场边缘，Location 设为 (0,-1800,100)，并让它朝向广场中心（Rotator 的 Z 轴设为 90）。如果用的是 Third Person 模板，运行起来就能直接控制角色走过去；如果用 Blank 模板，需要自己配一个 Game Mode 和 Pawn，新手建议直接用 Third Person 模板省事。

接下来把当前关卡保存成Content/Maps/L_FirstScene.umap，然后设置默认地图，避免下次打开编辑器进错关卡。这个设置可以在 Project Settings 的 Maps & Modes 里改，也可以直接写进配置文件。

; 文件路径：Config/DefaultEngine.ini ; 作用：指定编辑器启动地图和游戏默认地图 ; 修改后需要重启编辑器生效 [/Script/EngineSettings.GameMapsSettings] EditorStartupMap=/Game/Maps/L_FirstScene.L_FirstScene GameDefaultMap=/Game/Maps/L_FirstScene.L_FirstScene

这里的路径格式是包路径.资产名，/Game/对应磁盘上的Content/目录。写错了的表现是启动时报“地图找不到”，或者直接进一个空场景。改完 ini 之后如果没生效，先确认编辑器是不是真的重启了，再确认路径拼写和你实际的文件夹层级完全一致。

4.6 加一个蓝图交互：会亮的灯

这一步给场景加一点逻辑：玩家走近台子时，两盏路灯亮起来。做法是新建一个 Actor 蓝图，命名为BP_StreetLight，在里面放一个点光源组件和一个柱状网格体作为灯杆。然后在关卡蓝图里做距离判断。

BP_StreetLight的内部结构是：Root 用 DefaultSceneRoot，下面挂一个 Static Mesh Component（用基础圆柱体缩放成灯杆），再挂一个 Point Light Component 作为光源。把 Point Light 的 Intensity 默认设为 0（初始不亮），并把这个组件勾选为可编辑（在 Details 里点组件名旁边的“眼睛”图标，使其成为实例可编辑参数）。

核心逻辑写在关卡蓝图里，节点顺序如下：

用 Tick 做距离判断只是最直白的写法，实际项目里更推荐用Sphere Collision（球形碰撞体）加OnComponentBeginOverlap和OnComponentEndOverlap事件，只在进出范围时触发一次，不用每帧计算。新手先用 Tick 把逻辑跑通，理解了事件驱动之后再改，是比较稳的路径。

写完蓝图记得Compile（编译）和Save（保存），然后点击工具栏的 Play 运行。如果灯没亮，按顺序检查：Point Light 组件是不是真的挂上了、Intensity 是不是还是 0、Branch 的条件是不是永远为假、蓝图有没有编译通过。这四步能覆盖九成以上的“逻辑没反应”问题。

4.7 用 Python 脚本批量摆放（可选进阶）

手动摆几十个物体之后，就会想要脚本化。UE 内置了 Python 编辑器脚本插件，启用之后可以在编辑器里直接跑 Python 代码操作关卡。启用方式：Edit 菜单 → Plugins → 搜索 “Python Editor Script Plugin” → 勾选 → 重启编辑器。

下面这个脚本用引擎自带的基础形状，在广场上按网格批量摆一排柱子，演示“读资产 → 生成 Actor → 设位置/缩放/标签”这条完整链路。

# 文件路径：Content/Python/build_scene.py # 用途：在 UE 编辑器中批量生成一排柱子，演示 Python 操作关卡的基本套路 # 前提：已在 Plugins 中启用 Python Editor Script Plugin # 注意：不同 UE5 小版本的 Python API 可能略有差异，报错时按提示调整 import unreal def load_cube_mesh(): """加载引擎自带的立方体静态网格体，加载失败返回 None""" mesh = unreal.EditorAssetLibrary.load_asset("/Engine/BasicShapes/Cube.Cube") if mesh is None: unreal.log_error("未找到 /Engine/BasicShapes/Cube.Cube，请确认引擎资源完整") return mesh def spawn_cube(actor_sub, mesh, location, scale, label): """在世界中生成一个立方体，并设置位置、缩放和标签""" actor = actor_sub.spawn_actor_from_class( unreal.StaticMeshActor, unreal.Vector(location[0], location[1], location[2]), unreal.Rotator(0.0, 0.0, 0.0), ) if actor is None: unreal.log_error("生成 Actor 失败：{}".format(label)) return None # 静态网格体组件默认可能是 Static，需要改成 Movable 才能自由改位置 comp = actor.static_mesh_component comp.set_mobility(unreal.ComponentMobility.MOVABLE) comp.set_static_mesh(mesh) actor.set_actor_scale3d(unreal.Vector(scale[0], scale[1], scale[2])) actor.set_actor_label(label) return actor def build_pillars(): """在广场两侧生成两排柱子""" mesh = load_cube_mesh() if mesh is None: return actor_sub = unreal.get_editor_subsystem(unreal.EditorActorSubsystem) count = 0 for i in range(5): offset_y = -1200 + i * 600 for side in (-1, 1): location = (side * 1500, offset_y, 400) label = "SM_Pillar_{}_{}".format("L" if side < 0 else "R", i) if spawn_cube(actor_sub, mesh, location, (1.0, 1.0, 8.0), label): count += 1 unreal.log("柱子生成完成，共 {} 根".format(count)) if __name__ == "__main__": build_pillars()

保存后在编辑器里通过Tools → Execute Python Script选择这个文件运行，或者在 Output Log 的命令输入框里执行py "Content/Python/build_scene.py"。运行完可以在 Outliner 里看到一排带SM_Pillar_前缀的 Actor，说明脚本生效了。

这里有几个值得注意的点。第一，Python 操作关卡属于编辑器改动，会直接影响当前关卡文件，所以一定要先保存一次再跑，跑错了可以关掉不保存重新打开。第二，批量生成别一次性生成上千个，编辑器的 Undo 历史会吃掉大量内存。第三，spawn_actor_from_class生成出来的 Actor 默认会是可移动的，但静态网格体组件自己可能还是 Static，所以脚本里显式设了 Mobility，否则后续改位置会报错。

4.8 运行验证与性能初检

点击 Play 之后，编辑器会进入运行模式，右上角有一个性能提示按钮。要看到具体数字，需要打开控制台命令。按波浪键~打开命令行，输入下面的命令：

stat fps stat unit stat rhi

stat fps显示当前帧率和单帧耗时。stat unit把一帧拆成 Frame、Game、Draw、GPU 四项，能快速定位瓶颈在哪：Game 高说明逻辑或蓝图太重，Draw 高说明绘制调用太多，GPU 高说明渲染负载大。stat rhi显示显存占用、绘制调用次数、三角形数量这些底层数据。新手最该看的是stat unit，因为它能一眼看出“卡在哪”。

跑完之后再做一次开关对比：把后处理体积禁用，看帧率变化多少；把雾关掉，看变化多少；把灯从 Movable 改成 Static，看变化多少。这个对比过程比记住任何数字都有用，因为它建立的是“哪个操作对应多少开销”的直觉。做完对比记得把参数改回去。

5. 常见问题与排查清单

5.1 高频问题速查表

5.2 三个典型故障的逐步排查

第一个故障：材质变成紫色方块。这在 UE 里几乎等同于“材质编译失败”的信号。排查顺序是：打开这个材质，看节点图里有没有带红色感叹号的节点；如果有，检查它引用的贴图资产是不是被删了或者路径变了；如果没有错误节点，就点工具栏的 Apply 强制重新编译一次，然后看 Output Log 里有没有具体报错。常见原因还包括材质里用了当前平台不支持的特性，比如在移动端预览下用了桌面端才有的节点。

第二个故障：运行后角色直接掉出地图。这说明 Player Start 位置不对，或者地面没有碰撞。先确认 Player Start 的 Z 坐标在地面之上，再选中地面，在 Details 面板里检查 Static Mesh Component 的Collision Presets是不是被设成了 NoCollision。基础形状默认带碰撞，但如果手动改过，很容易忘。还有一种情况是地面用了 Plane 而不是 Cube，Plane 默认是单向的，掉下去之后就上不来了。

第三个故障：灯光效果和编辑器预览不一致。这通常是自动曝光在作怪。编辑器视口和运行时的曝光计算方式不完全一样，尤其是从暗处看向亮处时。解决办法是在 Post Process Volume 里把 Metering Mode 改成 Manual，手动锁定 EV100，这样编辑器和运行时看到的就是同一套亮度。另外，Sky Light 如果用的是 SLS Captured Scene，在场景大幅改动之后需要重新 Capture，否则环境光还是旧的样子。

5.3 保存、崩溃与资产丢失

UE 在编辑过程中会生成自动保存文件，位置在工程的Saved/Autosaves/目录下，崩溃后重新打开编辑器会弹出恢复提示。这个机制有用但不能依赖，因为自动保存的间隔可能比你想象的久。真正的保险是版本管理：工程目录用 Git 管理，大文件走 Git LFS，每次做完一个阶段性成果就提交一次。

还有一个容易丢资产的地方是重命名和移动。在 Content Browser 里重命名资产，引擎会自动修复引用；但如果在操作系统的文件管理器里直接改文件名，引用就会全部断掉，场景里一堆紫色方块。所以任何资产操作都必须在编辑器内完成，这条规矩一定要守住。

6. 最佳实践与工程建议

6.1 命名与目录规范

命名规范的价值在项目变大之后会指数级放大。除了前面说的前缀约定，还有两个细节值得注意。一是关卡命名带用途和序号，比如L_City_Demo_01、L_Indoor_Test_02，比NewMap、NewMap2强太多。二是蓝图命名体现职责，BP_Door_Auto、BP_Light_Street、BP_Trigger_Area，一看就知道是干什么的。

目录规划上，除了按类型分，还建议按功能模块再分一层。比如Meshes/Architecture/和Meshes/Props/，Materials/Environment/和Materials/Character/。这样多人协作时不容易撞车。项目后期如果要做资源打包和按需加载，模块化的目录结构也能直接映射成资源包。

6.2 光照与性能预算

场景搭建阶段就应该建立性能意识。几个实用的经验：单个场景的绘制调用（Draw Calls）控制在几千以内比较稳，三角形总量控制在几百万量级，实时阴影的投影灯数量尽量控制在个位数。这些数字不是硬性标准，而是用来建立心理基准线的参考值，具体要看目标平台。

优化手段上，优先级从高到低大致是：减少不必要的实时光源、把远处的物体合并（Merge Actors）、开启实例化静态网格体（Instanced Static Mesh）批量渲染重复物体、用 Nanite 处理高面数模型、用 LOD 处理中远景。新手最该先做的是第一条，因为每多一盏投射阴影的可移动灯，开销都是成倍增长的。

还有一点容易被忽略：后处理的成本。Bloom、景深、运动模糊这些效果单个看起来不贵，叠在一起就明显了。做演示场景时可以把这些先关掉跑一遍，看看基础帧率是多少，再逐个打开对比，心里就有数了。

6.3 版本管理与团队协作

UE 工程的版本管理必须处理二进制文件。.umap、.uasset都是二进制，Git 本身没法合并，必须配 Git LFS。配置方式是在工程根目录的.gitattributes里加规则：

# 文件路径：.gitattributes # 作用：让 Git LFS 接管 UE 的二进制资产，避免仓库体积爆炸 *.uasset filter=lfs diff=lfs merge=lfs -text *.umap filter=lfs diff=lfs merge=lfs -text *.png filter=lfs diff=lfs merge=lfs -text *.jpg filter=lfs diff=lfs merge=lfs -text *.wav filter=lfs diff=lfs merge=lfs -text *.fbx filter=lfs diff=lfs merge=lfs -text

工程里还有几个目录不该进版本库：Binaries/、DerivedDataCache/、Intermediate/、Saved/。这些是编译产物和缓存，每次生成都不同，提交进去只会把仓库撑爆。用引擎自带的.gitignore模板就够，新建工程时可以勾选生成。

团队协作上，最重要的规矩是同一个关卡同一时间只让一个人编辑。二进制文件没法合并，两个人同时改一张地图，后提交的人会覆盖前一个人的所有工作。大项目一般都是按子关卡拆分，每人负责一块。

6.4 从“能看”到“能上线”的检查项

场景在编辑器里好看，和能交付是两回事。交付前值得走一遍这几项检查：在最低目标配置的机器上跑一遍，看帧率是否达标；完整走一遍打包流程，确认打包后没有贴图丢失、材质变紫、关卡加载失败；检查所有资产的引用是否完整（Content Browser 里可以用 Reference Viewer 查看引用关系）；确认没有测试用的临时 Actor 和调试日志残留；确认自动曝光、后处理参数在不同亮度环境下都合理。

安全边界方面，涉及批量修改资产的脚本和编辑器工具，一定要先在项目副本上验证，确认无误再对正式工程执行。涉及团队共享的关卡和资产，修改前先拉取最新版本，改完立刻提交，减少冲突窗口。这些习惯看起来啰嗦，但真的能省下大量返工时间。

7. 总结与学习路线

7.1 这次搭场景真正需要记住的东西

回顾整条链路，真正决定成败的其实就几件事：搞清 Actor 和 Component 的关系，知道一切搭建动作都是在往关卡里加 Actor；建立一套能立刻生效的光照组合（定向光 + 天空光 + 天空大气 + 雾），并且把 Mobility 全设成 Movable；坚持用材质实例而不是复制母材质；养成摆几步就保存、每完成一个阶段就提交版本的习惯；每加完一批东西就跑一次stat unit看看开销。

这几个点覆盖了新手阶段绝大部分的“卡住”场景。剩下的什么高级材质、Niagara 粒子、Sequencer 过场动画，都是在这些基础之上叠加的，基础不牢的时候学那些只会更乱。

7.2 接下来可以往哪几个方向深入

第一个方向是光照与渲染。把 Lumen 的工作原理、反射的几种模式、后处理的各个参数搞明白，场景的观感会有质的提升。第二个方向是蓝图与交互。从距离判断、碰撞事件这些基础节点开始，逐步过渡到自定义事件、蓝图接口、Actor 组件化，最后能做到不写一行 C++ 也能做出完整的小玩法。

第三个方向是性能优化。学会用 Unreal Insights 抓帧分析，理解绘制调用、遮挡剔除、LOD、Nanite 各自的适用边界。第四个方向是资产管线。了解从建模软件导出 FBX/glTF 到引擎的完整流程、UV 和光照贴图的规范、材质命名约定，这些是团队协作的硬通货。

7.3 给刚上手的三条实操建议

第一条，从小场景开始，别一上来就做开放世界。一个 40 米见方的广场足够练完所有基础操作，做完再扩大规模，比一开始就铺一张大地图然后卡到没法编辑要高效得多。第二条，每学一个新功能就回到自己的场景里用一遍，看教程不动手是最容易忘的。第三条，遇到问题先看 Output Log，UE 的报错信息大部分时候都直接告诉你哪个资产、哪个节点、哪一行出了问题，比在网上乱搜快得多。

最后留一个小练习：把你搭的这个广场场景，改成夜晚版本。需要调整定向光的角度和强度、把天空大气的参数往冷色调偏、加上几盏点光源做路灯、用后处理体积把整体色调压暗。这个改动涉及光照、材质、后处理三块内容，做完之后对 UE 的场景系统会有一个更立体的认识。如果过程中遇到本文没覆盖的问题，欢迎在评论区贴出 Output Log 的报错信息，一起看看。