本部分将介绍 Visual Studio Tools for Unity 常见问题的解决方案、已知问题的说明并了解如何通过报告错误来帮助改进 Visual Studio Tools for Unity。

在 Unity 菜单中，选择“Edit / Preferences”。

根据所使用的 Unity 版本：

有关详细信息，请查阅 Unity 首选项文档。

此问题可能是由 Visual Studio MEF 缓存损坏导致的。

尝试删除以下文件夹以重置 MEF 缓存（执行此操作之前请关闭 Visual Studio）：

这样应该能够解决问题。 如果仍然有问题，请以管理员身份运行 Visual Studio 的开发人员命令提示，并使用以下命令：

Parse、FMOD、UMP (Universal Media Player)、ZFBrowser 或嵌入式浏览器等几个 Unity 插件使用本机线程。 插件在最后将本机线程附加到运行时，阻止了对操作系统的调用，这时就会出现问题。 这意味着 Unity 不能对调试程序（或域重载）中断该线程并停止响应。

有一种解决方法适合 FMOD：通过传递 FMOD_STUDIO_INIT_SYNCHRONOUS_UPDATE 初始化标记来禁用异步处理，并对主线程执行所有处理。

如果要开发自己的本机插件，建议使用异步过程调用 (APC)，尤其是 SleepEx、SignalObjectAndWait、MsgWaitForMultipleObjectsEx、WaitForMultipleObjectsEx 或 WaitForSingleObjectEx 函数，以便在调试器需要挂起线程时正确与 Unity 和 Mono 配合工作。

非常重要的一点是，Visual Studio 在项目设置中保存了“不兼容”状态，除非你显式使用 Reload Project，否则它不会尝试重新加载项目。 因此，在执行每个故障排除步骤后，请确保尝试重新打开解决方案，然后尝试右键单击所有不兼容的项目并选择“Reload Project”。

请勿直接从资产处理器或任何其他工具接触项目文件。 如果确实需要对项目文件进行操作，我们为此公开了 API。 请检查程序集引用问题部分。

如果遇到其他重载或 Visual Studio 在重载时丢失所有打开的窗口，请确保安装有合适的 .NET 目标包。 查看以下部分，了解有关框架的详细信息。

使用旧版 Unity 运行时（.NET 3.5 等效版本）情况下，未处理异常时（在 try/catch 块外部），调试程序将始终中断。 如果已处理了异常，则调试程序将使用异常设置窗口来确定是否需要中断。

借助新的运行时（.NET 4.6 等效版本），Unity 引入了一种管理用户异常的新方法，因此即使所有异常都在 try/catch 块外部，也会将这些异常视为“用户已处理”。 这就是希望调试程序中断时，需要在“异常设置”窗口显式检查它们的原因。

在“异常设置”窗口（“调试”>“窗口”>“异常设置”）中，针对某个类别的异常（例如，表示 .NET 异常的公共语言运行时异常）展开节点，并选中想要在该类别中捕获的特定异常的复选框（例如，System.NullReferenceException）。 还可以选择整个类别的异常。

当使用旧版 Unity 运行时（相当于 .NET 3.5）时，需要为 Visual Studio Tools for Unity 安装 .NET Framework 3.5（默认情况下 Windows 8 或 10 上未安装）。 若要解决此问题，请按照说明下载并安装 .NET framework 3.5。

使用新的 Unity 运行时还需要 .NET 目标包版本 4.6 或 4.7.1，具体取决于 Unity 版本。 可以使用 Visual Studio 安装程序快速安装它们（修改安装、单个组件、.NET 类别，并选择所有 4.x 目标包）。

如果项目中存在复杂引用，或者如果希望能更好地控制此生成步骤，可以使用我们的 API 来操作生成的项目或解决方案内容。 也可以在 Unity 项目中使用响应文件，我们将对它们进行处理。

使用最新的 Visual Studio 和 Unity 版本时，最好的方法就是使用自定义 Directory.Build.props 文件和生成的项目。 然后，你将能够在不干扰生成过程的情况下参与项目结构。

如果 Visual Studio 无法找到特定断点的源位置，系统会在断点附近显示一条警告消息。 检查当前的 Unity 场景中是否已正确加载/使用你正在使用的脚本。

检查当前的 Unity 场景中是否已正确加载/使用你正在使用的脚本。 退出 Visual Studio 和 Unity，然后删除生成的所有文件（.csproj、.sln）、.vs 文件夹和整个“库”文件夹。 有关 C# 调试的详细信息，请参阅 Unity 网站。

我们使用多播进行播放器检测（这是 Unity 使用的默认机制），但之后我们会使用常规 TCP 连接来附加调试器。 检测阶段是 Android 设备的主要问题。

Wifi 是通用的，但与 USB 比起来非常慢，因为存在延迟。 我们已经了解，某些路由器或设备缺少正确多播支持（众所周知，Nexus 系列就存在这个问题）。

USB 调试速度非常快，Visual Studio Tools for Unity 现可检测 USB 设备，并与 adb 服务器对话，使其正确转接接口以进行调试。

尝试将 Visual Studio 升级到最新版本。 尝试执行与不兼容的项目相同的故障排除步骤。

在 Visual Studio Tools for Unity 中存在一些已知问题，是由调试器与 Unity 的旧版本的 C# 编译器的交互方式导致的。 我们正设法帮助解决这些问题，但在此期间，你可能会遇到以下问题：

在调试时，Unity 有时会崩溃。

在调试时，Unity 有时会冻结。

有时单步执行和跳出方法的方式不正确，尤其是在迭代器中或在 switch 语句内。

请在遇到崩溃、冻结或其他错误时发送错误报告以帮助我们改进 Visual Studio Tools for Unity 的质量。 这可以帮助我们调查并修复 Visual Studio Tools for Unity 中的问题。 谢谢！

有报告表明使用 Visual Studio Tools for Unity 进行调试时 Visual Studio 有时会冻结，但我们需要更多的数据来了解这个问题。 你可以通过执行下面的步骤来帮助我们调查。

在 Windows 上：

打开 Visual Studio 的新实例。

打开“附加到进程”对话框。 在 Visual Studio 的新实例中的主菜单上，选择“调试” 、“附加到进程” 。

将调试器附加到 Visual Studio 的已冻结的实例。 在“附加到进程” 对话框中，从“可用进程” 表中选择 Visual Studio 的已冻结实例，然后选择“附加” 按钮。

暂停调试器。 在 Visual Studio 的新实例中的主菜单上，依次选择“调试”、“全部中断”或只需按 Ctrl + Alt + Break 即可 。

创建线程转储。 在命令窗口中，输入以下命令并按 Enter：

你可能首先需要使“命令” 窗口可见。 在 Visual Studio 中的主菜单上，选择“视图” 、“其他窗口” 、“命令窗口” 。

在 Mac 上：

打开终端并获取 Visual Studio for Mac 的 PID：

启动 lldb 调试程序：

使用 PID 附加到 Visual Studio for Mac 实例：

检索所有线程的 stacktrace：

最后，将线程转储以及 Visual Studio 冻结时你正在执行的操作的说明一起发送到 [email protected]。