企业官网建设流程全解析

UE5 风格指南避坑清单：静态网格与纹理规范一次讲透

【免费下载链接】ue5-style-guideAn attempt to make Unreal Engine 4 projects more consistent项目地址: https://gitcode.com/gh_mirrors/ue/ue5-style-guide

上次我把项目提交到 Epic Marketplace，结果一次性被打回：反馈里写着纹理尺寸不达标、资产路径太深。Epic 审核员看的不是多华丽，而是多规范。UE5 Style Guide 项目就是干这个的，它最常被拿来检查的就是静态网格与纹理规范。提交前用下面这几节过一遍坑，过审概率立刻不一样。

🖼️ 导入前：纹理的两道硬门槛

纹理进 Content 目录之前，先过两关。

第一关：宽和高都必须是 2 的幂次方。1024×512、1024×4096 都合规；1000×800 会被直接打回。

第二关：任意一边都不能超过 8192 像素。哪怕尺寸是 2 的幂，超了也一样判不合规。

唯一的例外：归属UILODGROUP 的纹理可以不做 2 的幂次方（Marketplace 规则集只给 UI 开了这个口子）。Linter 会自动判断：先做幂次方数学测试，不通过再查它的 LODGROUP 是否豁免。

动手：把不合规的纹理改成最近的幂次方尺寸（比如 1000×800 改成 1024×1024），超过 8192 的缩小后再导入。

💥 蓝图里的隐形炸弹

编译通过不等于合规。Linter 只认两种状态：没有错误、也没有警告图标。带警告的更新状态（BS_UpToDateWithWarnings）和报错一样算不过关。

第二颗炸弹是松散节点：蓝图任意一张图里，只要存在连接数为零的节点，就算违规。唯一的豁免场景是节点为示例或教程目的保留，并且必须用注释写明用途。

动手：删掉没接线的节点，或者在旁边补一条说明注释；再重新编译，确认编译按钮上没有错误和警告图标。

📁 命名与路径：审核的第一道坎

审核员第一眼看到的就是文件夹结构。所有资产都要匹配规则集里NamingConvention定义的模式；Assets、NewFolder这类含糊命名一律不行，路径里只允许英文字母、数字和下划线。

还有一条硬上限：从 Content 下的顶级文件夹名算起，资产路径不得超过 140 个字符。常见反例：

/Game/MyProject/Characters/Hero_Armor_Series_v3/Body/Mesh_HighPoly_Rigged_Final/SM_Body_01

层级一深、名字一长，这条线就踩过去了。

动手：把目录层级压平，资产名改短，然后数一遍完整路径，确认在 140 字符以内。

🚀 跑一遍 Linter，把问题拦在提交前

用法很直白：在内容浏览器里右键你的内容文件夹，选 "Scan with Linter"，挑一个规则集（上架项目一般选 Marketplace），等报告出来。

Lint Report 会按"资产数 / 错误数 / 警告数"给你总览，每一条违规都写清是哪个资产、踩了哪条规则、建议怎么改。还能导出 JSON 或 HTML 报告，也可以用命令行 commandlet 挂到 CI 里自动跑。

报告长这样：

它扫的东西覆盖：纹理尺寸与格式、蓝图松散节点和编译状态、命名一致性、路径长度与非法命名。完整规则对照见 docs/unrealguidelines.md，规则实现细节见 docs/howitworks.md。

提交前自查清单

• 纹理是 2 的幂次方尺寸，两边都不超 8192（UI LODGROUP 豁免）
• 蓝图没有松散节点，编译无错误、无警告图标
• 命名符合规范，全部路径压在 140 字符以内

别等审核打回再返工。现在就扫一遍，把违规项清零——零错误，才是进 Marketplace 的门票。✨

【免费下载链接】ue5-style-guideAn attempt to make Unreal Engine 4 projects more consistent项目地址: https://gitcode.com/gh_mirrors/ue/ue5-style-guide