Unity移动脚本后Prefab引用失效，如何保留引用？

一、确保正确的移动操作（预防为主） #

• 必须在Unity编辑器内拖拽脚本到目标文件夹，不要用系统资源管理器移动。Unity会自动同步.meta文件并维护GUID引用，移动后等待编辑器右下角的刷新进度条走完，再进行其他操作。
• 若用资源管理器移动，务必将脚本对应的.meta文件一并移动，且不要修改.meta文件内的guid字段——GUID是Unity识别资源的核心标识，一旦改变所有引用都会失效。

二、修复已丢失的引用 #

1. 手动重新赋值（少量Prefab） #

直接打开丢失引用的Prefab，在Inspector面板找到显示Missing Script的组件，点击组件右上角的齿轮图标选择Remove Component，再重新添加对应的脚本并赋值参数。

2. 批量修复工具（大量Prefab） #

创建一个Editor脚本实现批量修复，步骤如下：

1. 在项目中新建Editor文件夹，将以下脚本放入其中：

using UnityEditor;
using UnityEngine;

public class FixMissingScriptRefs : EditorWindow
{
    [MenuItem("Tools/Fix Missing Script References")]
    public static void LaunchTool()
    {
        GetWindow<FixMissingScriptRefs>("Fix Missing Refs");
    }

    private void OnGUI()
    {
        if (GUILayout.Button("Scan & Fix All Prefabs"))
        {
            ProcessAllPrefabs();
        }
    }

    private void ProcessAllPrefabs()
    {
        // 替换为你的脚本新路径
        string targetScriptPath = "Assets/YourNewFolder/YourScript.cs";
        MonoScript targetScript = AssetDatabase.LoadAssetAtPath<MonoScript>(targetScriptPath);
        if (targetScript == null)
        {
            Debug.LogError("Target script not found! Check the path.");
            return;
        }

        string[] prefabGuids = AssetDatabase.FindAssets("t:Prefab");
        int fixedCount = 0;

        foreach (string guid in prefabGuids)
        {
            string prefabPath = AssetDatabase.GUIDToAssetPath(guid);
            GameObject prefab = AssetDatabase.LoadAssetAtPath<GameObject>(prefabPath);
            if (prefab == null) continue;

            Component[] allComponents = prefab.GetComponentsInChildren<Component>(true);
            foreach (Component comp in allComponents)
            {
                if (comp == null) continue;

                SerializedObject serializedComp = new SerializedObject(comp);
                SerializedProperty scriptProp = serializedComp.FindProperty("m_Script");
                
                if (scriptProp.objectReferenceValue == null)
                {
                    scriptProp.objectReferenceValue = targetScript;
                    serializedComp.ApplyModifiedProperties();
                    fixedCount++;
                }
            }
        }

        AssetDatabase.SaveAssets();
        AssetDatabase.Refresh();
        Debug.Log($"Fixed {fixedCount} missing script references.");
    }
}

2. 替换脚本中的targetScriptPath为你移动后的实际脚本路径。
3. 打开Unity顶部菜单Tools -> Fix Missing Script References，点击按钮即可批量修复所有Prefab的丢失引用。

三、排查元文件GUID问题 #

1. 关闭Unity，用文本编辑器打开移动前脚本的.meta文件，记录下guid字段的值。
2. 打开移动后脚本的.meta文件，确认guid与之前记录的一致。若不一致，手动修改为原GUID，保存后重新打开Unity。

四、清理缓存与重新导入 #

• 点击Unity顶部菜单Assets -> Reimport All，强制重新导入所有资源，让Unity重建引用关系。
• 若仍无效，关闭Unity后删除项目根目录的Library文件夹（注意备份项目），重新打开项目，Unity会自动重建缓存，修复深层的引用异常。

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