Project IDX 目前处于 Beta 版阶段。Beta 版产品和功能获得的支持可能较为有限，并且对 Beta 版产品和功能的更改可能与以前的版本不兼容。

此页面由 Cloud Translation API 翻译。

Project IDX 问题排查和常见问题解答

在打开工作区时，我看到消息“无法将您的请求转发到后端。无法连接到端口 80 上的服务器。

这种情况很少发生，但作为一种权宜解决方法，您可以等待大约 5 秒钟，然后刷新页面。

我的预览无法正常显示，但我的代码没有任何问题。如何重启 IDX？

如果 IDX 无法正常刷新（通常是由于进行重大重构或更改环境 dev.nix 文件所致），请打开命令面板（在 Mac 上为 Cmd+Shift+P，在 ChromeOS、Windows 或 Linux 上为 Ctrl+Shift+P），然后运行强制重启命令。如果这样做无法解决问题，请尝试运行重新构建环境命令。

在创建工作区时，我看到一条消息，内容为 Whoops...我们需要启动一个新的虚拟机，界面在此之后挂起

IDX 会维护一个包含预热虚拟机的池，用于按需预配工作区。当池用量不足时，系统会在启动新的虚拟机后预配工作区。此过程可能需要一些时间（有时最多需要 5 分钟），但最终会成功。

在创建工作区时，我看到一条消息，内容为发生内部错误

在工作区预配期间发生内部错误的大多数情况下，大约一分钟后刷新页面应该就可以解决错误并进入工作区。

我的账号中可以有多少个不同的工作区？

IDX 对每位用户的 Workspace 数量设有上限，即 1 个。如果您有 Google 开发者资料，则最多可以创建 5 个工作区。如果您达到了工作区数量上限，想要直接从 IDX 创建 Google 开发者资料，请点击模板信息中心通知中的完成设置。

我的工作区已加载，但模拟器显示空白

我们正在积极改进基于云端的模拟器的可靠性。如果刷新页面无法解决问题，请报告问题。

IDX 工作区的 Flutter 版本与我的项目不兼容。

您可以在工作区内升级或降级几乎所有预安装软件的版本，就像在本地计算机上一样（使用 apt-get 或 brew）。请注意，当“空闲”工作区进入休眠状态时，系统不会保留更改。

我们正在努力改进 IDX 中的 Flutter 版本管理。

Project IDX 和 Google Cloud 工作站有何区别？

IDX 是基于 Google Cloud 提供的（令人难以置信的！）正式版 Cloud Workstations 构建的。Cloud Workstations 是一项基础架构产品，专注于开发者工作站的可靠性、安全性和可用性。

这对于想要管理开发体验的大型企业而言是理想之选。Project IDX 是这些工作站中的“开箱即用”环境，用于管理构建不同类型应用所需的工具链、软件开发堆栈和系统依赖项。

为什么 IDX 需要启用第三方 (3P) Cookie？

IDX 需要启用第三方 Cookie，因为我们会在一个网域 (cloudworkstations.dev 的子网域) 上呈现来自另一个网域 (idx.google.com) 的 IFRAME，而第三方 Cookie 支持安全的跨源通信。

我可以使用 IDX 没有模板的框架来构建应用吗？

是的！您可以自定义环境，以便在 IDX 中使用几乎任何框架或语言。

我可以从 GitLab 或 Cloud Source Repositories 导入代码库吗？

目前，我们支持从 GitHub、GitLab 和 Bitbucket 导入项目。如果您希望我们支持更多 Git 托管服务，请提交功能请求。

在此期间，您可以根据现有模板创建一个新的工作区，并在终端中使用任何基于 https 或 ssh 的 Git 主机运行 git clone，就像在本地机器上通常执行的操作一样。

将 Flutter 应用部署到 Firebase Hosting 时，我应选择哪个目标目录？

选择 build/web 目录。此目录应包含 index.html 以及成功构建应用（通过 flutter build web）后渲染 Web 应用所需的所有静态资源。

如何在 Workspace 上设置应用的后端，以便前端与其通信？

您可以暂时公开打开后端服务器所运行的 TCP 端口，以便更轻松地在不同的工作区中分别开发前端和后端：

您可以在终端中手动启动后端或 API 服务器，也可以在 dev.nix 文件的预览配置或 onStart 生命周期钩子中启动后端或 API 服务器。
点击活动栏中的 Project IDX 图标（默认位于左侧），打开 IDX 面板。
展开后端端口部分，查看正在运行的服务器列表，包括端口号和进程 ID (PID)。
点击充电桩号左侧的公开图标（锁形图标）。

警告：这样一来，只要您的工作区处于活跃状态且您未明确关闭公开访问权限，互联网上的任何人都可以访问您的充电桩。
点击端口号右侧的 Copy 网址 图标，复制其完全限定网址。
现在，您可以直接从前端引用此网址（例如，使用 fetch 调用）。

注意：如果您的前端是网络浏览器，您可能需要在后端或 API 服务器中启用 CORS 支持（例如，针对 Node.js 应用使用 cors NPM 软件包，或针对 Python Flask 应用使用 flask-cors）。

我关闭了预览标签页。如何恢复？

打开命令面板（在 Mac 上为 Cmd+Shift+P，在 ChromeOS、Windows 或 Linux 上为 Ctrl+Shift+P），然后选择 Project IDX: Show Android Preview 或 Project IDX: Show Web Preview。

什么是 Code OSS？

Code-Open Source Software (Code-OSS) 是一个开源项目，是 VS Code 的核心层。Code-OSS 在 GitHub 上以标准 MIT 许可的形式提供，Microsoft 在 GitHub 上开发 VS Code 产品。

如何阻止系统使用我的代码补全内容和 Gemini Chat 提示作为训练数据？

如果您不希望 Gemini Chat 提示被用作训练数据来改进 IDX 中的 Gemini，请勿使用聊天助理，并在工作区“设置”中关闭代码补全。您还可以通过向代码库添加 .aiexclude 文件，在处理特定文件时关闭协助功能。

如何提交功能请求或针对遇到的问题提供反馈？

如果您在使用 Project IDX 时遇到问题，请在论坛中提问或提交 bug。

如果您希望在 IDX 中添加某项功能，或者希望扩展现有功能，请提交功能请求。

如何确定我所在的国家/地区是否提供 IDX 版 Gemini？

IDX 中的 Gemini 目前仅在部分地区提供，我们会定期扩大覆盖范围。如果您所在的地区提供 IDX 中的 Gemini，则可以按照将 Gemini 添加到 Workspace 中列出的步骤开始使用。

我之前在 Project IDX 中使用过一项特定功能，但现在找不到它了。为什么它被移除了？

Project IDX 中的部分功能处于实验阶段。我们非常重视您的反馈，并会积极利用这些反馈来指导我们当前和计划提供的功能集，定期移除未能达到您或我们的预期的功能。如果您希望在理想的 Project IDX 版本中看到某些功能，请向我们发送反馈。我们期待收到您的反馈！