Visual Studio Live Share 故障排除
本文介绍故障排除提示、解决方法及常见问题和疑问的解答。 你可能还需要查看 FAQ。
安装/工具要求
以下是与安装 Visual Studio Live Share 相关的故障排除提示。
| 工具 | 问题 | 解决方案/解决方法 |
|---|---|---|
| VS Code (macOS) | 将出现一条警告，指示 .NET Core 不再支持 macOS | 出现此警告的原因是 .NET Core 最近进行了更新，不再支持低于 High Sierra (10.13+) 的任何版本。若要启用 Live Share 扩展，请更新 OS。 |
| VS | 尝试安装 Visual Studio Live Share 扩展时，扩展安装程序找不到要使用的 Visual Studio 版本。 | Visual Studio Live Share 需要用于主机和来宾的 Visual Studio 2017 版本 15.6 或更高版本。 安装最新稳定的 Visual Studio 2017 更新，然后重试。 |
| VS Code | 当扩展在首次启动时完成安装或者你收到有关缺少或已存在文件的错误时，会出现“无法安装依赖项”错误。 | 验证网络连接是否良好。 如果网络连接良好，则可能是遇到了代理或防火墙问题。 请参阅连接故障排除。 |
| VS Code | 从市场安装 Visual Studio Live Share 扩展后，它安装在 VS Code 的稳定/预览体验版中，而不是我需要的版本。 | 根据你的喜好启动 VS Code 稳定/预览体验版，单击“扩展”选项卡，搜索“Visual Studio Live Share”并从那里安装。 |
登录
下面是登录问题的故障排除提示。
| 工具 | 问题 | 解决方案/解决方法 |
|---|---|---|
| VS | 你需要使用与登录 Visual Studio 时所用的不同标识来登录 Visual Studio Live Share。 | 转到“工具”>“选项”>“Live Share”>“用户帐户”以选择备用帐户。 |
| VS Code | 虽然登录期间会弹出浏览器窗口，并且该过程在网页上似乎成功，但在关闭浏览器后，状态栏仍然显示“登录”。 | 登录后，单击“遇到了问题?”，并按照说明在工具中输入临时用户代码。 我们也很想知道可能发生了什么，因此请记录 bug。 |
| 全部 | 你收到超时或连接错误。 | 请参阅连接故障排除。 |
| 全部 | 使用 Microsoft 支持的工作或学校电子邮件地址登录时，你看到一条消息，指示“需要管理员批准”。 | Azure AD 租户设置为对访问目录内容的新应用程序需要“管理员同意”。 请参阅此处了解详细信息。 |
| VS Code (macOS) | 你在登录时看到一个错误，指示 SecKeychainAddGenericPassword() 失败。 | 这几乎总是由于 macOS 的常见问题，即密码更改未反映在登录密钥链中。 尝试进入“密钥链访问”，锁定登录密钥链，然后再次解锁它。 这可能足以解决问题，但如果无法使用当前密码解锁它，请尝试使用上一个密码。 如果有效，将登录密钥链密码更改为当前密码。 请参阅此处了解详细信息。 |
| VS Code (Linux) | 在使用 Live Share v0.3.295 或更低版本时，系统会提示你输入用户代码，但没有出现允许你获取用户代码的浏览器。 | 我们正在努力消除 Linux 上的用户代码要求。 同时，应会出现一个浏览器窗口，让你可以登录。 如果没有，浏览器窗口可能隐藏在 VS Code 下。 如果不是这种情况，请参阅下一个提示。 |
| VS Code | 单击“登录”（或使用“Live Share: 登录”命令）后，没有出现允许你输入凭据的浏览器窗口。 | 1. 在此处登录 2. 登录后，单击“遇到了问题?” 3. 按照说明在工具中输入临时用户代码。 |
| 全部 | 你想要加入一个协作会话，但没有/不想接收电子邮件更新。 | 在 VS/VS Code 中登录 Live Share 扩展不会让你选择接收电子邮件更新。 Live Share 要求来宾以安全措施登录，以便主持人能够查看已加入的来宾的标识。 如果你希望允许匿名用户（例如，没有姓名的用户/具有用户定义名称的用户）加入，请对此功能投赞成票。 |
共享和加入
下面是共享和加入问题的故障排除提示。
| 工具 | 问题 | 解决方案/解决方法 |
|---|---|---|
| 全部 | 共享/加入：你收到超时或无法连接的错误。 | 请参阅连接故障排除。 |
| VS Code | 加入：在浏览器中打开加入页后，你没有收到提示/无法启动 VS Code。 | 提示：
|
| VS | 加入：在浏览器中打开加入页后，你没有收到提示/无法启动 VS。 | 请参阅手动加入。 我们也希望看到你的日志，因此请使用 Visual Studio 的“报告问题...”功能记录 bug。 |
| 全部 | 加入：你更希望将加入链接直接粘贴到 Visual Studio/VS Code 中，而不是单击 Web 链接。 | 请参阅手动加入。 |
| 全部 | 加入：通过浏览器加入时，会显示一条消息，指示“工作区的所有者似乎处于脱机状态”。 | 可能的解决方法：
|
| VS Code | 加入：在登录前通过浏览器加入，系统未提示登录，并且从未完成加入。 | 这是一个已知 bug。 单击登录状态栏项进行登录，然后再次加入。 |
| VS Code | 共享/加入：单击“共享”和“加入”按钮时，没有任何反应。 | 在命令面板中运行命令 >Live Share：修复安装。 |
连接
以下信息可帮助你解决在登录、共享或加入时遇到的与连接或超时相关的问题。
如 Live Share 的连接要求一文中所述，不同的连接模式对功能有不同的要求，因此存在一些不同的潜在问题。
| 工具 | 问题 | 可能的原因 |
|---|---|---|
| 全部 | 你正在使用代理，遇到了许多连接问题 | 代理设置可能比较棘手。 尝试全局设置 HTTP_PROXY 和 HTTPS_PROXY 环境变量，然后重新启动工具。 有关更多详细信息，请参阅代理设置。 可能有些配置目前尚不支持，因此，如果这对你不起作用，请告诉我们。 |
| VS Code | 安装扩展并在第一次启动 VS Code 后，在状态栏中显示“完成安装”时出现错误。 | 你无法访问 Internet，或者对端口 443 上的 download.visualstudio.microsoft.com 和/或 download.microsoft.com 的访问被你的个人或公司防火墙阻止。 请参阅此处，了解为什么 Live Share 此时需要下载一些内容。 |
| 全部 | 你无法登录 Visual Studio Live Share | 你无法访问 Internet，或者对端口 80/443 上的 *.liveshare.vsengsaas.visualstudio.com 的访问被你的个人或公司防火墙阻止。 在浏览器中输入 https://visualstudio.microsoft.com/services/live-share/ 并确保进入 Visual Studio Live Share 主页。 |
| 全部 | 你处于自动模式（默认），可以登录，但在共享或加入时，看到超时或连接错误。 | 直接模式和中继模式都无法连接，或者自动模式存在 bug。 如果在切换到直接或中继模式后能够连接，请提出 bug。 |
| 全部 | 你处于直接模式，可以登录，但在共享或加入时，看到超时或连接错误。 | 来宾和主机无法直接连接。 尝试自动或中继模式，看看问题是否会消失。 你可能需要手动允许 Live Share 通过个人防火墙或只使用中继模式。 |
| 全部 | 你处于中继模式，可以登录，但在共享或加入时，收到超时或连接错误的通知。 | 个人或公司防火墙已阻止在端口 80/443 上访问 *.servicebus.windows.net。 尝试使用直接模式。 |
有关连接要求的详细信息，请参阅 Live Share 的连接要求一文。
另请参阅
快速入门
操作指南
参考
仍有问题？ 可以提供反馈。