使用 Live Share 在 Visual Studio Code 中协作

已准备好开始使用 Visual Studio Code 中的 Live Share 进行协作? 在本文中,我们将演练如何使用 Live Share 扩展在 Visual Studio Code 中设置协作会话。

请注意,此处介绍的协作活动涉及到一个协作会话主持人和一个或多个来宾。 主持人是发起协作会话的人,加入会话的其他人均为来宾。

需要简要了解?请查看共享加入快速入门。

提示

你知道吗,你可以加入自己的协作会话? 这样就能自己试用 Live Share 或启动 Visual Studio 或 Visual Studio Code 的实例并远程连接到它。 甚至可以在这两个实例中使用相同的标识。 试一试吧!

先决条件

在开始之前,你需要具备受支持的 Visual Studio Code 版本来满足 Live Share 的核心要求。

需要安装运行以下操作系统之一的 Visual Studio Code(1.22.0 或更高版本):

  • Windows:7、8.1 或 10。

  • macOS:Sierra (10.12) 及更高版本。 由于 .NET Core 2.0 要求,目前不支持 El Capitan (10.11) 及更早版本。

  • Linux:64 位 Ubuntu Desktop 16.04 及更高版本、Fedora Workstation 27 及更高版本或 CentOS 7。

安装 Live Share 扩展包

下载和使用 Visual Studio Live Share 即表示你同意许可条款隐私声明。 如果遇到问题,请参阅疑难解答

  1. 安装 Visual Studio Code
  2. 从市场下载并安装 Visual Studio Live Share 扩展包。
  3. 重载 Visual Studio Code。
  4. 等待依赖项完成下载和安装。 (参考状态栏。)
    屏幕截图显示了下载期间的状态栏。
  5. 仅限 Linux:如果看到有关安装缺少库的通知:
    1. 选择通知中的“安装”。
    2. 在系统提示时输入你的管理员 (sudo) 密码。
    3. 安装完成后,重启 Visual Studio Code。

用于下载 Live Share 的按钮。

Linux 安装步骤

Linux 是一个高度可变的环境。 考虑到桌面环境和分发版的数量,安装 Live Share 可能很复杂。 如果使用受支持的 Ubuntu Desktop(16.04 及更高版本)、Fedora Workstation(27 及更高版本)或 CentOS 7 版本,并仅使用 Visual Studio Code 正式分发版,过程应很简单。 如果使用非标准配置或下游分发版,则可能会遇到复杂情况。 请参阅 Linux 安装详细信息,了解详细信息。

安装 Linux 系统必备组件

某些 Linux 分发版缺少 Live Share 所需的库。 默认情况下,Live Share 会尝试检测和安装 Linux 系统必备组件。 如果 Live Share 遇到因缺少库导致的问题,你将看到一条通知,提示你安装库:

缺少 Linux 库的通知的屏幕截图。

选择“安装”时,将打开终端窗口。 输入管理员 (sudo) 密码以继续。 如果安装成功完成,请重启 Visual Studio Code。 现在应准备就绪。 你可能还想要查看分发版提示以了解更多提示和解决方法。

如果看到一条指示脚本不支持你的分发版的消息,请参阅适用于社区支持的分发版的提示,了解社区已与我们共享的信息。

如果你不希望 Visual Studio Code 为你运行命令,也可以通过在“终端”窗口中运行以下命令,随时选择重新运行此脚本的最新版本:

wget -O ~/vsls-reqs https://aka.ms/vsls-linux-prereq-script && chmod +x ~/vsls-reqs && ~/vsls-reqs

Linux 浏览器集成

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

在某些罕见的分发版上,系统可能提示输入你的管理员 (sudo) 密码以完成安装。 随即出现一个终端窗口,显示将要安装浏览器启动器的位置。 在出现提示时输入你的密码,并在安装完成后选择 Enter 即可关闭该终端窗口。

有关为何需要密码以及 Live Share 放置文件的位置的信息,请参阅 Linux 浏览器集成。 如果无法使浏览器集成正常工作,仍可以手动加入协作会话

登录到 Live Share

若要进行协作,需要登录到 Visual Studio Live Share,以便每个人都知道你的身份。 这是一项安全措施,不会让你参与市场营销活动或其他研究活动。 可以使用 Microsoft 个人帐户登录(例如 @outlook.com)、Microsoft 支持的工作或学校帐户 (Azure Active Directory) 帐户或 GitHub 帐户。 登录操作很简单。

选择状态栏上的“Live Share”,或选择“Ctrl+Shift+P”或“Cmd+Shift+P”,然后选择“Live Share: 使用浏览器登录”。

显示 Visual Studio Code“登录”按钮的屏幕截图。

将显示一条通知,提示你使用 Web 浏览器登录。 选择“启动登录”时,将打开一个浏览器,以便完成登录过程。 完成后,只需关闭浏览器即可。

显示提示使用 Web 浏览器登录的通知的屏幕截图。

备注

Linux 用户:如果使用的是旧版 Live Share(0.3.295 或更低版本),系统可能会提示你输入用户代码。 请更新到最新版扩展,或者在登录后选择“遇到问题?”链接以查看代码。 有关详细信息,请参阅使用用户代码登录

高级提示:通过 liveshare.accountliveshare.accountProvider 设置,可选择在缓存了凭据供多个帐户使用时应使用哪个帐户进行自动登录。 例如,假设你处理两个项目,并且希望使用不同的标识登录到它们。 在 Visual Studio Code 工作区设置中,可以在每个项目目录中将 liveshare.account 设置为不同的电子邮件地址。 然后,项目将自动使用正确的帐户登录。 如果你向多个提供商使用同一电子邮件地址,可以将 liveshare.accountProvider 设置设为 "microsoft""github"

在浏览器中完成登录过程后,如果 Visual Studio Code 未使你登录,请参阅使用用户代码登录。 或者查看疑难解答,了解更多提示。

使用用户代码登录

如果 Visual Studio Code 未选取已完成登录,可以改为输入用户代码。

  1. 选择 Ctrl+Shift+P 或 Cmd+Shift+P,然后运行“Live Share: 使用用户代码登录”命令。

  2. 随即打开浏览器。 使用它完成登录过程:

    备注

    如果浏览器未自动打开,请转到 https://insiders.liveshare.vsengsaas.visualstudio.com/auth/login 并登录。

  3. 完成后,选择“遇到问题? 单击此处了解用户代码说明”,以查看用户代码。

    显示浏览器窗口中用户代码的屏幕截图。

  4. 复制用户代码。

  5. 将用户代码粘贴到运行命令时出现的输入字段中。 选择 Enter 完成登录过程。

    显示用户代码输入框的屏幕截图。

查找 Live Share 命令

在 Live Share Viewlet 中

安装 Visual Studio Live Share 后,自定义选项卡将显示在 Visual Studio Code 活动栏中。 在此选项卡中,可以访问所有 Live Share 功能以进行协作。 当你共享或加入协作会话时,“资源管理器”选项卡中还会显示一个视图,可以通过该视图访问这些功能。

Screenshot that shows the Live Share tab in Visual Studio Code. Screenshot that shows the Explorer tab in Visual Studio Code.

通过使用这些视图,可以在共享代码中看到参与者的位置、选择参与者以追随他们、关注参与者、访问共享服务器和终端等。

在范围命令菜单中

所有 Visual Studio Live Share 功能也可以从 Visual Studio Code 命令面板中获得。 可以通过选择 Ctrl+Shift+P / Cmd+Shift+P 或 F1 来访问命令面板。 可以通过输入“live share”找到命令的完整列表。

由于此列表可能很长,因此从状态栏中使用作用域内的命令菜单可能更容易。 选择状态栏中的登录/会话状态按钮将显示可供使用的命令的上下文列表:

显示 Visual Studio Code“会话状态”按钮的屏幕截图。

启动和停止会话

下载并安装 Visual Studio Live Share 后,请执行以下步骤以启动协作会话并邀请同事与你协作。

  1. 登录

    安装 Live Share 扩展后,重新加载并等待依赖项安装,登录以让其他协作者知道你的身份。 有关详细信息,请参阅登录

  2. 打开文件夹

    使用常规工作流打开你想要与来宾共享的文件夹、项目或解决方案。

  3. [可选] 更新隐藏的或排除的文件

    Live Share 默认对来宾隐藏在 .gitignore 文件(位于你的共享文件夹中)中引用的任何文件/文件夹。 隐藏文件可防止它显示在来宾的文件树中。 排除文件会应用更严格的规则。 排除文件将阻止 Live Share 在某些情况下(例如转到定义时,或者在进行调试或被他人“关注”时进入文件的情况)为来宾打开文件。 若要隐藏或排除文件,请向项目添加具有相应设置的 .vsls.json 文件。 有关详细信息,请参阅控制文件的访问和可见性

  4. 启动协作会话

    要启动会话,选择状态栏上的“Live Share”,或选择“Ctrl+Shift+P”或“Cmd+Shift+P”,然后选择“Live Share: 启动浏览器会话(共享)”。

    显示“Live Share”按钮的屏幕截图。

    备注

    首次共享时,桌面防火墙软件可能会要求你允许 Live Share 代理打开端口。 可以根据需要打开端口。 当协作者和你位于同一网络上时,接受共享就能通过安全的“直接模式”来提高性能。 有关详细信息,请参阅更改连接类型

    邀请链接将自动复制到剪贴板。 在浏览器中打开此链接后,将允许其他人加入共享文件夹内容的新协作会话中。

    你还会看到“Live Share”状态栏项发生变化以反映会话状态。 若要了解其外观,请参阅本文后面的会话状态信息。

    如果在开始共享后需要再次获取邀请链接,可以通过选择会话状态状态栏项,然后选择“邀请其他人(复制链接)”来获取链接。

  5. [可选] 启用只读模式

    启动协作会话后,可以将会话设置为只读,以防止来宾编辑正在共享的代码。

    共享后,你将收到通知,告知你邀请链接已复制到剪贴板。 然后,可以选择将会话设为只读会话的选项:

    显示“设为只读”按钮的屏幕截图。

  6. 向某人发送链接

    通过电子邮件、Slack、Skype 或其他平台将链接发送给要邀请的来宾。 考虑到 Live Share 会话可以为来宾提供的访问级别,只能与信任的人共享,并应充分考虑共享内容的影响。

    安全提示:想了解一些 Live Share 功能的安全性意义吗? 请查看安全性一文。

    邀请的来宾可能有问题。 快速入门:加入第一个会话一文,其中介绍了如何以来宾身份开始。

  7. [可选] 批准来宾

    默认情况下,来宾会自动加入协作会话,并且系统会在来宾准备好协作时通知你。 此通知提供了从会话中删除他们的选项。 还可以选择要求对加入的任何人进行显式批准。

    若要启用此批准,请向 settings.js 添加以下代码:

    "liveshare.guestApprovalRequired": true
    

    启用此设置后,系统会在来宾尝试加入会话时发出通知,提示你批准其加入:

    显示 Visual Studio Code 加入批准请求的屏幕截图。

    请参阅邀请和加入访问,详细了解更多邀请安全注意事项。

就这么简单!

停止协作会话

作为主持人,你可以完全停止共享,并随时结束协作会话。 为此,请在“资源管理器”选项卡或“VS Live Share”选项卡上打开“Live Share”视图,然后选择“停止协作会话”按钮:

显示“停止协作会话”按钮的屏幕截图。

所有来宾都会收到会话已结束的通知。 会话结束后,来宾将无法访问内容。 将自动清理任何临时文件。

共享时遇到问题? 请参阅疑难解答一文。

加入和退出会话

下载和安装 Visual Studio Live Share 后,来宾只需执行几个步骤即可加入托管的协作会话。 有两种加入方法:通过浏览器加入手动加入

安全提示:加入协作会话的来宾需要了解,主持人可能会限制他们对某些文件或功能的访问。 想了解 Live Share 功能和设置的安全性意义吗? 请查看安全性一文。

通过浏览器加入

加入协作会话的最简单方式是在 Web 浏览器中打开邀请链接。 下面是需要执行的操作:

  1. 登录

    安装 Live Share 扩展后,重新加载并等待依赖项安装,登录以让其他协作者知道你的身份。 有关详细信息,请参阅登录

  2. 选择邀请链接/在浏览器中打开邀请

    只需在浏览器中打开(或重新打开)邀请链接即可。

    备注

    如果尚未安装 Live Share 扩展,则会获取市场链接。 安装扩展并重启选定的工具,然后重试。

    系统会显示一条通知,指示浏览器要启动已为 Live Share 启动的工具。 如果允许它启动该工具,则启动时你将连接到协作会话。

    显示浏览器中的加入页的屏幕截图。

    如果主持人处于离线状态,系统会通知你。 然后,可以联系主持人,并要求其再次共享。

    备注

    请确保在安装 Visual Studio Live Share 扩展后已至少启动工具一次,并允许安装完成,然后再打开/重新打开邀请页。 仍有问题? 请参阅手动加入

  3. 协作

    就这么简单! 稍后,你将连接到协作会话并可以开始进行协作。

    将看到“Live Share”按钮发生变化以反映“会话状态”。 请参阅本文后面的会话状态,了解相关信息。

    加入完成后,你将自动转到主持人当前正在编辑的文件。

手动加入

还可以手动加入,而无需使用 Web 浏览器。 当你想要使用的工具已在运行、想要使用不常用的工具,或者无法使邀请链接正常工作时,此选项非常有用。 手动加入的过程很简单:

  1. 登录

    安装 Live Share 扩展后,重新加载并等待依赖项安装,登录以让其他协作者知道你的身份。 有关详细信息,请参阅登录

  2. 使用加入命令

    在 Visual Studio Code 活动栏中打开“Live Share”选项卡,选择“加入协作会话”按钮或项:

    显示“加入协作会话”按钮的屏幕截图。

  3. 粘贴邀请链接

    粘贴收到的邀请 URL 并选择 Enter 确认。

  4. 协作!

    就这么简单! 应该很快就可以连接到协作会话。

    “Live Share”按钮将发生变化以反映会话状态。 请参阅本文后面的会话状态,了解相关信息。

    加入完成后,你将自动转到主持人当前正在编辑的文件。

离开协作会话

作为来宾,只需关闭 Visual Studio Code 窗口即可离开协作会话,不会为其他人结束协作会话。 如果你希望使窗口保持打开状态,可以打开 Live Share“资源管理器”选项卡或“VS Live Share”选项卡,然后选择“离开协作会话”按钮:

显示“离开协作会话”按钮的屏幕截图。

将自动清除任何临时文件,因此不需要执行任何其他操作。

加入时遇到问题? 请查看疑难解答

共同编辑

备注

共同编辑在某些语言中存在限制。 有关特定于语言的功能的信息,请参阅平台支持

来宾加入协作会话后,所有协作者将立即能够看到各自实时编辑和选择的内容。 从文件资源管理器中选取一个文件并开始进行编辑即可。 在你进行编辑时,主持人和来宾都能看到编辑内容且能够自行编辑,以便于迭代和快速解决问题。

显示共同编辑会话的屏幕截图。

备注

加入只读协作会话的来宾不能对文件进行编辑。 主持人可以在来宾共享会话时启用只读模式。 来宾可以通过查看自己的会话状态了解是否已加入只读会话。

参与者可以查看光标和编辑。 他们还可以查看你所做的选择。 这便于突出显示可能存在的问题或传达想法。

显示所选代码的屏幕截图。

你和其他参与者可以访问共享项目中的任何文件。 可以共同编辑,也可以独立进行编辑,这样的话,就可以在调查、稍作更改和进行完整的协作编辑之间无缝切换。

所生成的编辑在保存后将保留在支持人计算机上。 因此完成编辑后,无需同步、推送或发送文件。

安全提示:由于所有参与者都可以独立访问和编辑文件,作为主持人,你可能想要在项目中限制来宾可以通过 .vsls.json 文件访问的文件。 作为来宾,你应该意识到可能由于这些设置而导致无法查看某些文件。 有关详细信息,请参阅控制文件的访问和可见性

更改参与者标志行为

默认情况下,在光标悬停或参与者进行编辑、突出显示某些内容或移动光标时,Visual Studio Live Share 会自动在参与者的光标旁显示标志。 在某些情况下,你可能希望更改此行为。

若要更改此行为,请打开 settings.js(“文件” > “首选项” > “设置”),添加以下行之一,然后重新启动 Visual Studio Code。

设置 行为
"liveshare.nameTagVisibility":"Never" 只有在悬停光标时,标记才可见。
"liveshare.nameTagVisibility":"Activity" 这是默认值。 标记在悬停光标时或在参与者编辑、突出显示或移动光标时可见。
"liveshare.nameTagVisibility":"Always" 标记始终可见。

查找和列出参与者

若要快速查看协作会话中的参与者,请查看 Live Share“资源管理器”选项卡或“VS Live Share”选项卡上的参与者列表:

显示会话中参与者的屏幕截图。

若要在活动编辑器组中关注此列表中的任何参与者,请选择该参与者。

此外,还可以选择 Ctrl+Shift+P 或 Cmd+Shift+P,然后选择“Live Share: 列出参与者”,或者选择显示会话中的参与者数目的状态栏项:

显示状态栏项的屏幕截图。

随即将显示会话中的所有参与者的列表。 此处的行为不同于图钉按钮的行为。 即使在会话中除你之外只有一个参与者,也会显示此列表,便于你始终快速查看其他人所在的位置。 和图钉按钮一样,可以选取列表中的参与者来关注他们。 如果要改为退出,请选择“Esc”。

跟随协作者进行了解

有时,你需要解释范围涉及代码中多个文件或位置的问题或设计。 在这些情况下,临时关注同事在整个项目中的操作非常有用。 为此,在加入协作会话时,你将自动关注主持人。 在关注某个参与者时,你的编辑器将保持与该人员当前打开的文件和滚动位置同步。

备注

默认情况下,Live Share 共享位于共享文件夹之外的已打开文件。 如果要更改此行为,请将 settings.json 中的 liveshare.shareExternalFiles 更改为 false

请求关注

有时,你可能希望协作会话中的所有人都能看到你正在执行的操作。 使用 Live Share,通过通知即可让每个人都能关注你,从而关注你的操作。

在 VS Code 活动栏或 Live Share“资源管理器”选项卡中打开“VS Live Share”选项卡,然后选择“关注参与者”按钮:

显示“关注参与者”按钮的屏幕截图。

协作会话中的每个人都将收到你请求获得关注的通知:

显示请求关注通知的屏幕截图。

然后,在他们准备好关注你的操作时,他们可以在通知中选择“关注”。

开始和停止追随协作者

若要开始关注参与者(主持人或来宾身份),请在 Live Share“资源管理器”选项卡上或“VS Live Share”选项卡上的参与者列表中选择参与者名称。该名称旁边的圆圈将变为实心,表示你正在关注他们:

显示关注的参与者的屏幕截图。

此外,还可以选择编辑器组右上角的图钉按钮,或者选择 Ctrl+Alt+F 或 Cmd+Alt+F。

显示图钉按钮的屏幕截图。

备注

如果协作会话中有多个人员,系统会提示你选择想要关注的参与者:

显示参与者列表的屏幕截图。

由于关注功能链接到编辑器组,因此可以使用拆分视图或网格布局,创建某个组来关注某个参与者,而另一个组不关注参与者。 通过此布局,你就能够被动关注某人,同时又能独立开展工作。 选定编辑器组后,可以在参与者列表中选择一个参与者,使该组关注这名参与者。

在拆分视图中显示两个编辑器组的屏幕截图。

为了能够从“关注模式”轻松切换并开始自行编辑,在出现以下操作之一时,你将自动停止关注:

  • 开始编辑当前处于活动状态的文件。
  • 打开其他文件。
  • 关闭当前处于活动状态的文件。

此外,可以通过再次选择图钉按钮或选择 Ctrl+Alt+F 或 Cmd+Alt+F 来显式停止关注某人。

共同调试

Visual Studio Live Share 的协作调试功能非常强大,可用于调试问题。 它支持协作体验来解决问题。 它还使你和会话中的其他参与者能够通过在主持人的计算机上提供共享调试会话,来调查可能特定于环境的问题。

安全提示:由于参与者可以独立访问和编辑文件,作为主持人,你可能想要在项目中限制来宾可以通过 .vsls.json 文件访问的文件。 还应注意,控制台/REPL 访问允许参与者在你的计算机上运行命令,因此你只应与你信任的人员进行共同调试。 来宾应认识到,由于设置了严格限制,因此在执行某些受限制的文件时,他们可能无法跟踪调试程序。 有关详细信息,请参阅控制文件的访问和可见性

使用协作调试非常简单。

  1. 请确保主持人和所有来宾都安装了相应的调试扩展。 (并非总是需要安装,但通常建议这样做。)

  2. 作为主持人,如果尚未对项目进行设置,应配置 launch.json,以便在 Visual Studio Code 中照常调试应用程序。 无需进行任何特殊设置。

  3. 主持人可以正常使用调试选项卡中的按钮开始调试:

    显示 Visual Studio Code“调试”按钮的屏幕截图。

    提示

    也可以从 Visual Studio Code 中参与 Visual Studio 调试会话,反之亦然。 有关共同调试的详细信息,请查看 Visual Studio 说明

在主持人一端附加调试程序时,系统会自动向所有来宾附加调试程序。 在主持人的计算机上有一个正在运行的调试会话,但所有参与者都被连接到该会话并具有自己的视图:

显示 Visual Studio Code 调试程序的屏幕截图。

任何人都可以逐步完成调试过程,因此无需协商控制即可在协作者之间切换。

备注

请参阅平台支持,详细了解各语言或各平台对调试功能的支持。

每个协作者都可以调查变量、在调用堆栈中访问不同文件、检查变量、甚至添加或删除断点。 借助共同编辑功能,每个参与者都可以跟踪其他参与者所在的位置,以便在同时调查问题的各个方面和协作调试之间进行切换。

备注

在只读协作会话中,来宾无法分步完成调试过程。 不过他们可以添加或删除断点并检查变量。

显示并发调试的动画。

在 Visual Studio Code 加入调试会话时进行更改

默认情况下,当主持人共享调试会话时,来宾将被自动附加到调试会话。 此行为可能会造成中断。

若要更改此行为,请打开 settings.js(“文件” > “首选项” > “设置”),添加以下行之一,然后重新启动 Visual Studio Code:

设置 行为
"liveshare.joinDebugSessionOption":"Automatic" 默认值。 来宾将自动加入由主持人启动的任何共享调试会话。
"liveshare.joinDebugSessionOption":"Prompt" 作为来宾,当主持人发起会话时,系统将提示你加入共享调试会话。
"liveshare.joinDebugSessionOption":"Manual" 来宾将需要手动加入调试会话。 请参阅分离和重新附加

分离和重新附加

作为来宾,你可能希望暂时停止调试。 可以选择调试工具栏中的“停止”图标即可分离调试程序,而不会影响主持人或其他来宾:

显示“停止”按钮的屏幕截图。

如果你已更新设置,这样就无需自动附加,或者如果只是希望稍后重新附加,可以通过选择 Ctrl+Shift+P 或 Cmd+Shift+P 或选择会话状态的状态栏项,然后选择“附加到共享调试会话”来执行此操作:

显示“附加到共享调试会话”命令的屏幕截图。

在浏览器中共享正在运行的应用程序

与 Visual Studio 不同,Visual Studio Code 不支持 ASP.NET 等项目类型的已知 Web 应用程序端口。 但是,如果你从 Visual Studio 主持人加入协作会话,则可能会在调试开始时自动看到出现的默认浏览器。 然后,浏览器会自动连接到该主持人正在运行的应用程序。 有关详细信息,请参阅 Visual Studio 功能

作为主持人,通过使用“共享本地服务器”功能手动共享应用程序或其他终结点(如 RESTful 服务),可实现类似的功能。 然后,Visual Studio 和 Visual Studio Code 来宾可以在同一 localhost 端口上打开一个浏览器,以查看正在运行的应用程序。 有关详细信息,请参阅共享服务器

共享服务器或终端

服务器共享

有时,协作会话主持人可能希望与来宾共享 Web 应用程序或其他在本地运行的服务器或服务。 其中可能包括其他 RESTful 终结点、数据库和其他服务器。 使用 Visual Studio Live Share 可以指定本地端口号、视需要为其命名,然后与所有来宾共享它。

然后,来宾可以在相同的端口上从自己的本地计算机访问你在该端口上共享的服务器。 例如,如果你共享了在端口 3000 上运行的 Web 服务器,那么来宾可以在 http://localhost:3000 上从自己的计算机访问这台正在运行的同一 Web 服务器。

此连接通过在主持人和来宾之间经过改进的安全 SSH 或 SSL 隧道完成,并通过该服务进行身份验证。 此连接机制可帮助确保只有协作会话中的人员具有访问权限。

安全提示:作为主持人,可以选择与来宾共享的端口。 建议使用应用程序端口(而不是共享系统端口)。 作为来宾,如果服务器/服务是在来宾计算机上运行的,则共享端口的行为完全相同。 此行为很有用,但如果共享错误的端口,则可能会有风险。

出于安全原因,只有在指定端口上运行的服务器才能供其他来宾使用。 协作会话主持人可以轻松添加一个端口。 下面介绍如何操作:

  1. 在“VS Live Share”选项卡或 Live Share“资源管理器”选项卡上,选择“共享服务器”项或按钮:

    显示“共享服务器”按钮的屏幕截图。

  2. 输入运行服务器的端口号。 可以选择输入一个名称:

    显示端口号提示的屏幕截图。

就这么简单! 端口上指定的服务器现在将被映射到每个来宾在同一端口上的 localhost(除非该端口已被占用)。

如果端口已在来宾的计算机上使用,则将自动选择其他端口。 作为来宾,如果在 Live Share“资源管理器”选项卡或“VS Live Share”选项卡上查看共享端口列表(按名称,如指定)。此列表位于“共享服务器”下。 如果选择某个端口,则会在浏览器中打开该服务器。 也可以右键单击并选择选项,以将服务器链接复制到剪贴板。

显示共享服务器列表的屏幕截图。

出于安全原因,来宾无法控制主持人计算机上的哪些端口是共享的。

要停止共享本地服务器,主持人可以将鼠标悬停在“共享服务器”列表中的服务器项上,然后选择“取消共享服务器”按钮:

显示“未共享服务器”按钮的屏幕截图。

终端共享

新式开发人员经常使用各种命令行工具。 Live Share 允许主持人与来宾共享终端。 共享终端可以是只读模式或完全协作模式,以便你和来宾都可以运行命令并查看结果。 可以使终端输出对来宾可见。 还可以让他们运行测试或生成,甚至对只发生在你计算机上的特定于环境的问题进行会审。

默认情况下,不会共享终端,因为它们至少向来宾授予了对你运行的命令输出的只读访问权限(如果不是由他们自己运行命令的功能)。 此默认配置允许你在本地终端中运行命令,降低风险并仅在需要时共享。 并且只有主持人可以启动共享终端。 此限制可防止来宾启动共享终端,并执行一些不需要的操作。

作为主持人,你可以从“VS Live Share”或 Live Share“资源管理器”选项卡共享终端。选择“共享终端”项或按钮:

显示“共享终端”按钮的屏幕截图。

此时,你可以选择是将终端设置为只读,还是读/写。 当终端设置为读/写时,每个人都可以向终端输入内容,包括主持人。 因此,作为主持人,你可以在来宾执行你不需要的操作时轻松进行干预。

为安全起见,只应在知道来宾实际需要时才向其授予读/写访问权限。 当你只想让来宾查看你运行的命令的输出时,建议将终端设为只读。 请记住,读/写访问权限赋予来宾与你所拥有的相同的终端访问权限。 他们可以在你的计算机上运行可以运行的任何命令。

备注

如果协作会话处于只读模式,则主持人只能共享只读终端。

显示访问级别的只读和读/写选项的屏幕截图。

在选定你想要启动的共享终端类型后,Visual Studio Code 的“终端”选项卡中就会出现一个新的共享终端:

显示 Visual Studio Code 中的“终端”选项卡的屏幕截图。

如果共享多个终端,或者如果你的焦点位于不同选项卡中,则可以通过选择“共享终端”列表中的项将焦点转移到一个终端:

显示“共享终端”列表的屏幕截图。

若要结束终端会话,输入“exit”、关闭终端窗口或选择 Live Share“资源管理器”选项卡或“VS Live Share”选项卡中的“取消共享终端”按钮,所有人都将断开连接。

会话状态和限制

开始或加入协作会话后,Visual Studio Live Share 状态栏项将反映活动会话的状态。

下面是通常会看到的状态:

状态 状态栏项 描述
非活动 VS Code 状态:非活动 无活动的协作会话。 未共享任何内容。
主持人:正在进行共享 VS Code 状态:正在进行共享 正在启动协作会话。 内容共享即将开始。
主持人:共享 VS Code 状态:共享处于活动状态 协作会话处于活动状态。 内容处于共享状态。
主持人:共享处于只读状态 VS Code 状态:共享处于只读状态 主持人正在共享只读协作会话。
来宾:正在加入会话 VS Code 状态:正在加入 来宾正在加入现有协作会话。
来宾:已加入 VS Code 状态:已加入 来宾已加入并已连接到活动协作会话且正在接收共享内容。
来宾:已加入只读会话 VS Code 状态:已加入只读会话 来宾已加入并已连接到处于活动状态的只读协作会话。

目前,虽然来宾在使用本文所述的功能时会遇到一些问题,但协作会话主持人仍保留其所选工具的完整功能。 有关详细信息,请参阅:

后续步骤

有关详细信息,请查看下面几篇文章:

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