{"meta":{"title":"在 Visual Studio Code 中使用 GitHub Codespaces","intro":"通过将Visual Studio Code扩展与GitHub Codespaces帐户连接，您可以直接在GitHub中开发您的代码空间。","product":"Codespaces","breadcrumbs":[{"href":"/zh/codespaces","title":"Codespaces"},{"href":"/zh/codespaces/developing-in-a-codespace","title":"在代码空间中开发"},{"href":"/zh/codespaces/developing-in-a-codespace/using-github-codespaces-in-visual-studio-code","title":"Visual Studio Code"}],"documentType":"article"},"body":"# 在 Visual Studio Code 中使用 GitHub Codespaces\n\n通过将Visual Studio Code扩展与GitHub Codespaces帐户连接，您可以直接在GitHub中开发您的代码空间。\n\n## 关于GitHub Codespaces中的Visual Studio Code\n\n可以使用本地安装的 Visual Studio Code 来创建、管理、操作和删除代码空间。\n要在 GitHub Codespaces 中使用 VS Code，你需要安装 Codespaces 扩展。有关如何在GitHub Codespaces中设置VS Code的更多信息，请参阅[先决条件](#prerequisites)。\n\n默认情况下，在GitHub上创建新的代码空间时，它将会在浏览器中打开。 如果希望在 VS Code 中自动打开任何新的代码空间，可以将默认编辑器设置为 VS Code。 有关详细信息，请参阅“[为 GitHub Codespaces 设置默认编辑器](/zh/codespaces/setting-your-user-preferences/setting-your-default-editor-for-github-codespaces)”。\n\n如果想要在浏览器中工作，但想要继续使用现有的 VS Code 扩展、主题和快捷方式，可以打开“设置同步”。有关详细信息，请参阅 [个性化你帐户的 GitHub Codespaces](/zh/codespaces/setting-your-user-preferences/personalizing-github-codespaces-for-your-account#settings-sync)。\n\n## 先决条件\n\n要在代码空间直接VS Code中进行开发，您必须使用GitHub Codespaces凭据安装并登录到GitHub扩展。 该 GitHub Codespaces 扩展需要 VS Code 2020 年 10 月版本 1.51 或更高版本。\n\n使用Visual Studio Code Marketplace安装[GitHub Codespaces](https://marketplace.visualstudio.com/items?itemName=GitHub.codespaces)扩展。 有关详细信息，请参阅文档中的[](https://code.visualstudio.com/docs/editor/extension-gallery)VS Code。\n\n1. 在 VS Code 的活动栏中，单击“远程资源管理器”图标。\n\n   ![活动栏的屏幕截图。 “远程资源管理器”边栏图标（一个被圆圈覆盖的矩形）以橙色边框突出显示。](/assets/images/help/codespaces/click-remote-explorer-icon-vscode.png)\n\n   > \\[!NOTE]\n   > 如果远程资源管理器未显示在活动栏中：\n   >\n   > 1. 访问命令面板。 例如，通过按 <kbd>Shift</kbd>+<kbd>Command</kbd>+<kbd>P</kbd> (Mac)/<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd> (Windows/Linux)。\n   > 2. 键入：`details`。\n   > 3. 单击“Codespace: 详细信息”。\n\n2. 从“远程资源管理器”边栏顶部的下拉列表中选择“GitHub Codespaces”（如果尚未选择）。\n\n3. 单击**登录GitHub**。\n\n   ![“GitHub Codespaces”的“远程资源管理器”边栏的屏幕截图，其中显示了“登录到 GitHub”按钮。](/assets/images/help/codespaces/sign-in-to-view-codespaces-vscode.png)\n\n4. 如果当前未登录 GitHub ，系统会提示你执行此操作。 继续登录。\n\n5. 当系统提示指定要授权的内容时，请单击“ **授权** ”GitHub按钮。\n\n6. 如果显示授权页，请单击“授权 Visual-Studio-Code”。\n\n## 在 VS Code 中创建代码空间\n\n将 GitHub 上的帐户连接到 GitHub Codespaces 扩展后，可以创建新的 codespace。 有关 GitHub Codespaces 扩展的详细信息，请参阅 [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=GitHub.codespaces)。\n\n1. 在 VS Code 的活动栏中，单击“远程资源管理器”图标。\n\n   ![活动栏的屏幕截图。 “远程资源管理器”边栏图标（一个被圆圈覆盖的矩形）以橙色边框突出显示。](/assets/images/help/codespaces/click-remote-explorer-icon-vscode.png)\n\n   > \\[!NOTE]\n   > 如果远程资源管理器未显示在活动栏中：\n   >\n   > 1. 访问命令面板。 例如，通过按 <kbd>Shift</kbd>+<kbd>Command</kbd>+<kbd>P</kbd> (Mac)/<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd> (Windows/Linux)。\n   > 2. 键入：`details`。\n   > 3. 单击“Codespace: 详细信息”。\n\n2. 将鼠标悬停在“远程资源管理器”边栏上，然后单击 <svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-plus\" aria-label=\"The plus icon\" role=\"img\"><path d=\"M7.75 2a.75.75 0 0 1 .75.75V7h4.25a.75.75 0 0 1 0 1.5H8.5v4.25a.75.75 0 0 1-1.5 0V8.5H2.75a.75.75 0 0 1 0-1.5H7V2.75A.75.75 0 0 1 7.75 2Z\"></path></svg>。\n\n   ![GitHub Codespaces 的“远程资源管理器”边栏的屏幕截图。 工具提示“创建新 Codespace”显示在加号按钮旁边。](/assets/images/help/codespaces/create-codespace-vscode.png)\n\n3. 在文本框中，键入要在其中开发的存储库的名称，然后将其选中。\n\n   ![文本框中输入的“octo-org/he”的屏幕截图，以及以此字符串开头的四个存储库的列表。](/assets/images/help/codespaces/choose-repository-vscode.png)\n\n   后续提示的右侧会显示一条消息，告知谁将为 codespace 付费。\n\n   ![分支提示的屏幕截图，其中显示消息“hubwriter 付费使用”。](/assets/images/help/codespaces/who-will-pay-vscode.png)\n\n4. 单击要在其中开发的分支。\n\n5. 如果系统提示选择开发容器配置文件，请从列表中选择一个文件。\n\n6. 选择你要使用的机器类型。\n\n   > \\[!NOTE]\n   > 你选择的可用计算机类型可能会受到多种因素的限制。 其中可能包括为组织配置的策略，或者存储库的计算机类型最低规范。 有关详细信息，请参阅 [限制对计算机类型的访问](/zh/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types) 和 [为代码空间计算机设置最低规范](/zh/codespaces/setting-up-your-project-for-codespaces/configuring-dev-containers/setting-a-minimum-specification-for-codespace-machines)。\n\n## 在 VS Code 中打开代码空间\n\n1. 在 VS Code 的活动栏中，单击“远程资源管理器”图标。\n\n   ![活动栏的屏幕截图。 “远程资源管理器”边栏图标（一个被圆圈覆盖的矩形）以橙色边框突出显示。](/assets/images/help/codespaces/click-remote-explorer-icon-vscode.png)\n\n   > \\[!NOTE]\n   > 如果远程资源管理器未显示在活动栏中：\n   >\n   > 1. 访问命令面板。 例如，通过按 <kbd>Shift</kbd>+<kbd>Command</kbd>+<kbd>P</kbd> (Mac)/<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd> (Windows/Linux)。\n   > 2. 键入：`details`。\n   > 3. 单击“Codespace: 详细信息”。\n2. 在“”GitHub Codespaces下，将鼠标悬停在要开发的代码空间上。\n3. 单击连接图标（插头符号）。\n\n   ![“远程资源管理器”边栏的屏幕截图。 codespace (插件符号) 的连接图标以深橙色边框突出显示。](/assets/images/help/codespaces/click-connect-to-codespace-icon-vscode.png)\n\n## 更改计算机类型 VS Code\n\n```\n          通常，你可以在选择的远程计算机上运行 codespace。 这些计算机类型有 2 核到 32 核的硬件规格可选，尽管各种计算机类型可能并不总是可用。 每种计算机类型都有不同的资源水平和不同的计费等级。 如需相关信息，请参阅 [AUTOTITLE](/billing/managing-billing-for-your-products/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)。\n          \n          默认情况下，创建 codespace 时将使用具有最低有效资源的计算机类型。 可以随时更改代码空间的计算机类型。\n```\n\n> \\[!NOTE]\n> 你选择的可用计算机类型可能会受到多种因素的限制。 其中可能包括为组织配置的策略，或者存储库的计算机类型最低规范。 有关详细信息，请参阅 [限制对计算机类型的访问](/zh/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types) 和 [为代码空间计算机设置最低规范](/zh/codespaces/setting-up-your-project-for-codespaces/configuring-dev-containers/setting-a-minimum-specification-for-codespace-machines)。\n\n1. 在 VS Code 中，使用 <kbd>Command</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd> (Mac) or <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd> (Windows/Linux) 打开命令面板。\n\n2. 搜索并选择“代码空间：更改机器类型”。\n\n   ![作为搜索字符串输入的“更改计算机”和下拉列表中的“Codespaces: 更改计算机类型”的屏幕截图。](/assets/images/help/codespaces/vscode-change-machine-type-option.png)\n\n3. 如果没有在 codespace 中遵循这些说明，请单击要更改的 codespace。\n\n   ![包含四个 codespace 的下拉列表的屏幕截图。](/assets/images/help/codespaces/vscode-change-machine-choose-repo.png)\n\n   如果要在 codespace 中遵循这些说明，则更改将应用于正在使用的 codespace。\n\n4. 选择你要使用的计算机类型。\n\n5. 如果要更改为具有不同存储容量的计算机类型，则会出现一个提示，该提示询问你是否要继续。 阅读提示并单击“是”接受。\n\n如果更改为具有不同存储容量（例如，从 32 GB 更改为 64 GB）的虚拟机，则在更改计算机类型时，你的 codespace 将暂时不可用。 如果 codespace 当前处于活动状态，它将自动停止。 更改完成后，便可重启在新计算机类型上运行的 codespace。\n\n如果更改为具有相同存储容量的虚拟机，则此更改将在下次重启 codespace 时应用。 处于活动状态的 codespace 不会自动停止。 有关重启 codespace 的详细信息，请参阅“[停止和启动 codespace](/zh/codespaces/developing-in-codespaces/stopping-and-starting-a-codespace#restarting-a-codespace)”。\n\n## 删除一个代码空间在 VS Code\n\n如你当前未在 codespace 中工作，可从 VS Code 内删除 codespace。\n\n1. 在 VS Code 的活动栏中，单击“远程资源管理器”图标。\n\n   ![活动栏的屏幕截图。 “远程资源管理器”边栏图标（一个被圆圈覆盖的矩形）以橙色边框突出显示。](/assets/images/help/codespaces/click-remote-explorer-icon-vscode.png)\n\n   > \\[!NOTE]\n   > 如果远程资源管理器未显示在活动栏中：\n   >\n   > 1. 访问命令面板。 例如，通过按 <kbd>Shift</kbd>+<kbd>Command</kbd>+<kbd>P</kbd> (Mac)/<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd> (Windows/Linux)。\n   > 2. 键入：`details`。\n   > 3. 单击“Codespace: 详细信息”。\n2. 在“GitHub Codespaces”下，右键单击要删除的 codespace。\n3. 单击“删除 codespace”。\n\n## 切换至 VS Code Web 客户端中的预览版成员\n\n如果使用 VS Code Web 客户端，可以切换到应用程序的内部版本。 有关此版本VS Code的详细信息，请参阅VS Code博客中的[Insiders 版本介绍](https://code.visualstudio.com/blogs/2016/02/01/introducing_insiders_build)。\n\n在 codespace 中切换版本后，如果停止并重启 codespace，Web 客户端将继续使用预览体验版本。 在 Web 客户端中创建和打开 VS Code 的新代码空间也将使用 Insiders 版本。\n\n1. 在显示代码空间的浏览器窗口左下角，单击 **<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-gear\" aria-label=\"Manage\" role=\"img\"><path d=\"M8 0a8.2 8.2 0 0 1 .701.031C9.444.095 9.99.645 10.16 1.29l.288 1.107c.018.066.079.158.212.224.231.114.454.243.668.386.123.082.233.09.299.071l1.103-.303c.644-.176 1.392.021 1.82.63.27.385.506.792.704 1.218.315.675.111 1.422-.364 1.891l-.814.806c-.049.048-.098.147-.088.294.016.257.016.515 0 .772-.01.147.038.246.088.294l.814.806c.475.469.679 1.216.364 1.891a7.977 7.977 0 0 1-.704 1.217c-.428.61-1.176.807-1.82.63l-1.102-.302c-.067-.019-.177-.011-.3.071a5.909 5.909 0 0 1-.668.386c-.133.066-.194.158-.211.224l-.29 1.106c-.168.646-.715 1.196-1.458 1.26a8.006 8.006 0 0 1-1.402 0c-.743-.064-1.289-.614-1.458-1.26l-.289-1.106c-.018-.066-.079-.158-.212-.224a5.738 5.738 0 0 1-.668-.386c-.123-.082-.233-.09-.299-.071l-1.103.303c-.644.176-1.392-.021-1.82-.63a8.12 8.12 0 0 1-.704-1.218c-.315-.675-.111-1.422.363-1.891l.815-.806c.05-.048.098-.147.088-.294a6.214 6.214 0 0 1 0-.772c.01-.147-.038-.246-.088-.294l-.815-.806C.635 6.045.431 5.298.746 4.623a7.92 7.92 0 0 1 .704-1.217c.428-.61 1.176-.807 1.82-.63l1.102.302c.067.019.177.011.3-.071.214-.143.437-.272.668-.386.133-.066.194-.158.211-.224l.29-1.106C6.009.645 6.556.095 7.299.03 7.53.01 7.764 0 8 0Zm-.571 1.525c-.036.003-.108.036-.137.146l-.289 1.105c-.147.561-.549.967-.998 1.189-.173.086-.34.183-.5.29-.417.278-.97.423-1.529.27l-1.103-.303c-.109-.03-.175.016-.195.045-.22.312-.412.644-.573.99-.014.031-.021.11.059.19l.815.806c.411.406.562.957.53 1.456a4.709 4.709 0 0 0 0 .582c.032.499-.119 1.05-.53 1.456l-.815.806c-.081.08-.073.159-.059.19.162.346.353.677.573.989.02.03.085.076.195.046l1.102-.303c.56-.153 1.113-.008 1.53.27.161.107.328.204.501.29.447.222.85.629.997 1.189l.289 1.105c.029.109.101.143.137.146a6.6 6.6 0 0 0 1.142 0c.036-.003.108-.036.137-.146l.289-1.105c.147-.561.549-.967.998-1.189.173-.086.34-.183.5-.29.417-.278.97-.423 1.529-.27l1.103.303c.109.029.175-.016.195-.045.22-.313.411-.644.573-.99.014-.031.021-.11-.059-.19l-.815-.806c-.411-.406-.562-.957-.53-1.456a4.709 4.709 0 0 0 0-.582c-.032-.499.119-1.05.53-1.456l.815-.806c.081-.08.073-.159.059-.19a6.464 6.464 0 0 0-.573-.989c-.02-.03-.085-.076-.195-.046l-1.102.303c-.56.153-1.113.008-1.53-.27a4.44 4.44 0 0 0-.501-.29c-.447-.222-.85-.629-.997-1.189l-.289-1.105c-.029-.11-.101-.143-.137-.146a6.6 6.6 0 0 0-1.142 0ZM11 8a3 3 0 1 1-6 0 3 3 0 0 1 6 0ZM9.5 8a1.5 1.5 0 1 0-3.001.001A1.5 1.5 0 0 0 9.5 8Z\"></path></svg>**。\n\n2. 在菜单中，选择“切换到内部版本”。\n\n   ![VS Code Web 客户端的屏幕截图。 齿轮图标以橙色边框突出显示。 菜单中显示“切换到预览体验版本”。](/assets/images/help/codespaces/codespaces-insiders-vscode.png)\n\n3. 单击“重新加载”。\n\n若要切换回稳定版本 VS Code，请重复此过程，但选择 **“切换到稳定版本**”。 切换回后，如果停止并重启 codespace，codespace 将继续使用稳定版本。 在 VS Code Web 客户端中创建和打开的新代码空间将使用稳定版本。\n\n## 使用 Insiders 桌面应用程序进行操作 Codespaces\n\n若要在桌面应用程序的 Insiders 版本中GitHub Codespaces使用VS Code，请从 VS Code Insiders 应用程序中启动或创建您的代码空间。 有关详细信息，请参阅本文前面部分[的“在代码空间中创建VS Code代码空间](#creating-a-codespace-in-vs-code)”和[“打开代码空间VS Code](#opening-a-codespace-in-vs-code)”。\n\n## 其他阅读材料\n\n* [在 GitHub Codespaces 中使用 Visual Studio Code 命令面板](/zh/codespaces/reference/using-the-vs-code-command-palette-in-codespaces)\n* [在 GitHub Codespaces 中使用GitHub Copilot](/zh/codespaces/reference/using-github-copilot-in-github-codespaces)"}