如何在Unity Asset Store添加样本？资产实例添加失败排查

1. 确认Samples~目录的合规性 #

• Unity的Samples~是特殊隐藏目录，打包时会自动被排除，必须严格使用Samples~（末尾带波浪号）作为目录名，避免系统自动修改或隐藏该目录
• 检查StarterAssets子目录内是否存在有效可实例化资源（如预制体、场景文件），空目录或损坏资源会导致无法添加实例

2. 校验package.json配置 #

• 确保path字段与实际目录路径完全匹配，注意大小写（部分系统对路径大小写敏感）
• 补充package.json的必填字段：name、version、displayName是Package Manager识别包的必要项，缺失会导致包无法正常加载，示例配置如下：

  {
    "name": "com.yourname.mypackage",
    "version": "1.0.0",
    "displayName": "My Package",
    "samples": [
      {
        "displayName": "StarterAssets Example Scenes",
        "description": "Contains demo scenes with StarterAssets.",
        "path": "Samples~/StarterAssets"
      }
    ]
  }
  

• 手动检查JSON语法：确保逗号、括号闭合，无语法错误

3. 刷新Package Manager与清理缓存 #

• 打开Package Manager，点击左上角+号，选择Add package from disk...，重新选择你的package.json文件，强制刷新包识别
• 清理Package Manager缓存：找到Unity缓存目录（Windows：%USERPROFILE%/.cache/Unity/Packages；Mac：~/Library/Caches/com.UnityTechnologies.UnityEditor/Packages），删除对应包的缓存文件后重启Unity

4. 检查资源完整性 #

• 验证StarterAssets内的资源是否可正常加载：比如尝试直接打开预制体或场景，确认无引用丢失、文件损坏情况
• 若资产来自Asset Store，重新下载并替换Samples~/StarterAssets内的内容，排除下载过程中的文件损坏问题

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