IDE Services Cloud Help

Code With Me Enterprise 用户指南

Code With Me Enterprise 可让您与任何人共享本地运行的项目。 您还可以用它进行实时协作、编辑代码、共享服务器以及运行调试会话。

一次共享会话涉及 host (主持人) 与一个或多个 guests (访客) 之间的互动。

您可以根据以下基本场景之一开始会话:

  • 您可以进行结对编程,此时将 IDE 与单个参与者共享,并可使用 完全同步 模式,或相互 跟随 ,在代码的不同部分协作。 与传统的共享单个屏幕和键盘的结对编程不同,您可以独立工作,更快达成目标。

  • 您可以采用教师—学生场景,让多名参与者跟随您。 比如,您需要讲解一个问题,并向团队成员展示项目的不同部分。 您可以通过 强制其他人跟随您 模式来实现。

  • 您可以与其他参与者同时编辑代码。 在这种情况下,参与者可以快速更改代码,甚至同时处理项目中的其他文件。 但是,同时可主动输入的参与者数量有限。 限制为 5,达到该限制时,IDE 会显示弹窗提示等待。 此外,这可能会导致性能下降。

作为主机开始使用

您可以创建一个链接,以您的计算机作为主机,邀请其他参与者协作处理您的代码。 您还可以启动调试会话,并共享其状态和操作。

创建会话

  1. 在主工具栏,点击 Code With Me 图标。

    或者,从主菜单中,选择 Tools | Code With Me (工具 | Code With Me)

  2. 在弹出的列表中,点击 Start Session (启动会话)

    启动会话
  3. Code With Me: Start Session (Code With Me:开始会话) 对话框中,为您的访客配置 访问权限 ,然后点击 Start Session (启动会话)

    Code With Me 权限对话框

    IDE 会生成一个链接,您可以将其发送给需要协作的访客。 要复制邀请链接,请点击 Code With Me 图标,并选择 Copy Session Link (复制会话链接)

  4. 将链接发送给访客。 当访客点击链接时,IDE 会弹出窗口,提示接受或拒绝访客。 此步骤需要您与访客核对代码是否一致。

    接受访客
  5. 点击 Accept (接受)。 访客将加入您的会话,您可以开始协作。 您将在编辑器中看到一个额外的光标,并在主工具栏上看到一个图标,表示活动的访客。

终止活动会话

  1. 在主工具栏,点击 Code With Me 图标。

  2. 从打开的列表中,选择 End Session

    结束会话

    IntelliJ IDEA 将终止会话并禁用所有访客。 该链接也会被禁用,您需要创建一个新链接以开始另一个会话。

访问主机设置

  1. 在主工具栏,点击 Code With Me 图标

  2. 点击 浏览按钮 ,并在打开的列表中选择 Settings (设置)

权限

作为主机,您可以配置新访客在您设备上能或不能访问的内容。 例如,您可以指定访客是否可以编辑文件、使用终端以及执行代码。 您还可以启用或禁用语音通话选项。 权限可以针对整个会话进行配置,也可以针对会话中的特定访客进行配置。

在会话期间的任何时间,访客可以 请求其他权限

添加权限

  1. 在主工具栏,点击 Code With Me 图标 并选择 Permissions (权限)

    当您 创建会话时,权限选项对话框会自动打开。

  2. Code With Me: Start Session 对话框中,指定以下选项:

    • Read-only :选择此权限后,访客只能查看文件、终端和运行操作。但访客仍然可以从编辑器复制和粘贴代码。 不过,访客仍然可以从编辑器中复制和粘贴代码。

      只读权限
    • Edit files :如果您希望访客只能编辑文件,而不能访问终端或执行代码,请选择此权限。

      编辑文件权限

      您可以将某些文件排除在访问范围之外。

      Files (文件) 字段下,点击 Manage hidden files... (管理隐藏文件...) ,并在 Hidden Files (隐藏文件) 对话框中添加要排除的文件,然后点击 OK (确定)

    • Full access :选择此权限,可授予访客对您计算机上的所有文件、终端和运行操作的完全访问权限。

      完全访问权限
    • Custom :选择此权限,可自定义访客对文件、终端和运行操作的访问。 切换到 Custom (自定义) 权限时,其相关选项将沿用先前选择的权限设置。 您可以根据需要进行更改。

      自定义权限
  3. Start call 选项默认启用,如需停用会话中的语音通话,请禁用该选项。

  4. 配置完权限后,如果您正在创建会话,请点击 Start Session。 如需编辑权限,请点击 Apply

音频和视频通话

与同事协作时,您可以在会话中聊天、进行音频与视频通话、启用屏幕共享以及转发端口。

会话开始后, 加入通话图标 会在主工具栏中可用,您可以使用它发起语音通话。

在会话期间,您可以管理语音通话、摄像头和屏幕共享。

从主工具栏管理通话

  • 在主工具栏点击 More 图标 以打开可用选项列表,并选择您需要的选项。

    通话选项

    您可以静音或取消静音麦克风、启用或禁用屏幕共享与摄像头,并在 Code With Me 工具窗口中打开 Call (通话) 选项卡。

您还可以在 Code With Me 工具窗口中控制通话、摄像头和屏幕共享。

从 Code With Me 工具窗口管理语音通话

  1. 在右侧工具栏,点击 Code With Me 以打开 Code With Me 工具窗口。

    Code With Me 工具窗口
  2. Call (通话) 选项卡上,点击相应图标。

    通话选项

通过自定义工具栏管理通话操作

您可以访问可添加到主工具栏的通话操作。 您还可以更改工具栏操作的图标,并从工具栏中移除操作。

  1. 右键点击主工具栏并选择 Customize Toolbar (自定义工具栏)

  2. 在可用选项中,选择 Main Toolbar | Right | Code With Me (主工具栏 | 右侧 | Code With Me)

  3. 打开 Code With Me Call Actions (Code With Me 通话操作) 节点,选择您要更改的操作。 点击 OK (确定) 以保存更改。 。

与访客共享屏幕

  1. 在主工具栏,点击 More 图标

    或者,打开 Code With Me 工具窗口。

  2. 点击 共享屏幕图标

    屏幕共享

    您的屏幕将与会话中的其他参与者共享。 如需停止屏幕共享,请再次点击同一图标。

如果您正在处理 Web 或数据库项目,可以在会话期间向访客开放本机上的某个端口。

转发端口

  1. 点击 Code With Me 打开 Code With Me 工具窗口。

  2. Code With Me 工具窗口,点击 Port Forwarding (端口转发) 选项卡。

  3. 点击 Add (添加) 图标添加端口。

  4. Port Forwarding (端口转发) 对话框中添加端口,选择协议,并点击 OK (确定)

    端口转发对话框

    在访客端,该端口会添加到 Code With Me 工具窗口的 Port Forwarding (端口转发) 选项卡中,访客即可访问。

作为访客开始使用

作为访客,您可以在已创建的会话中跟随主机,并编辑主机正在处理的代码。 您也可以跟随其他会话参与者,访问项目的其他部分。 此外,如果您具有相应的 权限 ,还可以在主机的计算机上运行并调试代码,并在 Terminal 工具窗口中工作。

接受邀请

  1. 点击收到的链接。

  2. 在浏览器中打开的页面上,确保您的设备已安装 Toolbox App,并点击 Join Session (加入会话)

    加入会话
  3. 将在运行时下载 IDE 轻量级客户端应用程序。

    无需安装 IDE,轻量级版本即可正常运行。

  4. 安装完成后,IDE 会显示一条通知,提示您等待主机接受您的会话加入请求。 请求被接受后,您即可加入会话。 当主机的项目打开后,您将在编辑器中看到活动文件。

    此时,您可以自定义访客 IDE,使您的工作过程更便捷。 您可以更改 主题视图模式 等。 您所做的更改只会影响您的访客 IDE。

离开会话

  1. 在主工具栏,点击 Code With Me 图标

  2. 从打开的列表中,选择 Leave Session (离开会话)

    离开会话

    会话已终止, Code With Me 欢迎屏幕已显示。 您可以使用同一链接快速返回该会话,而无需主机再次接受。

    JetBrains Client 欢迎界面

访客 Code With Me 安装位置

作为访客完成 Code With Me 的设置后,您可以在以下位置查看 Code With Me 的分发包、日志、设置和缓存在您的文件系统中的位置:

  • Code With Me 日志:

    ~/Library/Logs/JetBrains/JetBrainsClient<plugin_version>

    %LOCALAPPDATA%\JetBrains\JetBrainsClient<plugin_version>\log

    ~/.cache/JetBrains/JetBrainsClient<plugin_version>/log

  • Code With Me 缓存:

    ~/Library/Caches/JetBrains/JetBrainsClient<plugin_version>

    %LOCALAPPDATA%\JetBrains\JetBrainsClient<plugin_version>

    ~/.cache/JetBrains/JetBrainsClient<plugin_version>

  • Code With Me 设置:

    ~/Library/Application\ Support/JetBrains/JetBrainsClient<plugin_version>

    %APPDATA%\Roaming\JetBrains\JetBrainsClient<plugin_version>

    ~/.config/JetBrains/JetBrainsClient<plugin_version>

  • Code With Me 分发与 JetBrains 运行时:

    ~/Library/Caches/JetBrains/JetBrainsClientDist

    ~/Library/Caches/JetBrains/CodeWithMeClientDist

    %LOCALAPPDATA%\JetBrains\JetBrainsClientDist

    %LOCALAPPDATA%\JetBrains\CodeWithMeClientDist

    ~/.cache/JetBrains/JetBrainsClientDist

    ~/.cache/JetBrains/CodeWithMeClientDist

如果 Code With Me 会话是通过 IDE Services 创建的,JetBrains Client 的安装路径如下:

~/Library/Application Support/JetBrains/Toolbox/internal-tools/JetBrains Client

%LOCALAPPDATA%\JetBrains\Toolbox\internal-tools\JetBrains Client

~/.local/share/JetBrains/Toolbox/internal-tools/JetBrains Client

在共享会话中工作

创建共享会话并接受所有受邀参与者后,编辑器中将出现额外的光标,主工具栏将显示访客的图标,带有语音通话与聊天支持的 Code With Me 工具窗口也将可用。

已加入的会话:编辑器与主工具栏

在共享会话中,您可以尝试多种操作,例如独立浏览主机的项目、跟随其他参与者、使用终端工具窗口、进行代码编辑、向主机请求额外权限等。

跟随参与者

  1. 在主工具栏,点击 Code With Me 图标

  2. 从打开的列表中,选择您要跟随的参与者的名称,并选择 Follow

    或者,在主工具栏点击所需参与者的图标。

    IntelliJ IDEA 会将您的光标置于该参与者的光标之上,并在编辑器周围加上边框,带有显示您正在跟随的参与者姓名的小标签。

    跟随其他参与者

    点击名称旁边的 Stop 以取消跟随该参与者。 您随时可以点击 Resume (继续) 再次跟随同一位参与者。

    可以同时有多位参与者跟随其他参与者。 当某位跟随者决定切换焦点时,不会影响主机。 这在教师—学生场景中很有用。

强制其他人跟随您

  1. 在主工具栏,点击 Code With Me 图标

  2. 从打开的列表中,选择您的个人资料,并选择 Make Everyone Follow You

    让所有人跟随您

    在这种情况下,所有访客光标都会置于主机之上,如果主光标位于项目的其他文件中,焦点将发生切换。

    让所有人跟随您:编辑器

    参与者可在任何时间停止跟随主光标。

跳转到其他参与者

  1. 在主工具栏,点击 Code With Me 图标

  2. 在弹出的列表中,点击某位参与者姓名,并选择 Jump To (跳转到)

    或者,在主工具栏,右键点击参与者的图标并选择相同选项。

    跳转到其他参与者

    光标将定位到所选访客光标所在的行。 如果您想快速定位某位参与者的光标,这将很有帮助。

使用结对编程模式

  1. 在主工具栏,点击 Code With Me 图标

  2. 从打开的列表中,选择某位参与者的姓名,并选择 Pair Coding Mode

    或者,在主工具栏,右键点击参与者的图标并选择相同选项。

    结对编程模式

    光标将置于主机的光标之上。 IntelliJ IDEA 会在主机与访客的编辑器周围加上边框,表示已启用结对编程模式。

    完全同步模式

    即使光标位于项目的其他位置,焦点也会停留在主机的光标处。 此模式通常用于结对编程场景。

为特定用户终止共享会话

  1. 在主工具栏,点击 Code With Me 图标

  2. 从打开的列表中,点击您想要为其终止会话的参与者姓名,并选择 Remove Guest

    或者,在主工具栏右键点击参与者的图标并选择相同选项。

    移除访客

    IntelliJ IDEA 将为所选参与者终止会话,并在访客端显示通知。 IntelliJ IDEA 关闭访客项目,并返回到 Code With Me 欢迎屏幕。

    欢迎界面

    如果访客希望返回共享会话,则需要等待主机许可才能加入。

为当前访客收集日志

  1. Code With Me 欢迎屏幕,点击 更多选项图标 ,在 Settings (设置) 旁边。

  2. 从打开的列表中,选择 Collect Logs and Diagnostic Data

    收集主机与客户端日志

    IntelliJ IDEA 会在您的本机上创建一个日志文件。 日志文件包含当前项目的文件名、代码片段以及访客活动的详细信息,例如光标移动、输入的符号、调用的操作、打开的文件、文件路径等。

收集会话中的所有日志

  1. 在主工具栏,点击 Code With Me 图标

  2. 在打开的列表中,点击 更多按钮 并选择 Submit an Issue (提交问题(Submit an Issue))

    提交问题
  3. 在打开的对话框中,点击 OK (确定) 以批准数据收集。

    敏感数据对话框

    收集到日志详细信息后,它们会自动附加到 YouTrack system 中新建的问题。

请求权限

默认情况下,作为访客,您将被授予 Read-only (只读) 权限。 这意味着在会话期间,您无法编辑文件、添加代码或在终端中工作。 IDE Services 每次您尝试执行无权限的操作时都会弹出相应通知。 您可以点击通知中的链接,向主机请求其他权限。

请求编辑文件权限

  1. 开始编辑一个文件。 出现通知时,点击 Request to edit files (请求编辑文件) 链接。

    权限通知

    结果,主机会收到通知,并可以授予或拒绝这些权限。

    主机通知
  2. 如果权限被授予,访客即可编辑文件,且主机端的访客权限会随之更新。 主机可在会话期间的任何时间更改权限。 在主机主菜单中,从选项列表中选择访客姓名和 Permissions (权限) ,并在 编辑权限对话框中相应更新权限。

    权限对话框

要使用终端、运行应用程序或调试代码,您需要完全访问权限。

请求完全访问权限

  1. 当您尝试访问需要完全访问权限的操作时,会出现相应的通知。 例如,终端访问权限。

    终端权限

    点击 Request full access (请求完全访问) 链接。

    结果,主机会收到通知,并可以授予或拒绝这些权限。

  2. 如果授予了权限,将打开共享终端选项卡,访客即可使用。 此时主机有两个终端选项卡:一个为 private (私有) ,另一个为 shared (共享)

    主机可在会话期间的任何时间更改权限。 主机可在会话期间随时更改权限。在主菜单中选择访客姓名和 Permissions (权限) ,并在 编辑权限对话框中进行相应更新。

更改会话名称或会话服务器的 URL

您可以使用 Code With Me 设置更改所创建会话的默认名称。

您还可以更改会话使用的大厅服务器 URL。 出于安全目的,切换到您自己公司的服务器可能会很有用。

访问 Code With Me 设置

  1. 在主菜单中,打开 Settings - Tools - Code With Me (设置 | 工具 | Code With Me)

  2. User name 字段中输入会话新名称。 会话名称将在重启后更改。 点击 Use System Name 将把会话名称重置为默认值。

    您可以在 Lobby server URL 字段中更改默认的服务器 URL。

  3. 点击 OK (确定) 以保存更改。

2026年 3月 16日