Project IDX 疑難排解與常見問題

提示： 如果找不到問題的解答，請在社群論壇中提問、回報錯誤或功能要求。

開啟工作區時，我看到下列訊息：無法將要求轉送至後端。無法連線至通訊埠 80 上的伺服器。

。如要解決這個問題，請等待約 5 秒，然後重新整理頁面。

我的預覽故障，但我發現程式碼沒有問題如何重新啟動 IDX？

如果 IDX 未正確重新整理 (通常是因為進行重大重構或變更 monospace.json 檔案)，請在「IDX」類別下方的指令面板 (Mac 使用者為 Cmd+Shift+P 或 ChromeOS、Windows 或 Linux 的 Ctrl + Shift + P) 執行強制重新啟動。

建立工作區時，系統顯示訊息：糟糕，我們必須啟動新的 VM，然後 UI 會停止運作

IDX 負責維護一個臨時 VM 集區，用來隨選佈建工作區。當集區執行速度緩慢時，系統會在新的 VM 啟用後佈建工作區。這項程序可能需要一些時間才能完成 (有時最多 5 分鐘)，但最終會成功。

建立工作區時，系統顯示訊息「發生內部錯誤」

在大多數情況下，在工作區佈建期間發生內部錯誤時，請於一分鐘左右重新整理頁面，應該就能超過錯誤並進入工作區。

我的帳戶可以有幾個不同的工作區？

IDX 每位使用者最多只能擁有 1 個工作區。如果您有 Google 開發人員設定檔，最多可以建立 5 個工作區。如果您在達到工作區上限時，直接從 IDX 建立 Google 開發人員設定檔，請按一下範本資訊主頁通知中的「Complete Setup」。

我的工作區會載入 但模擬器一片空白

我們正積極提升雲端式模擬器的穩定性。如果重新整理頁面無法解決問題，請回報問題。

IDX 工作區的 Flutter 版本與我的專案不相容。

您可以像在本機電腦上使用 apt-get 或 brew，將工作區內幾乎所有預先安裝的軟體升級或降級版本。請注意，如果工作區發生「閒置」狀態，系統不會保留這些變更。

專案 IDX 和 Google Cloud Workstations 有何不同？

我們在 Google Cloud 的 Cloud Workstations 上 (令人驚嘆！) 建構了 IDX。Cloud Workstations 是一種基礎架構服務，著重在開發人員工作站的可靠性、安全性和可用性。對於想要管理開發體驗的大型企業而言，這會是最理想的選擇。專案 IDX 是這些工作站中的「內含電池」環境，用於管理建構不同應用程式類型所需的工具鍊、軟體開發堆疊和系統依附元件。

我不熟悉 Linux。如何善用專案 IDX？

專案 IDX 會公開 Debian 殼層，可用來安裝及管理專案的系統層級軟體依附元件。我們即將改用跨 OS 的 Nix 型殼層，讓您將系統軟體依附元件視為設定，而不用瞭解 apt 等作業系統專屬套件管理工具的具體細節。敬請持續鎖定最新消息！

為什麼 IDX 需要啟用第三方 (第三方) Cookie？

IDX 需要啟用第三方 Cookie，因為我們在另一個網域 (idx.google.com) 上算繪某個網域 (cloudworkstations.dev 的子網域) 的 IFRAME，而第三方 Cookie 則能實現安全的跨來源通訊。

我與其他人共用工作站網址 但他們看不到我的工作區

您只能與有權存取工作區的使用者共用工作區網址。如果使用者沒有權限，則造訪網址時會看到錯誤訊息。請務必明確與他們共用工作區，例如共用 Google 文件！

共用工作站時 協作者可以看到哪些內容？

新增至工作區的使用者俱有 VM 整個檔案系統的完整存取權，其中可能包含私密金鑰和存取權杖等敏感檔案。建議您只與您信任的使用者共用工作區。雖然這個方法可協助其他使用者查看工作區的確切狀態，但這代表他們可以看到工作區的所有內容。

如何安全地分享擁有 Firebase 憑證的工作區？

當您使用 IDX 將應用程式部署至 Firebase 時，系統會僅為執行作業所需的最基本權限佈建工作區。雖然您身為使用者，可能是專案管理員，但工作區本身並未具備擁有者做為擁有者的所有權限，而是按照最低權限原則執行作業。

我可以使用 IDX 不支援的架構建構應用程式嗎？

好啊！我們正努力讓工作區可完全自訂，但如果專案使用不支援的前端架構，或根本沒有 UI，您可以完全匯入專案。要通過這項測試，最簡單的方法就是在「Import a repo」(匯入存放區) 流程中，選取「Other」(其他) 做為「App Type」(應用程式類型)。設定工作區後，即可安裝專案所需的任何系統層級依附元件。

我可以從 GitLab 或 Cloud Source 存放區匯入存放區嗎？

目前我們支援 GitHub。如果希望支援更多 Git 主機，請提交功能要求。

在此期間，您可以透過現有範本建立新工作區，並在終端機中透過任何 https 或 ssh 型 Git 主機執行 git clone，就像您平常在本機機器上一樣。

將 Flutter 應用程式部署至 Firebase 託管時，應該選取哪個目標目錄？

選擇 build/web 目錄。此目錄應包含 index.html，以及應用程式建構成功後轉譯網頁應用程式所需的所有靜態資產 (透過 flutter build web)。

如何在工作區上設定應用程式的後端，以便前端對其進行對話？

我們計劃於近期簡化此操作，但目前請使用以下解決方法：

1. 具有 API 後端的專案可以在終端機中手動啟動 API 服務，也可以在 monospace.json 檔案中設定啟動指令。

2. 在終端機中執行以下 bash 指令碼，開啟 API 服務在哪個通訊埠上執行，以供網路前端預覽存取：

   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. 您的網頁應用程式前端現在可以透過完整路徑存取 API 服務。

我關閉了預覽分頁該如何恢復？

開啟指令區塊面板 (在 Mac 上為 Cmd+Shift+P 鍵，ChromeOS、Windows 或 Linux 則為 Ctrl + Shift + P)，然後選取「Project IDX: Show Web Preview」。

什麼是 Code OSS？

程式碼開放原始碼軟體 (Code-OSS) 是開放原始碼專案，是 VS Code 的核心層。Code-OSS 可於 GitHub 取得標準 MIT 授權，同時也是 Microsoft 開發 VS Code 產品的地方。

如何避免將程式碼完成和 Gemini 即時通訊提示做為訓練資料使用？

如果您不希望將 Gemini 即時通訊提示做為訓練資料用於 IDX 中的訓練資料，請勿使用即時通訊助理，並在工作區設定中關閉程式碼完成功能。

如何針對我遇到的問題提交功能要求或意見回饋？

如果您在使用 Project IDX 時遇到問題，請回報錯誤告訴我們。

如果你想查看新增至 IDX 的功能，或是想要擴充的現有功能，請提交功能要求。

IDX 使用 Issue Tracker 來回應錯誤和提出功能要求，以支援含有螢幕截圖和影片的健全要求。IDX 日後可能會透過 UserVoice 追蹤意見回饋和功能。已透過 UserVoice 提交的所有意見回饋或要求已妥善保存，並提供給團隊。

如何得知我所在的國家/地區是否提供 IDX 中的 Genmini？

Gemini 中的 Gemini 僅適用於特定區域，可用性會不時增加。如果您的區域提供 IDX 中的 Gemini，您可以按照將 Gemini 新增至工作區一文中所述的步驟將其新增至工作區。

我原本在使用 Project IDX 中的 特定功能了，但現在卻找不到為什麼會遭到移除？

Project IDX 的某些功能屬於實驗性質。我們非常重視您的意見，並會主動將其用於規劃目前及預定的功能集，並定期移除不符預期或自身情況的功能。如果您想在自己的專案 IDX 版本中查看某些功能，歡迎提供意見。我們想聽聽你的看法！