Code inspection: Prefer GUID-based assembly references

This inspection reports assembly references in .asmdef and .asmref files that use an assembly name even though a valid GUID reference is available.

GUID references are safer because they keep working even if the referenced assembly asset is renamed.

Example

The assembly name reference is replaced with the asset GUID reference.

                {
                    "name": "Gameplay",
                    "references": [
                        "Core"
                    ]
                }
            

                {
                    "name": "Gameplay",
                    "references": [
                        "GUID:7d9f6c8edad14e1593fde9cc75764047"
                    ]
                }
            

The inspection is shown only when the name resolves successfully. Unresolved references are not converted.

26 March 2026