基本编辑器概览

Cloud Workstations 附带默认的基本编辑器，您可以通过它编写、构建、测试、调试和运行应用。基础编辑器基于 Code-OSS 开源项目，支持随 Open VSX Registry 提供的 IDE 扩展程序，并预安装有 Cloud Code IDE 扩展程序。

如需开始使用 Cloud Workstations 基础编辑器，请执行以下操作：

1. 按照快速入门说明创建工作站配置。当系统提示您选择 Environmentcustom（环境自定义）时，请选择 Code OSS (default) 作为代码编辑器。

2. 按照快速入门中的说明，使用您刚创建的配置创建工作站。

3. 在 Google Cloud 控制台中，前往 Cloud Workstations 页面，通过浏览器启动您的工作站。

   前往 Cloud Workstations

活动栏

活动栏显示在侧面，您可以访问 Cloud Workstations 基础编辑器中提供的视图。这些活动栏视图如下所示：

• 探索器：查看当前工作区中的文件夹和文件

• 搜索：在文件中搜索字符串或正则表达式

• 源代码控制：使用 Cloud Workstations 基础编辑器的 Git 支持管理应用文件

• 调试：通过设置断点和检查变量来调试应用

• Extensions：搜索可向 IDE 添加其他功能的扩展程序目录

• Cloud Code：直接从 IDE 创建和部署 Google Cloud 应用

• Settings：根据您的工作流自定义 Cloud Workstations 基础编辑器

查看和编辑文件

内置的代码编辑器，可让您在工作站内浏览文件目录以及查看和修改文件。

如需使用基本编辑器，请按以下步骤操作：

1. 使用活动栏可在视图之间切换。

2. 使用编辑器查看和修改您的文件。

3. 使用“探索器”视图浏览文件目录、上传和下载文件、预览 Cloud Workstations 虚拟机实例上的 Web 应用，以及查看使用情况统计信息。

   

   图 1. Cloud Workstations 基础编辑器

上传和下载文件和目录

如需在 Code-OSS Explorer 视图中上传或下载文件和目录，请使用以下任一方法：

• 将文件拖到“文件资源管理器”视图上，以将其添加到工作区。

• 前往您要使用的文件和目录，右键点击，然后选择上传或下载。

  

  图 2. 在资源管理器视图中右键点击即可上传和下载文件

语言支持

Cloud Workstations 基础编辑器通过扩展程序支持 Go、Python、Java、.NET Core 和 Node.js 等语言，并提供如下语言功能：

• 智能突出显示、代码建议和基于上下文的补全
• 执行 lint 请求并提供描述性错误
• 代码导航（转到定义、声明、引用和实现）
• 直观调试支持

Cloud Code 集成

Cloud Code 可为 Kubernetes 和 Cloud Run 应用的完整开发周期（从创建和自定义新应用（从示例应用）到运行完成后的应用提供 IDE 支持。此外，Cloud Code 还可提供可直接运行的示例、配置代码段和量身定制的调试体验，为您提供全程支持。

Cloud Code 与 Gemini（AI 赋能的协作工具）集成，可简化开发工作。使用 Gemini 更高效地完成任务。

Cloud Code 支持采用 Node.js、Python、Java、Go 和 .NET Core 开发应用。

除了 Cloud Workstations 状态栏中的 Cloud Code 菜单之外，您还可以通过命令面板访问 Cloud Code 命令。如需打开命令面板，请按 Ctrl+Shift+P（在 macOS 上，按 Command+Shift+P），或点击视图 > Command Palette。

版本控制支持

Cloud Workstations 基础编辑器附带预配置的版本控制功能。您可以初始化代码库，区分文件状态、暂存区、取消暂存区和提交更改。您还可以使用公共、私有甚至自托管的代码库，只要可以从工作站访问这些代码库。

工作区管理

借助 Cloud Workstations，您可以将项目作为工作区进行管理和配置。工作区通常表示您的根项目文件夹，借助 Cloud Workstations 基础编辑器，您可以创建、打开和保存工作区，以及使用项目特定设置对其进行自定义。

如需将文件夹作为工作区打开，请使用活动栏顶部的菜单，然后依次选择文件 > 打开文件夹。或者，您也可以使用基本编辑器的欢迎页面上的 Open File 或 Recent Workspace 选项，或使用网址参数 folder 指定您要打开的文件夹的路径，例如 &folder=/home/user/foo。

调试应用

Cloud Workstations 支持 Go、Node.js、Python 和 Java 应用，可让您调试应用。您可以在 Cloud Workstations 中创建启动配置、设置断点和检查变量。

此外，您还可以调试本地集群（如 minikube 或 Docker Desktop）、GKE 上的远程集群或任何其他云服务提供商中的 Kubernetes 应用。

集成式终端

您可以通过集成终端与底层开发环境进行交互。使用以下任一方法可开启和关闭终端视图：

• 按 Control+。
• 按 Ctrl+Shift+P（在 macOS 上，按 Command+Shift+P），或者依次点击视图 > Command Palette（命令面板），然后输入 View: Toggle Terminal。
• 依次选择终端 > 新建终端。
• 依次选择查看 > 终端。
• 在终端标签页列表中，点击 addAdd。

如需打开多个终端窗口，请点击 拆分，或按 Ctrl+Shift+5。

图 4. 打开终端的 Cloud Workstations 界面

管理和自定义终端标签页

如果您打开多个终端，则终端视图的一侧会显示一个终端标签页列表。此列表包含已打开的终端的名称。

• 当您从列表中选择终端名称时，将会显示 Split 和 Delete 图标。点击相应的图标即可拆分或删除终端窗口。

• 如需查看其他终端选项（例如 Move Terminal into Editor area、Rename、Change Color、Change Icon 等），请右键点击终端名称。

  

  图 5. 自定义终端

滚动显示内容

在浏览器焦点位于会话标签页上时，除了使用鼠标之外，您还可以在 Windows 和 Linux 上按 Ctrl+Shift+PageUp 和 Control+Shift+PageDn（在 macOS 上，按 Fn+Shift+Up 和 Fn+Shift+Down）来滚动。

自定义设置

如需自定义编辑器、界面和功能行为，Cloud Workstations 基础编辑器提供了以下范围来定义设置：

• 机器设置：连接到 Cloud Workstations 虚拟机实例时全局适用的设置，并显示在工作站上的 $HOME/.codeoss-cloudworkstations/data/Machine/settings.json 文件中。

• 用户设置：在您连接到 Cloud Workstations 虚拟机实例时全局应用的设置，以及每个工作站实例的浏览器存储空间中保持不变的设置。

• 工作区设置：存储在工作区中的设置，仅在打开该工作区时适用。这些设置与工作区文件一起显示在 $WORKSPACE_ROOT/.vscode/settings.json 文件中。

编辑器会分别评估每个设置范围。

键盘快捷键

由于默认的基本编辑器在浏览器中运行，因此某些键盘快捷键可能会被浏览器预留，而不会被编辑器捕获。

为了支持所有键盘快捷键，默认的基本编辑器捆绑了一个渐进式 Web 应用 (PWA)，允许编辑器捕获这些快捷键。

如需使用 PWA，请执行以下操作：

1. 在浏览器中打开 Workstation。
2. 点击浏览器地址栏中显示的安装图标。

然后，应安装 PWA，并在 PWA 中重新打开工作站。 后续加载工作站时，浏览器会在地址栏中显示一个选项，供用户在 PWA 中重新打开工作站。