GitHub Codespaces

GitHub Codespaces 為任何活動提供雲端支援的開發環境，無論是長期專案，還是短期任務，例如檢閱提取要求。您可以從 Visual Studio Code 或以瀏覽器為基礎的編輯器使用這些環境。

環境

環境是 GitHub Codespaces 的「後端」一半。這是與軟體開發相關的所有運算發生的地方：編譯、偵錯、還原等。當您需要處理新專案、開始新任務或檢閱 PR 時，您可以簡單地啟動雲端託管環境，而 GitHub Codespaces 會負責正確設定它。它會自動設定您處理專案所需的一切：原始程式碼、執行階段、編譯器、偵錯工具、編輯器、自訂 dotfile 設定、相關的編輯器擴充功能等等。

自訂

GitHub Codespaces 可在每個專案的基礎上完全自訂。這是透過在專案的存放庫中包含 devcontainer.json 檔案來完成的，類似於 VS Code 開發容器開發。

自訂範例包括

• 設定要使用的以 Linux 為基礎的作業系統。
• 自動安裝各種工具、執行階段和架構。
• 轉送常用的連接埠。
• 設定環境變數。
• 設定編輯器設定並安裝偏好的擴充功能。

請參閱 設定 Codespaces 文件，以取得 codespace 專用的 devcontainer.json 設定。

每個使用者設定的 Dotfile

Dotfiles 是檔名以點 (.) 開頭的檔案。它們通常包含應用程式的組態資訊，並且可以控制終端機、編輯器、原始檔控制和各種其他工具的行為。.bashrc、.gitignore 和 .editorconfig 是開發人員常用的 dotfiles 範例。

您可以指定包含您的 dotfiles 的 GitHub 存放庫、檔案的目標位置，以及建立 codespace 時的安裝命令。

請參閱 個人化 Codespaces 文件，以瞭解如何將您的 dotfile 設定新增至 codespace。

開始使用

GitHub Codespaces 用戶端都有入門主題。這些主題將快速引導您完成登入 GitHub Codespaces、建立您的第一個 codespace，以及使用您偏好的用戶端連線到它

• VS Code 中的 Codespaces - 使用 GitHub Codespaces 擴充功能來連線並在您的環境中工作。
• 瀏覽器中的 Codespaces - 透過以瀏覽器為基礎的編輯器連線到您的 codespace。

擴充功能作者

VS Code 擴充功能 API 隱藏了遠端執行的許多實作細節，因此許多擴充功能都可以在 GitHub Codespaces 環境中正常運作，而無需任何修改。但是，我們建議您在 codespace 中測試您的擴充功能，以確保其所有功能都如預期般運作。請參閱關於支援遠端開發和 GitHub Codespaces的文章以取得詳細資訊。

以瀏覽器為基礎的編輯器

您還可以在瀏覽器中獲得免費、輕量型的 Visual Studio Code 體驗。Web 版編輯器可讓您安全且快速地瀏覽 GitHub 的原始程式碼存放庫，並進行輕量的程式碼變更。您可以在編輯器中開啟任何存放庫、分支或提取要求，該編輯器具有 VS Code 的許多功能，包括搜尋和語法醒目提示。如果您想要執行或偵錯您的程式碼，您可以切換到雲端託管環境或 VS Code 桌面版。

若要存取此以瀏覽器為基礎的編輯器，您可以前往 github.com 上的存放庫，然後按下 . (句點鍵)，或將存放庫的 URL 變更為 github.dev/org/repo，將 github.com 替換為 github.dev。

限制：如果您在無痕模式下執行瀏覽器或已啟用廣告封鎖程式，您可能無法使用 Web 版編輯器。

注意：此編輯器目前為技術預覽版。您可以立即試用並在 https://github.co/browser-editor-feedback 提供意見反應。

已知限制與調整

使用 Codespaces，特別是在 Web 版 VS Code 中工作時，有一些限制需要記住。其中一些限制有因應措施或調整，以提供一致的開發體驗。

對於幾個問題 (尤其是鍵盤快速鍵或列出桌面版因應措施的問題)，您可以將 Codespace 安裝並用作漸進式 Web 應用程式 (PWA)。

某些擴充功能在 Web 版中的行為有所不同

常見問題

為什麼擴充功能無法在瀏覽器中安裝

少數擴充功能具有內建假設或需要在桌面版上執行。範例是當擴充功能從桌面版上的 VS Code 安裝存取檔案時，或當擴充功能依賴必須在桌面版環境中執行的可執行檔時。當您嘗試在瀏覽器中安裝此類擴充功能時，系統會通知您該擴充功能無法使用。

注意 當從在桌面版上執行的 VS Code 連線到 Codespace 時，仍然可以使用此類擴充功能。

我如何允許 VS Code 存取我的剪貼簿以進行讀取？

在某些情況下，VS Code 可能會要求您在從剪貼簿讀取時提供存取剪貼簿的權限。您應該能夠從瀏覽器設定 (搜尋「網站權限」) 或透過在右側的網址列中尋找此選項來授與存取剪貼簿的權限

一旦您授與 VS Code 存取剪貼簿的權限，您就可以重試該操作。

我如何允許 VS Code 始終開啟新的索引標籤和視窗？

有時，瀏覽器會出於安全考量而阻止 VS Code 開啟新的索引標籤或視窗。如果發生這種情況，VS Code 將偵測到封鎖動作並明確提示使用者。但是，您可以透過開啟瀏覽器導覽列中內容選單的網站設定，並允許彈出式視窗，來允許 VS Code 始終開啟新的視窗和索引標籤。

我如何允許瀏覽器中的 VS Code 存取本機檔案和資料夾？

從瀏覽器在 VS Code 中開啟本機檔案和資料夾需要瀏覽器支援 File System Access API。截至今天，Microsoft Edge 和 Google Chrome 都提供此層級的支援。如果您想要在使用瀏覽器中的 VS Code 時存取本機檔案和資料夾，請考慮切換到這兩個瀏覽器之一。

問題或意見反應

如果您有問題，可以查閱 GitHub Codespaces 疑難排解指南。如果您想要提供意見反應，可以在 GitHub Codespaces 討論區 中輸入問題。