共同编辑来宾加入协作会话(图)

使用加入命令

只需转到“文件”>“加入 Live Share 会话”即可

粘贴邀请链接

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

协作！

就这么简单！ 在片刻之后应该就能连接到协作会话了。

将看到“Live Share”按钮发生变化以反映“会话状态”。 请参阅下面的信息，了解具体情况。

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

离开协作会话

来宾可以通过关闭工具或单击共享/会话状态按钮并选择“离开协作会话”来离开协作会话，而不必为其他人结束协作会话。

所有临时文件都将被自动清除，因此，无需执行任何进一步操作。

在加入时遇到问题？ 请查看。

共同编辑

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

备注

加入只读协作会话可防止来宾编辑文件。 主持人可以。 来宾可以通过查看自己的了解是否已加入只读会话。

备注

共同编辑对某些语言具有少量限制。 请参阅平台支持，看看各语言可用的功能。

处于同一文件中的所有参与者除了可以看到游标和编辑内容之外，还可以看到你选择的内容。 这便于突出显示可能存在的问题或传达想法。

更棒的是，你和其他参与者可以导航到共享项目中的任何文件。 可以共同编辑，也可以独立进行编辑，这样的话，就可以在调查、进行微调和进行完整的协作编辑之间无缝切换。

备注

默认情况下，Live Share 也会共享已共享解决方案外部的已打开文件。 若要禁用此功能，请将“工具”>“选项”>“Live Share”中的“共享外部文件”更新为“False”。

生成的编辑内容在保存时保留在主持人的计算机上，因此，在完成编辑后无需同步、推送或发送文件。 编辑内容“就在那里”。

安全提示： 由于所有参与者都可以独立导航和编辑文件，作为主持人，你可能想要在项目中限制来宾可以通过 .vsls.json 文件访问的文件。 来宾同样务必要意识到，由于这些设置，可能无法看到某些文件。 有关详细信息，请参阅。

更改参与者标记行为

默认情况下，当参与者悬停光标时或在编辑、突出显示或移动其光标时， Live Share 将在其光标旁自动显示一个“标记”。 在某些情况下，你可能希望更改此行为。 为此，请执行以下操作：

转到“工具”>“选项”>“Live Share”将“标志可见性”更改为下列任一选项：选项行为

只有在悬停光标时，标记才可见。

这是默认设置。 标记在悬停光标时或在参与者编辑、突出显示或移动其光标时可见。

标记始终可见。

跟进

只要在协作会话中，都可以在“登录”按钮旁边的编辑器右上角看到每个参与者的首字母缩写。 将鼠标悬停在首字母缩写上，可以看到参与者的完整信息。

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

备注

默认情况下，Live Share 也会共享已共享解决方案外部的已打开文件。 若要禁用此功能，请将“工具”>“选项”>“Live Share”中的“共享外部文件”更新为“False”。

为了能够从“追随模式”轻松切换并开始自行编辑，在出现以下任何情况时，你将停止追随：

编辑、移动光标或进行选择选择其他文件

也可以随时通过单击右上角你追随的人的首字母缩写来停止追随。 表示你正在追随的参与者的首字母缩写周围的圆圈会随之消失。

可以单击同一位置上的任何首字母缩写来追随协作会话中的任何主持人或来宾。 请注意，如果你只是想跳转到某人的位置，而不是追随他们，只需双击他们的首字母缩写即可。

聚焦

有时，你可能希望协作会话中的每个人都来看一下你执行的操作。 使用 Live Share，通过通知即可让每个人都能追随你，从而追随你的操作。

只需单击右上角的会话状态/共享按钮，选择“与会者请注意”即可。

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

然后，当他们准备好向你聚焦时，只需单击通知中的“追随”即可。

共同调试

Live Share 的协作调试功能非常强大，可专门用于调试问题。 除了提供协作体验来解决问题之外，你和会话中的其他参与者还可以通过在主持人的计算机上提供共享调试会话来调查可能特定于环境的问题。

安全提示： 由于所有参与者都可以独立导航和编辑文件，作为主持人，你可能想要在项目中限制来宾可以通过 .vsls.json 文件访问的文件。 还应了解一点，控制台/REPL 访问权限意味着参与者可以在你的计算机上执行命令，因此，只能与你信任的参与者共同调试。 作为来宾，还请务必注意一点，由于这些设置，在调试程序进入某些受限的文件时，可能无法跟踪调试程序。 有关详细信息，请参阅。

共同调试的操作很简单。 协作会话主持人只需通过 中的常用方式即可开始调试。

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

提示

如果希望更改共同调试发生的时间和方式，可以通过“工具”>“选项”>“Live Share”中的设置更改默认行为。

任何人都可以分步完成调试过程，从而实现协作者之间的无缝切换，而无需协商控制权。

备注

请参阅平台支持，了解各语言或各平台对调试功能的支持情况。

每个协作者都可以调查不同的变量、在调用堆栈中跳转到其他文件、检查变量、甚至添加或删除断点。 然后，借助共同编辑功能，每个参与的演讲者都可以跟踪其他参与者所在的位置，以便提供在同时调查问题的不同方面和协作调试之间进行无缝切换的独特功能。

备注

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

提示

也可以从 中参与 VS Code 调试会话，反之亦然！ 有关详细信息，请查看针对共同调试的 。

自动 Web 应用共享

还有一个更出色的功能，对于 ASP.NET Web 应用项目，默认情况下如果主持人的项目配置为在调试时自动启动 Web 浏览器以连接到正在运行的 Web 应用程序，Live Share 会在每个来宾计算机上自动执行相同操作！ 此操作通过一种安全的方式完成，默认情况下，远程 Web 应用程序仅在调试会话期间对来宾可用。

有关如何共享对其他项目类型和/或会话持续时间的服务器访问的信息，请参阅。

提示

如果不喜欢浏览器的自动共享行为并希望更改此行为，可以更新“工具”>“选项”>“Live Share”中的设置。

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

默认情况下Chrome 自动升级后，本地项目都无法访问，当主持人共享调试会话时，来宾将被自动附加到调试会话。 但是，在某些情况下，你可能会发现此行为具有破坏性。 幸运的是，可以执行如下操作进行更改：

转到“工具”>“选项”>“Live Share”将“加入调试会话选项”更改为以下选项之一：选项行为

自动

默认值。 来宾将自动加入由主持人启动的任何共享调试会话。

提示

当主持人启动某个共享调试会话时，来宾将收到一条提示，询问是否要加入该共享调试会话。

手动

来宾将需要手动加入任何调试会话。 请参阅。

分离和重新附加

作为来宾，你可能希望暂时停止调试。 好在只需单击调试工具栏中的“停止”图标即可分离调试程序，而不会影响主持人或其他来宾。

如果你已更新设置，无法再自动附加，或者只是想稍后重新附加Chrome 自动升级后，本地项目都无法访问，可以从“选择启动项…”下拉列表中选择正在运行的所需调试会话：

然后单击它进行附加。

共享服务器

有时，作为协作会话主持人，你可能会希望与来宾共享其他本地服务器或服务。 其中可能包括其他 终结点、数据库或其他服务器。 使用 Live Share 可以指定本地端口号、视需要为其命名，然后与所有来宾共享它。

然后，来宾可以在完全相同的端口上从自己的本地计算机访问你在该端口上共享的服务器。 例如，如果你共享了在端口 3000 上运行的 Web 服务器，那么来宾可以在 :3000 上从自己的计算机访问这台正在运行的同一 Web 服务器！ 这通过主持人和来宾之间的安全 SHH 或 SSL 隧道来完成，并通过服务进行了身份验证，使你能够确保只有协作会话中的人员才具有访问权限。

安全提示： 作为主持人，应谨慎选择要与来宾共享的端口，并继续共享应用程序端口（而不是共享系统端口）。 作为来宾，如果服务器/服务是在其自己的计算机上运行的，则共享端口的行为完全相同。 这很有用，但是如果共享了错误的端口，也会具有风险。

出于安全目的，只有在指定端口上运行的服务器才能供其他来宾使用。 还好，协作会话主持人可以轻松添加共享端口。 操作方法如下：

单击右上角的共享/会话状态按钮，然后选择“管理共享的本地服务器”

在出现的对话框中，单击“添加”并输入该服务器正在本地运行的端口号，输入名称，按 Enter，然后单击“确定”。

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

如果端口已在来宾的计算机上使用，则将自动选择其他端口。 不过，来宾可以通过单击右上角的共享/会话状态按钮并选择“查看共享的本地服务器”，来查看当前共享的端口列表（如果指定了名称，则按名称列出）。

请注意，出于安全原因，来宾无法控制要在主持人的计算机上共享哪些端口。

若要停止共享本地服务器，主持人只需单击右上角的共享/会话状态按钮（如上所示），选择“管理共享的本地服务器”，并选择相应的端口，然后单击“删除”。

共享终端

新式开发经常使用各种命令行工具。 使用 Live Share 可以作为主持人根据需要与来宾“共享终端”。 共享终端可以是只读模式或完全协作模式，以便你和来宾都可以运行命令并查看结果。 可以为来宾提供对终端输出的可见性，或让他们亲身体验并运行测试、版本，甚至对在你的计算机上出现的特定于环境的问题进行会审。

但是，默认情况下，不会共享终端，因为它们至少向来宾授予了对你运行的命令输出的只读访问权限（如果不是由他们自己运行命令的功能）。 这样一来，就可以在本地终端毫无风险地运行命令，并且只在确实需要共享时才进行共享。 此外，只有主持人才能启动共享终端，这可以防止来宾启动某个共享终端并执行一些不应执行的操作。

作为主持人，可以通过单击右上角的会话状态/共享按钮，并在“共享终端”菜单项中选择一项来共享终端。

此时，可以从菜单中选择只读或读/写终端。 当终端为读/写状态时，所有人（包括主持人）都可以在终端中键入内容，如果来宾执行一些不合适的操作，将很容易造成干扰。 但是，为了安全起见，应只在确定来宾确实需要读/写权限时才向其授予该权限，并只在你想要来宾查看你运行的任何命令输出的情况下继续使用只读终端。

备注

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

选定你想要启动的共享终端类型后，会对具有正确权限的所有参与者显示一个新的共享终端。

若要结束终端会话，只需键入 exit 或关闭终端窗口，所有人都将断开连接。

会话状态

启动或加入协作会话并具有对共享内容的访问权限后，右上角的“Live Share”按钮将更新其外观，以反映活动协作会话的状态。

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

状态描述

非活动

没有处于活动状态的协作会话且没有共享任何内容。

主持人:正在进行共享

协作会话正在启动，将很快开始共享内容。

主持人:共享

协作会话处于活动状态且正在共享内容。

主持人:共享处于只读状态

正在共享只读协作会话。

来宾:正在加入会话

正在加入现有协作会话。

来宾:已加入

已加入并已连接到活动协作会话且正在接收共享内容。

来宾:已加入只读会话

已加入并已连接到处于活动状态的只读协作会话。

来宾限制

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

后续步骤

有关详细信息，请查看下面几篇文章。

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