Linux 安装详细信息

  • 项目

Linux 环境具有很强的可变性，具有大量桌面环境和分配，使用起来比较复杂。 如果继续使用受支持的 Ubuntu Desktop（16.04 及更高版本）、CentOS 7 或 Fedora Workstation（27 及更高版本）版本并仅使用 VS Code 正式分发版，你会发现过程很简单。 但是，如果使用非标准配置或下游分发版，可能会遇到一些问题。 本文档提供了一些有关要求的信息和一些故障排除详细信息，即使你的配置仅受社区支持，它们也可能帮助你启动和运行。 注意，Live Share 仅支持 64 位 Linux。

VS Code OSS 问题

Arch Linux/Manjaro 用户：使用 visual-studio-bin AUR 包来避免此问题。

作为 VS Code OSS 的 Vanilla 版本或修改版本的 Visual Studio Code 包在 product.json 文件中可能会缺少一个临界值，而该值会阻止 Visual Studio Live Share 激活。

快速查看是否可能会遇到此问题的方法是，转至“帮助”>“切换开发人员工具”并查看是否发现表明 Live Share 扩展未激活，因为它使用了“建议的 API”的堆栈跟踪。

要验证这是你的问题，请检查 product.json 的内容。 文件的位置因包而异，但它通常位于以下位置之一：

  • /usr/share/code/resources/app/product.json
  • /usr/share/vscode/resources/app/product.json

如果 extensionAllowedProposedApi 属性缺失或“ms-vsliveshare.vsliveshare”未被引用，则你使用的 OSS 版本存在此问题。

作为一种解决方法，可以将以下内容添加到 product.json 中：

"extensionAllowedProposedApi": [
  "ms-vsliveshare.vsliveshare",
  "ms-vscode.node-debug",
  "ms-vscode.node-debug2"
]

Linux 浏览器集成

Visual Studio Live Share 通常不需要额外的安装步骤就能在 Linux 上启用浏览器集成。

为此，Live Share 会在扩展​​首次初始化时自动将桌面文件放置在 ~/.local/share/applications 中，并将所需的启动器本身放置在 ~/.local/share/vsliveshare 中。 如果成功，则无需执行任何操作。

在某些情况下，分发版不支持此位置，或者需要调整才能将其与 Vanilla 安装一起使用。 在这些情况下，Live Share 回退到改为使用 /usr/local/share。 因此，系统可能提示输入你的管理员 (sudo) 密码以完成安装过程。 随即出现一个终端窗口，显示将要安装浏览器启动器的位置。 只需在出现提示时输入你的密码，并在安装完成后按 Enter 即可关闭该终端窗口。

如果希望改为自己运行命令，可以单击“改为复制”，改为将终端命令复制到剪贴板。

最后，如果选择完全跳过此步骤，仍然可以手动加入协作会话，但将无法通过在浏览器中打开邀请链接来加入。 注意，以后可以随时再次访问该命令，方法是按 Ctrl+Shift+P/Cmd+Shift+P 并选择“Live Share：启动器设置”命令。

另请参阅

遇到问题？ 请参阅疑难解答或提供反馈。