豆包MarsCode IDE：從GitHub倉庫開發(fā)項目的完整指南

本文檔介紹如何通過導入 GitHub 倉庫來創(chuàng)建項目，選擇合適的開發(fā)環(huán)境模板，并在豆包 MarsCode IDE 中完成項目的初始化與運行。

使用限制

單個賬號在豆包 MarsCode IDE 上創(chuàng)建的項目數(shù)量不得超過 10 個。

重要提示

在進行 GitHub 授權(quán)時，請確保你了解所授權(quán)的權(quán)限范圍。

操作步驟

第一步：登錄豆包 MarsCode IDE 工作臺

前往豆包 MarsCode IDE 工作臺并登錄你的賬號。

第二步：導入 GitHub 倉庫

將 GitHub 倉庫導入至豆包 MarsCode IDE 平臺。支持 Github 授權(quán)導入和 Github URL 導入兩種方式。

1. 在工作臺的歡迎頁面，點擊左上角的 ＋ 項目 按鈕，或點擊 創(chuàng)建您的項目 面板處的 導入 Git 項目 按鈕。 你將看到 創(chuàng)建項目 窗口。
2. 選擇 GitHub 倉庫。

方式	步驟
通過關(guān)聯(lián) GitHub 賬號導入	點擊 我的代碼倉庫 面板處的 授權(quán)獲取倉庫。  你將看到 GitHub 賬號授權(quán)窗口。 選擇授權(quán) All repositories (所有倉庫） 或 Only select repositories （指定倉庫）。 然后點擊底部的 Authorize & Request 按鈕。 操作完成后，返回豆包 MarsCode IDE ，“我的代碼倉庫” 面板中會顯示已導入的倉庫。
通過 URL 導入	在 導入 URL 面板中，填入一個 GitHub 公開倉庫的 URL。平臺會自動導入該 URL 關(guān)聯(lián)的 GitHub 倉庫。  提示： 豆包 MarsCode IDE 不支持使用私人倉庫。若填入私人倉庫的 URL，輸入框下方會提示 ”此代碼倉庫為私有倉庫或無效地址，請檢查“。

第三步：選擇開發(fā)環(huán)境模板并創(chuàng)建項目

以 Vercel 的 AI 倉庫為例，導入 GitHub 倉庫后，平臺將為該倉庫自動推薦匹配的開發(fā)環(huán)境模板。

1. 點擊模板區(qū)域的 切換 按鈕，展開模板列表，然后選擇所需模板。你也可以保留默認推薦的模板。

   - 在選擇開發(fā)環(huán)境模板時，確保模板與項目的開發(fā)語言相匹配。如果沒有匹配項，可選擇 ”`All In One`“  模版。

   
   - 若想了解模板詳情，可點擊模板名稱右側(cè)的 詳情 按鈕。
   

2. 在 項目名稱 和 項目描述 字段處，填入項目名稱和項目描述。
3. 點擊底部的 創(chuàng)建 按鈕。創(chuàng)建項目后，系統(tǒng)將啟動并初始化項目。 初始化完畢后，你將進入工作空間。

第四步：配置項目

你可以根據(jù)項目需求，編輯文件內(nèi)容、添加插件等。如果豆包 MarsCode IDE 中缺少所需的依賴，可以根據(jù)項目的具體需求，在終端面板（Terminal）中手動安裝。

第五步：運行項目

根據(jù)文檔教程依賴安裝完成后，進入項目目錄，在終端面板中手動運行項目。

第六步：體驗項目

項目成功啟動后，底部的 網(wǎng)絡(luò)服務(wù) 面板會顯示該項目的 URL，你可以在瀏覽器中打開該 URL 進行預覽。關(guān)于網(wǎng)絡(luò)服務(wù)的詳細說明可參考《網(wǎng)絡(luò)服務(wù)》一文。

打開預覽 url，即可測試驗證您的項目了。

Git 操作說明

MarsCode 默認已集成 Git，你可以在 IDE 中進行 Git 操作，提高開發(fā)效率。

場景一：未進行 GitHub 授權(quán)

在這種場景下，開發(fā)者尚未通過 GitHub 的 OAuth 進行授權(quán)。因此，需要手動設(shè)置 Git，以便在豆包 MarsCode IDE 中使用。詳細說明可以參考 GitHub 的官方文檔《Set up Git》。以下步驟是設(shè)置 Git 的關(guān)鍵部分：

1. 在終端或命令提示符中運行 git --version 命令來檢查是否已安裝 Git。
2. 使用以下命令配置 Git 的用戶信息，包括用戶姓名和電子郵件地址。這些信息將用于標識你的每次提交。

   git config --global user.name "your username" 
   git config --global user.email "your email" 

3. 在終端中運行以下命令生成 SSH 密鑰：

   ssh-keygen -t rsa -b 4096 -C "your email" 

   

4. 按照提示完成密鑰的生成，并將生成的公鑰（默認位于 /home/cloudide/.ssh/id_rsa.pub）添加到 GitHub 賬戶的 SSH 密鑰部分，詳細配置參考《Adding a new SSH key to your GitHub account》。
5. 運行 ssh -T git@github.com命令，檢查是否能夠成功通過 SSH 連接到 GitHub。

如果消息提示你已成功認證，則說明你的 SSH 設(shè)置是正確的。

場景二：已進行 Github 授權(quán)

在已通過 GitHub 授權(quán)后，你可以直接在 IDE 中使用 Git 命令，執(zhí)行各種 Git 操作。以下是使用 Git 的基本步驟：

1. 在豆包 MarsCode IDE 中克隆代碼。
2. 進行常見的 Git 操作，如提交（commit）、推送（push）、拉?。╬ull）和分支（branch）管理。此外，豆包 MarsCode IDE 界面右側(cè)的 Source Control 插件簡化了 Git 操作，無需使用復雜的命令行操作。