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

提示： 如果您没有找到所需答案，可以在我们的社区论坛中提问、提交 bug 或提交功能请求。

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

这是一个已知问题。如需解决此问题，请等待大约 5 秒，然后刷新页面。

预览损坏了，但我的代码没有任何问题如何重启 IDX？

如果 IDX 无法正确刷新（通常是由于重大重构或 monospace.json 文件更改所致），请在命令面板（Mac 上为 Cmd+Shift+P 或者 ChromeOS、Windows 或 Linux 上为 Ctrl+Shift+P）的 IDX 类别下执行硬重启。

创建工作区时，我看到一条消息：糟糕...我们需要启动一个新的虚拟机，而界面会在此之后挂起

IDX 维护着一个用于按需预配工作区的虚拟机温池。当池运行速度不足时，工作区会在新虚拟机旋转后预配。此过程可能需要一些时间（有时长达 5 分钟），但最终会成功。

创建工作区时，我看到以下消息：发生内部错误

在大多数情况下，如果工作区预配期间出现内部错误，请在大约一分钟后刷新页面，让您跳过错误并进入工作区。

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

IDX 对每位用户最多 1 个工作区。如果您有 Google 开发者资料，则最多可以创建 5 个工作区。如需在达到工作区限制后直接从 IDX 创建 Google 开发者资料，请在模板信息中心内的通知中点击 Complete Setup（完成设置）。

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

我们正在积极提高我们的云模拟器的可靠性。如果网页刷新未能解决问题，请报告问题。

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

您可以像在本地机器上升级或降级几乎所有预安装软件的版本（使用 apt-get 或 DoubleClick）。请注意，当“空闲”工作区休眠时，系统不会保留这些更改。

Project IDX 与 Google Cloud Workstations 有何区别？

我们基于 Google Cloud 提供的已正式发布的 Cloud Workstations 工作站构建了 IDX，这简直不可思议。Cloud Workstations 是一种基础架构产品，专注于提供开发者工作站的可靠性、安全性和可用性。 对于希望管理其开发体验的大型企业而言，它是理想的选择。Project IDX 是这些工作站内的一个“包含电池”的环境，用于管理构建不同类型应用所需的工具链、软件开发堆栈和系统依赖项。

我不熟悉 Linux。如何在 Project IDX 中高效工作？

Project IDX 公开了一个 Debian shell，可用于安装和管理项目的系统级软件依赖项。我们即将迁移到与操作系统无关的基于 Nix 的 shell，您可以使用该 shell 将系统软件依赖项作为配置进行管理，而无需了解特定于操作系统的软件包管理器（如 apt）的具体情况。敬请期待！

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

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

我与其他人共享了工作站网址，但对方看不到我的工作区

您只能与有权访问工作区的用户共享工作区网址。没有权限的用户在尝试访问该网址时会看到错误消息。 请务必明确与他们共享工作区，例如共享 Google 文档！

共享工作站时，协作者可以看到哪些内容？

添加到您的工作区的用户对虚拟机的整个文件系统拥有完全访问权限，其中可能包含私钥和访问令牌等敏感文件。请仅与您信任的人员共享工作区。虽然此方法有助于其他用户查看工作区的确切状态，但这意味着他们可以看到您的工作区中的所有内容。

如何安全地共享包含我的 Firebase 凭据的工作区？

当您使用 IDX 将应用部署到 Firebase 时，工作区仅预配了执行操作所需的最基本权限。虽然您作为用户可能是项目管理员，但工作区本身并不具有作为所有者所具备的全部权限，基于最小权限原则进行操作。

我能否使用 IDX 不支持的框架来构建应用？

很好！虽然我们正努力让工作区可以完全自定义，但使用不受支持的前端框架或可能根本没有界面的项目，完全是有可能导入的。如需克服此问题，最简单的方法是在导入代码库流程中选择其他作为应用类型。设置工作区后，您可以安装项目所需的任何系统级依赖项。

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

目前，我们支持 GitHub。如果您希望我们支持更多 Git 主机，请提交功能请求。

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

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

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

如何在工作区中设置应用的后端，以便我的前端可以与之通信？

我们计划在不久的将来简化此操作，但目前请使用以下权宜解决方法：

1. 具有 API 后端的项目可以在终端中手动启动其 API 服务，也可以在 monospace.json 文件中配置启动命令。

2. 在终端中运行以下 bash 脚本，打开运行 API 服务所在的端口，以供 Web 前端预览访问：

   export port=4000 #dont use restricted ports (8000, 9000-9002)
   export API_SERVICE="https://$port-$WEB_HOST"
   echo $API_SERVICE
   

3. 在浏览器中，打开新标签页上方的 API_SERVICE URL。这样就会通过重定向流程设置必需的 Cookie。

4. 您的 Web 应用前端现在可以通过完全限定的路径访问 API 服务。

我关闭了“预览”标签页如何将其恢复？

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

什么是 Code OSS？

Code-Open Source Software (Code-OSS) 是一个开源项目，是 VS Code 的核心层。在 GitHub 上按照标准 MIT 许可提供 Code-OSS，而 Microsoft 也是在其中开发 VS Code 产品的地方。

如何防止将我的代码补全信息和 Gemini 聊天提示用作训练数据？

如果您不想将 Gemini 聊天提示用作训练数据来改进 IDX 中的 Gemini，请勿使用聊天助理并在工作区设置中关闭代码补全功能。

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

如果您在使用 Project IDX 时遇到问题，请提交 bug 告知我们。

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

IDX 使用 IssueTracker 来处理 bug 和功能请求，以通过屏幕截图和视频支持可靠的请求。将来，IDX 可能会通过 UserVoice 跟踪反馈和功能。已通过 UserVoice 提交的任何反馈或请求都会保留并与团队共享。

如何知道我所在的国家/地区是否可以使用 IDX 中的 Genmini？

位于 IDX 的 Gemini 目前仅在部分地区推出，并且会定期扩大适用范围。如果您所在的地区提供了 IDX 中的 Gemini，则您可以按照将 Gemini 添加到您的工作区中所述的步骤将其添加到工作区。

我之前使用项目 IDX 中的某项功能 但后来找不到了为什么要将其移除？

Project IDX 中的部分功能处于实验阶段。我们非常重视您的反馈，并积极利用这些反馈来了解我们当前和计划中的功能集，并定期移除不符合您的预期或我们自己的功能。如果您希望在理想的 Project IDX 版本中看到某些功能，请向我们发送反馈。我们期待收到您的宝贵意见！