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:启动器设置”命令。

另请参阅

遇到问题? 请参阅疑难解答提供反馈