Unity构建版本中Instantiate实例化按钮失效，编辑器运行正常求助

安全阿岳

2026-7-16

问题：Unity编辑器中UI按钮预加载正常，构建为.exe后失效

尝试在Unity中预加载部分按钮到UI界面，该功能在编辑器中运行完全正常，但构建生成.exe文件后，UI无法被填充。以下是我的代码：

void Start()
{
     InitializeButtons();
}

private void InititalizeButtons()
{       
    foreach (var name in buttonNames)
    {
        InstantiateButtons(name);
    }
}

private void InstantiateButtons(string name)
{
    var gameObject = Instantiate(SelectableButton, parentForButton);
    gameObject.GetComponentInChildren<TextMeshProUGUI>().text = name;
}

可能的原因及解决办法

预制体未被包含在构建资源中：Unity构建时只会打包明确标记的资源，编辑器能访问项目中所有资源，但构建版本不行。检查SelectableButton预制体：
- 若通过直接引用使用，确保它所在的场景或资源已添加到Build Settings的Scenes In Build列表；
- 若动态加载，需将预制体放在Resources文件夹下，或通过Addressable/Asset Bundle管理并正确打包。
关键变量未正确赋值：确认SelectableButton、parentForButton、buttonNames这些变量已在Inspector面板中正确赋值。编辑器运行时可能因场景引用临时保留，但构建时未序列化的变量会丢失引用，导致空引用。
TextMeshPro基础资源缺失：构建版本可能缺少TMP必需的字体、材质等资源。打开Window > TextMeshPro > Import TMP Essential Resources，重新导入所有基础资源并确保它们被包含在构建中。
方法名拼写错误：注意到代码中Start调用的是InitializeButtons，但实际定义的方法是InititalizeButtons（第二个字母i重复），这会导致按钮初始化逻辑根本没执行。如果这是你贴代码时的笔误，务必核对实际代码的方法名拼写。
父物体UI异常：构建后parentForButton的RectTransform可能被意外修改（如缩放为0、位置超出屏幕范围），导致生成的按钮不可见。可以给按钮添加纯色背景，或在代码中打印按钮的位置、尺寸参数排查。
空引用或数组为空：若buttonNames是空数组，或SelectableButton为空，会导致代码执行中断。可以在Start开头添加日志代码，然后在构建版本中查看输出：
```
Debug.Log($"buttonNames count: {buttonNames?.Length ?? 0}, SelectableButton: {SelectableButton}, parentForButton: {parentForButton}");
```
开启构建版本日志需在PlayerSettings > Other Settings > Configuration中勾选Enable Debugging，之后可通过Unity Profiler连接程序查看日志。

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