使用 Live Share 在 Visual Studio Code 中共同作業

顯示 Visual Studio Code 中 [Live Share] 索引標籤的螢幕擷取畫面。 顯示 Visual Studio Code 中 [Explorer] 索引標籤的螢幕擷取畫面。

藉由使用這些視圖,您可以在共用程式碼中看到參與者的位置、選取參與者來追蹤他們、專注于參與者、存取共用的伺服器和終端機等等。

在已設定範圍的命令功能表中

您也可以從 Visual Studio Code 命令選擇區使用所有 Visual Studio Live Share 函式。 您可以藉由選取Ctrl + shift + pCmd + shift + PF1來存取命令選擇區。 您可以透過進入 live share,找到完整的命令清單。

因為這份清單可能很長,所以使用狀態列的範圍命令功能表可能比較容易。 選取狀態列上的 [登入/會話狀態] 按鈕將會顯示可供使用的內容相關命令清單:

顯示 Visual Studio Code 會話狀態按鈕的螢幕擷取畫面。

啟動和停止會話

下載並安裝 Visual Studio Live Share 之後,請遵循下列步驟來啟動共同作業會話,並邀請同事與您一起使用。

  1. 登入

    當您安裝 Live Share 擴充功能、重載並等候相依性安裝之後,請登入,讓其他共同作業者知道您的身分。 如需詳細資訊,請參閱登

  2. 開啟資料夾

    使用您的一般工作流程來開啟您想要與來賓共用的資料夾、專案或方案。

  3. [選擇性] 更新隱藏或排除的檔案

    根據預設,Live Share 會從您的來賓隱藏共用資料夾中 .gitignore 檔案所參考的任何檔案和資料夾。 隱藏檔案可防止該檔案在來賓的檔案樹狀目錄中顯示。 排除 檔案會套用更嚴格的規則。 排除檔案可防止 Live Share 在如 [移至定義] 或 [在偵錯工具中逐步執行] 或 [遵循] 的情況下,為來賓開啟該檔案。若要隱藏或排除檔案,請將具有適當設定的 vsls json 檔案新增至您的專案。 如需詳細資訊,請參閱 控制檔案存取和可見度

  4. 開始共同作業工作階段

    若要啟動會話,請選取狀態列上的Live Share ,或選取Ctrl + shift + pCmd + shift + P ,然後選取 [ Live Share:啟動共同作業會話 (共用) ]。

    顯示 Live Share 按鈕的螢幕擷取畫面。

    注意

    當您第一次共用時,您的桌面防火牆軟體可能會提示您允許 Live Share 代理程式開啟埠。 開啟埠是選擇性的。 當您正在使用的人員位於與您相同的網路時,它會啟用安全的直接模式以改善效能。 如需詳細資訊,請參閱 變更連接模式

    邀請連結會自動複製到您的剪貼簿。 在瀏覽器中開啟時,此連結可讓其他人加入共用資料夾內容的新共同作業會話。

    您也會看到Live Share的狀態列專案變更,以代表會話狀態。 若要查看它看起來的樣子,請參閱本文稍後的 會話狀態 資訊。

    如果您需要在開始共用之後再次取得邀請連結,您可以選取 [會話狀態] 狀態列專案,然後選取 [ 邀請其他人] (複製連結) 來取得邀請連結。

  5. [選擇性] 啟用唯讀模式

    開始共同作業會話之後,您可以將會話設為唯讀,以防止來賓對您要共用的程式碼進行編輯。

    在您共用之後,您會收到通知,指出邀請連結已複製到剪貼簿。 然後,您可以選取此選項,讓會話變成隻讀:

    顯示 [設為唯讀] 按鈕的螢幕擷取畫面。

  6. 將連結傳送給某人

    透過電子郵件、時差、Skype 或其他平臺,將連結傳送給您想要邀請的來賓。 根據 Live Share 會話可提供給來賓的存取層級,您應該只與您信任的人共用,而且您應該考慮您所共用的內容的含意。

    安全性秘訣:想要瞭解某些 Live Share 功能的安全性含意嗎? 請參閱安全性一文。

    您邀請的來賓可能有問題。 快速入門:加入您的第一個會話文章提供以來賓入門的相關資訊。

  7. [選擇性] 核准來賓

    根據預設,來賓會自動加入您的共同作業工作階段,當他們準備好要與您共同作業時,您會收到通知。 此通知可讓您選擇將它們從會話中移除。 您也可以選擇是否需要對加入的任何人進行明確的核准。

    若要啟用這項核准,請將下列程式碼新增至設定. json:

    "liveshare.guestApprovalRequired": true
    

    當您開啟此設定時,通知將會提示您核准來賓,然後才能加入:

    顯示 Visual Studio Code 加入核准要求的螢幕擷取畫面。

    如需邀請安全性考慮的詳細資訊,請參閱 邀請和加入存取

大功告成!

停止共同作業工作階段

作為主機,您可以完全停止共用並結束共同作業會話。 若要這樣做,請在 [ Explorer ] 索引標籤上開啟 Live Share 視圖,或在 [ VS Live Share ] 索引標籤上選取 [停止共同作業會話] 按鈕

顯示 [停止共同作業會話] 按鈕的螢幕擷取畫面。

所有來賓都會收到會話已結束的通知。 會話結束後,來賓將無法存取該內容。 任何暫存檔案將會自動清除。

有共用方面的問題嗎? 請參閱 疑難排解 文章。

加入並離開會話

在下載並安裝 Visual Studio Live Share 之後,來賓只需要執行幾個步驟,即可加入託管的共同作業會話。 有兩種方式可以加入:透過 瀏覽器 並以 手動方式進行。

安全性秘訣: 加入共同作業會話的來賓必須瞭解,主機可能會限制其對特定檔案或功能的存取權。 想瞭解 Live Share 功能和設定的安全性含意嗎? 請參閱安全性一文。

透過瀏覽器加入

加入共同作業會話最簡單的方式,就是直接在網頁瀏覽器中開啟邀請連結。 以下是預期的事項:

  1. 登入

    當您安裝 Live Share 擴充功能、重載並等候相依性安裝之後,請登入,讓其他共同作業者知道您的身分。 如需詳細資訊,請參閱登

  2. 選取邀請連結/在您的瀏覽器中開啟邀請

    只要開啟 (,或在瀏覽器中重新開啟) 邀請連結。

    注意

    如果您尚未安裝 Live Share 擴充功能,您將會取得 Marketplace 的連結。 安裝擴充功能,重新開機您選擇的工具,然後重試。

    您應該會收到通知,指出瀏覽器想要啟動已針對 Live Share 啟用的工具。 如果您讓它啟動工具,您將會在啟動時連接到共同作業會話。

    顯示瀏覽器中 [聯結] 頁面的螢幕擷取畫面。

    如果主機離線,您將會收到通知。 您可以連絡主持人,並要求再次共用。

    注意

    在安裝 Visual Studio Live Share 擴充功能之後,請確定您至少已啟動工具一次,並在開啟/重新開啟邀請頁面之前允許安裝完成。 仍然遇到問題嗎? 請參閱 手動加入

  3. 共同作業

    大功告成! 您將會在這段時間內進行連線,並開始進行共同作業。

    您會看到 [ Live Share ] 按鈕變更,以傳達會話狀態。 請參閱本文稍後的 會話狀態 相關資訊。

    當聯結完成時,系統會自動將您移至主機目前正在編輯的檔案。

手動加入

您也可以手動加入,而不需要使用網頁瀏覽器。 當您想要使用的工具已在執行、您想要使用您不常使用的工具,或讓邀請連結無法運作時,此選項會很有用。 流程很簡單:

  1. 登入

    當您安裝 Live Share 擴充功能、重載並等候相依性安裝之後,請登入以讓其他共同作業者知道您的身分。 如需詳細資訊,請參閱登

  2. 使用加入命令

    在 Visual Studio Code 活動列的 [ Live Share ] 索引標籤上,選取 [加入共同作業會話] 按鈕或專案:

    顯示 [加入共同作業會話] 按鈕的螢幕擷取畫面。

  3. 貼上邀請連結

    貼上您傳送的邀請 URL,然後選取 [ 輸入 ] 以確認。

  4. 合作!

    這樣就完成了! 您很快就會連接到共同作業會話。

    [ Live Share ] 按鈕將會變更,以傳達會話狀態。 請參閱本文稍後的 會話狀態 相關資訊。

    當聯結完成時,系統會自動將您移至主機目前正在編輯的檔案。

離開共同作業會話

如果您是來賓,只要關閉 Visual Studio Code 視窗,您就可以離開共同作業會話,而不需要結束其他人。 如果您想要讓視窗保持開啟,您可以開啟 Live Share Explorer索引標籤或 [ VS Live Share ] 索引標籤,然後選取 [離開共同作業會話] 按鈕:

顯示 [離開共同作業會話] 按鈕的螢幕擷取畫面。

系統會自動清除任何暫存檔案,因此您不需要進行任何其他動作。

加入時遇到問題嗎? 查看 疑難排解

共同編輯

注意

共同編輯有某些語言的限制。 如需語言特定功能的詳細資訊,請參閱 平臺支援

當來賓加入共同作業會話時,所有共同作業者都會立即能夠即時看到彼此的編輯和選取。 您只需要從 [檔案總管] 中挑選檔案並開始編輯。 主機和來賓會在您進行編輯時看到編輯內容,並可讓您輕鬆地反復查看並快速解決問題。

顯示共同編輯會話的螢幕擷取畫面。

注意

加入唯讀共同作業會話的來賓無法對檔案進行編輯。 主機可以 在共用會話時啟用唯讀模式。 您可以藉由查看 會話狀態來判斷是否已加入唯讀會話。

參與者可以看到資料指標和編輯。 他們也可以看到您所做的選擇。 這可讓您輕鬆地強調可能存在的問題或傳達構想。

顯示所選程式碼的螢幕擷取畫面。

您和其他參與者都可以移至共用專案中的任何檔案。 您可以一起編輯或獨立編輯,讓您可以從調查中順暢地切換,以對完整的共同作業編輯進行較小的變更。

儲存後,所產生的編輯會保存在主機的電腦上。 因此,當您完成編輯時,不需要同步處理、推送或傳送檔案。

安全性秘訣: 由於所有參與者都可以獨立地移至檔案,並以主機的形式編輯檔案,因此您可能會想要透過 vsls 檔案來限制來賓能夠在您的專案中存取的檔案。 如果您是來賓,您應該瞭解這些設定可能不會看到某些檔案。 如需詳細資訊,請參閱 控制檔案存取和可見度

變更參與者旗標行為

根據預設,Visual Studio Live Share 會在滑鼠停留時,或在參與者進行編輯、反白顯示某部分或移動游標時,自動顯示參與者游標旁的旗標。 在某些情況下,您可能會想要變更此行為。

若要變更此行為,請開啟 [設定] (檔案喜好設定 設定) 、新增下列其中一行,然後重新開機 Visual Studio Code。

設定 行為
"liveshare.nameTagVisibility":"Never" 只有當您將滑鼠停留在游標上方時,才會顯示旗標。
"liveshare.nameTagVisibility":"Activity" 此為預設值。 此旗標會在滑鼠停留時顯示,或在參與者編輯、反白顯示或移動游標時顯示。
"liveshare.nameTagVisibility":"Always" 旗標一律為可見。

尋找並列出參與者

若要快速查看共同作業會話中的人員,請查看 Live Share Explorer索引標籤或 [ VS Live Share ] 索引標籤上的 [參與者] 清單:

顯示會話中參與者的螢幕擷取畫面。

若要在使用中的編輯器群組中追蹤這份清單中的任何參與者,請選取參與者。

或者,您也可以選取Ctrl + shift + pCmd + shift + P ,然後選取 [ Live Share:列出參與者] 或選取狀態列專案,以顯示您會話中的參與者數目:

顯示狀態列專案的螢幕擷取畫面。

會話中的所有參與者清單都會出現。 此處的行為與圖釘按鈕的行為不同。 即使會話中只有一個其他人,也會顯示此清單,讓您隨時都能快速查看其他人的所在位置。 如同圖釘按鈕,您可以挑選清單中的參與者來追蹤它們。 如果您想要改為結束,請選取 Esc

與共同作業者一起追蹤

您有時需要說明橫跨多個檔案或程式碼中多個位置的問題和設計。 在這些情況下,當您的同事在整個專案中移動時,可能會很有用。 基於這個理由,當您加入共同作業會話時,您會自動遵循主機。 當您關注某人時,您的編輯器會與該人員目前開啟的檔案和滾動位置保持同步。

注意

根據預設,Live Share 會共用共用資料夾之外的開啟檔案。 如果您想要變更此行為,請 liveshare.shareExternalFiles 在 [設定] 中變更為 false

要求焦點

您有時可能會希望共同作業會話中的每個人都能查看您所做的事情。 Live Share 可讓您要求所有人專注于您的通知,讓他們可以輕鬆地追蹤您的情況。

開啟 Visual Studio Code 活動列或 Live Share Explorer索引標籤中的 [ VS Live Share ] 索引標籤,然後選取 [焦點參與者] 按鈕:

顯示焦點參與者按鈕的螢幕擷取畫面。

共同作業會話中的每個人都會收到通知,指出您已要求他們注意:

顯示要求焦點通知的螢幕擷取畫面。

然後,當他們準備好將焦點放在您的動作時,他們就可以選取通知中的 後續 動作。

啟動和停止下列共同作業者

若要開始將參與者 (為主機或來賓) ,請在 Live Share Explorer索引標籤或 [ VS Live Share ] 索引標籤上的 [參與者] 清單中選取參與者的名稱。名稱旁邊的圓圈將會變成實線,表示您正進行下列動作:

顯示即將遵循之參與者的螢幕擷取畫面。

或者,您也可以選取編輯器群組右上角的圖釘按鈕,或選取 Ctrl + alt + fCmd + alt + F

顯示圖釘按鈕的螢幕擷取畫面。

注意

如果共同作業會話中有一個以上的人,系統會提示您選取想要遵循的參與者:

顯示參與者清單的螢幕擷取畫面。

因為下列連結至編輯器群組,所以您可以使用「分割視圖」或「格線版面配置」來建立群組,而該群組位於參與者和非的群組後面。 此配置可讓您被動地追蹤某個人,同時也能獨立處理某項工作。 當您選取編輯器群組時,您可以選取參與者清單中的參與者,讓群組遵循參與者。

顯示分割視圖中兩個編輯器群組的螢幕擷取畫面。

為了讓您輕鬆切換出追蹤模式並開始自行編輯,如果發生下列其中一個動作,您將會自動停止:

  • 您開啟不同的檔案。
  • 您關閉目前作用中的檔案。

此外,您可以再次選取圖釘按鈕,或選取 Ctrl + alt + fCmd + alt + f,以明確地停止下列人員。

共同偵錯

Visual Studio Live Share 共同作業的偵錯工具,是一個功能強大的方法,可讓您進行問題的偵測。 它可提供共同作業體驗來針對問題進行疑難排解。 它也可讓您和其他參與者在您的會話中,藉由在主機電腦上提供共用的偵測會話,來調查可能是特定環境的問題。

安全性秘訣: 由於參與者可以獨立地移入和編輯檔案,因此您可能會想要透過 vsls 檔案來限制來賓可以在專案中存取的檔案。 您也應該注意主控台/複寫存取可讓參與者在您的電腦上執行命令,因此您應該只與您信任的人員共同處理。 來賓應該會發現,由於設定的限制,它們可能無法在偵錯工具進入某些受限的檔案時遵循偵錯工具。 如需詳細資訊,請參閱 控制檔案存取和可見度

使用共同作業的偵錯工具很簡單。

  1. 確定主機和所有來賓都已安裝適當的調試延伸模組。 (安裝不一定是必要的,但通常是個不錯的主意。 )

  2. 如果尚未針對專案設定主機,則應該將啟動設定為 [正常],將應用程式從 Visual Studio Code 中進行偵錯工具。 您不需要進行任何特殊的設定。

  3. 主機可以使用 [偵錯工具] 索引標籤上的按鈕,以正常方式啟動偵錯工具:

    顯示 [Visual Studio Code debug] 按鈕的螢幕擷取畫面。

    提示

    您也可以從 Visual Studio Code 參與 Visual Studio 的偵測會話,反之亦然。 如需詳細資訊,請參閱共同調試的Visual Studio 指示

當偵錯工具在主機端連接時,也會自動附加所有來賓。 在主機的電腦上有一個執行中的偵錯工具,但所有參與者都與其連線,而且有自己的觀點:

顯示 Visual Studio Code 偵錯工具的螢幕擷取畫面。

任何人都可以逐步執行偵錯工具,讓您可以在共同作業者之間切換,而不需要協調控制。

注意

請參閱 平臺支援 ,以取得有關依語言或平臺來偵測功能支援的詳細資訊。

每個共同作業者都可以調查變數、移至呼叫堆疊中的各種檔案、檢查變數,甚至新增或移除中斷點。 共同編輯功能可讓每個參與者追蹤其他人所在的位置,讓他們可以在同時調查問題的各個層面和共同的偵錯工具之間切換。

注意

在唯讀共同作業會話中,來賓將無法逐步執行偵錯工具。 他們可以新增或移除中斷點,以及檢查變數。

顯示並行調試的動畫。

Visual Studio Code 聯結調試會話時變更

根據預設,來賓會自動附加至主機共用的偵測會話。 您可能會發現這種行為會造成干擾。

若要變更此行為,請開啟settings (檔案喜好設定 設定) ,新增下列幾行,然後重新開機 Visual Studio Code:

設定 行為
"liveshare.joinDebugSessionOption":"Automatic" 預設值。 身為來賓,您會自動加入主持人啟動的任何偵錯工作階段。
"liveshare.joinDebugSessionOption":"Prompt" 以來賓的身份,系統會在主機啟動時提示您加入共用的偵錯工具會話。
"liveshare.joinDebugSessionOption":"Manual" 如果您是來賓,則必須手動加入偵測會話。 請參閱卸 離和重新附加

中斷連結與重新附加

如果您是來賓,您可能會想要暫時停止調試。 您可以在偵錯工具列上選取 [ 停止 ] 按鈕,以卸離偵錯工具,而不會影響主機或其他來賓:

顯示 [停止] 按鈕的螢幕擷取畫面。

如果您已更新設定,所以不會自動附加,或者您想要稍後再附加,可以選取 Ctrl + shift + PCmd + shift + P ,或選取 [會話狀態] 狀態列專案,然後選取 [ 附加至共用的偵測會話]:

顯示 [附加至共用的偵錯工具] 命令的螢幕擷取畫面。

在瀏覽器中共用正在執行的應用程式

不同于 Visual Studio,Visual Studio Code 不支援專案類型的已知 web 應用程式埠,例如 ASP.NET。 但是,如果您要從 Visual Studio 主機加入共同作業會話,您可能會在啟動偵錯工具時自動看到預設瀏覽器出現。 然後,瀏覽器會自動連接至主機執行中的應用程式。 如需詳細資訊,請參閱Visual Studio 功能

作為主機,您可以使用共用本機伺服器功能,手動共用應用程式或其他端點(例如 RESTful services)來達到類似的內容。 Visual Studio 和 Visual Studio Code 來賓接著可以在相同的 localhost 埠上開啟瀏覽器,以查看正在執行的應用程式。 如需詳細資訊,請參閱 共用伺服器

共用伺服器或終端機

伺服器共用

從時間的不同,共同作業工作階段主機可能會想要與來賓共用 web 應用程式或其他本機執行的伺服器或服務。 這可以範圍從其他 RESTful 端點到資料庫及其他伺服器。 Visual Studio Live Share 可讓您指定本機連接埠號碼,選擇性地為它命名,然後將它與所有來賓共用。

來賓接著就可以從相同埠上的本機電腦,存取您在該埠上共用的伺服器。 例如,如果您共用在通訊埠3000上執行的 web 伺服器,來賓可以在自己的電腦上存取該相同執行中的網頁伺服器。 http://localhost:3000.

此連線是透過主機和來賓之間改進的安全性 SSH 或 SSL 通道來完成,並透過服務進行驗證。 此連接機制可協助確保只有共同作業會話中的人員具有存取權。

安全性秘訣: 作為主機,您可以選擇是否要與來賓共用埠。 (的應用程式埠,而不是) 共用系統埠。 對於來賓而言,共用埠的行為會與伺服器/服務在來賓電腦上執行時的行為完全相同。 此行為很有用,但如果您共用錯誤的埠,則可能會有風險。

基於安全性理由,只有在您指定的通訊埠上執行的伺服器可供其他來賓使用。 共同作業工作階段主機可以輕鬆地新增一個。 方式如下:

  1. 在 [ VS Live Share ] 索引標籤或 [Live Share Explorer ] 索引標籤上,選取 [共用伺服器] 專案或按鈕:

    顯示 [共用伺服器] 按鈕的螢幕擷取畫面。

  2. 輸入伺服器執行所在的埠號碼。 (選擇性)輸入名稱:

    顯示埠號碼提示的螢幕擷取畫面。

大功告成! 您所指定之埠上的伺服器現在會對應到相同埠上的每個來賓的 localhost (除非該埠已) 使用。

如果埠已在來賓的電腦上使用,則會自動選取不同的埠。 如果您是在 Live Share Explorer索引標籤或VS Live Share索引標籤上指定) ,您可以使用來賓的名稱來查看共用埠清單 (。此清單位於 [共用伺服器] 下。 如果您選取埠,則該伺服器會在您的瀏覽器中開啟。 您也可以按一下滑鼠右鍵,然後選取將伺服器連結複製到剪貼簿的選項。

顯示 [共用伺服器] 清單的螢幕擷取畫面。

基於安全性理由,來賓無法控制主機電腦上的哪些埠是共用的。

若要停止共用本機伺服器,主機可以將滑鼠停留在 [ 共用伺服器 ] 清單中的伺服器專案上方,然後選取 [取消共用 伺服器 ] 按鈕:

顯示 [取消共用伺服器] 按鈕的螢幕擷取畫面。

終端機共用

新式開發人員經常使用各種命令列工具。 Live Share 可讓主機與來賓共用終端機。 共用的終端機可以是唯讀或完全共同作業,因此您和來賓可以執行命令並查看結果。 您可以讓來賓看得到終端機輸出。 您也可以讓他們執行測試或組建,甚至將只發生在您電腦上的環境特定問題分級。

依預設,不會共用終端機,因為它們可讓來賓至少以唯讀方式存取您執行的命令 (如果無法自行執行命令) 的能力。 此預設設定可讓您在本機終端機中執行命令,其風險較低,而且只有在需要時才會共用。 而且只有主機可以啟動共用終端。 這項限制可防止來賓啟動,並執行您不需要的某些工作。

如果您是主機,您可以從VS Live Share或 Live Share Explorer索引標籤共用終端機。請選取 [共用] 終端機專案或按鈕:

顯示 [共用終端機] 按鈕的螢幕擷取畫面。

此時,您可以選擇是否要將終端機設為唯讀或讀取/寫入。 當終端機為讀取/寫入時,每個人都可以在終端機中輸入,包括主機。 作為主機,您可以輕鬆地介入來賓是否執行您不喜歡的動作。

為了安全起見,您應該 只在知道他們真正需要的時候,才授與來賓的讀取/寫入存取權。 當您只想要來賓查看您執行的命令輸出時,請使用唯讀的終端機。 請記住,讀取/寫入存取權可讓來賓對您的終端機具有相同的存取權。 他們可以在您的電腦上執行您可以執行的任何命令。

注意

如果共同作業會話處於唯讀模式,主機只能共用唯讀的終端機。

顯示存取層級之唯讀和讀取/寫入選項的螢幕擷取畫面。

在您選取要啟動的共用終端機類型之後,新的共用終端機將會出現在 [Visual Studio Code終端機] 索引標籤中:

顯示 Visual Studio Code 中的 [終端機] 索引標籤的螢幕擷取畫面。

如果共用多個終端機,或焦點是在不同的索引標籤中,您可以選取 [ 共用的終端 機] 清單中的專案,將焦點帶入終端機:

顯示共用終端機清單的螢幕擷取畫面。

若要結束終端機會話,請輸入exit,關閉終端機視窗,或選取 Live Share Explorer索引標籤或 [ VS Live Share ] 索引標籤上的 [取消共用終端機] 按鈕。每個人都會中斷連線。

會話狀態和限制

當您啟動或加入共同作業會話之後,Visual Studio Live Share 狀態列專案會反映作用中會話的狀態。

這些是您通常會看到的狀態:

狀態 狀態列專案 描述
非使用中 VS Code 狀態:非使用中 沒有作用中的共同作業會話。 不共用任何專案。
主機:共用 In-Progress VS Code 狀態:共用正在進行中 正在啟動共同作業會話。 內容共用即將開始。
主機:共用 VS Code 狀態:共用作用中 共同作業會話為作用中狀態。 內容是共用的。
主機:共用唯讀 VS Code 狀態:正在共用唯讀 主機正在共用唯讀共同作業會話。
Guest:加入會話 VS Code 狀態:正在加入 來賓正在加入現有的共同作業會話。
來賓:已加入 VS Code 狀態:已加入 Guet 已加入並聯機到作用中的共同作業會話,並接收共用內容。
Guest:已加入唯讀 VS Code 狀態:已加入唯讀 來賓已加入並聯機到作用中的唯讀共同作業會話。

雖然目前在使用本文中所述的功能時,來賓仍會經歷一些缺點,但共同作業工作階段主機仍保有其所選工具的完整功能。 如需詳細資訊,請參閱

下一步

如需詳細資訊,請參閱下列文章:

有問題嗎? 請參閱疑難排解提供意見反應

準備好開始與 Visual Studio Code 中的 Live Share 合作嗎? 在本文中,我們將逐步引導您使用 Live Share 擴充功能,在 Visual Studio Code 中設定共同作業會話。

請注意,此處所述的共同作業活動牽涉到單一共同作業工作階段主機和一或多個來賓。 主持人是啟動共同作業會話的人員,而加入的任何人都是來賓。

在尋找簡易摘要嗎? 請查看 共用加入 快速入門。

提示

您知道您可以加入自己的共同作業會話嗎? 這樣做可讓您自行嘗試 Live Share 或啟動 Visual Studio 的實例或 Visual Studio Code,並從遠端連線到該實例。 您甚至可以在這兩個執行個體使用相同的身分識別。 趕緊去瞧一瞧!

必要條件

開始之前,您需要支援的 Visual Studio Code 版本,以符合 Live Share 核心需求。

您將需要在下列其中一個作業系統上執行的 Visual Studio Code (1.22.0 或更新版本) :

  • Windows:7、8.1 或10。

  • macOS:塞拉里昂 (10.12) 和更新版本。 由於 .Net Core 2.0 的需求,目前不支援 El Capitan (10.11) 及更早版本。

  • Linux:64位 Ubuntu Desktop 16.04 和更新版本、Fedora 工作站27和更新版本,或 CentOS 7。

    • Live Share 需要 Linux 的一些必要條件。 系統可能會提示您安裝這些專案。
    • 因為 .Net Core 2.0 需求,所以不支援32位 Linux。
    • 目前不支援 ARM。
    • 請參閱 Linux 安裝詳細資料 ,以取得使用下游散發套件和其他散發套件的相關資訊。

安裝 Live Share 擴充功能套件

當您下載並使用 Visual Studio Live Share 時,即表示您同意授權條款隱私權聲明。 如果您遇到問題,請參閱疑難排解

  1. 安裝 Visual Studio Code
  2. 從 Marketplace下載並安裝 Visual Studio Live Share 擴充功能套件。
  3. 重載 Visual Studio Code。
  4. 等待相依性下載並安裝。 (查看狀態列。 )
    顯示在下載期間狀態列的螢幕擷取畫面。
  5. 僅限 Linux:如果您看到有關安裝遺失程式庫的通知:
    1. 在通知中選取 [ 安裝 ]。
    2. 收到提示時,輸入您的系統管理員 (sudo) 密碼。
    3. 當安裝完成時,請重新開機 Visual Studio Code。

按鈕以下載 Live Share。

Linux 安裝步驟

Linux 是高度變數的環境。 由於桌上型電腦環境和散發的數目,安裝 Live Share 可能會變得複雜。 如果您使用支援的 Ubuntu Desktop 版本 (16.04 +) 、Fedora 工作站 (27 +) 或 CentOS 7,而且只使用 Visual Studio Code 的正式發行版本,程式應該很簡單。 如果您使用非標準的設定或下游散發,您可能會遇到複雜的情況。 如需詳細資訊,請參閱 Linux 安裝詳細資料

安裝 Linux 必要條件

某些 linux 發行版本缺少 Live Share 需要的程式庫。 根據預設,Live Share 會嘗試偵測並安裝 Linux 必要條件。 當 Live Share 遇到可能由遺失程式庫造成的問題時,您會看到通知您安裝程式庫的提示:

螢幕擷取畫面:缺少 Linux 程式庫的通知。

當您選取 [ 安裝] 時,將會開啟終端機視窗。 輸入您的系統管理員 (sudo) 密碼以繼續。 如果安裝成功完成,請重新開機 Visual Studio Code。 您應該全部設定。 您也可能想要依散發查看提示,以取得其他提示和因應措施。

如果您看到一則訊息,指出腳本不支援您的散發套件,請參閱適用于社區所支援之散發套件的提示,以取得該社區與我們共用的資訊。

如果您不想 Visual Studio Code 為您執行命令,您也可以從終端機視窗執行下列命令,隨時重新執行此腳本的最新版本:

wget -O ~/vsls-reqs https://aka.ms/vsls-linux-prereq-script && chmod +x ~/vsls-reqs && ~/vsls-reqs

Linux 瀏覽器整合

Visual Studio Live Share 通常不需要額外的安裝步驟,即可在 Linux 上啟用瀏覽器整合。

在某些罕見的散發套件上,您可能會收到系統管理員 (sudo) 需要密碼才能完成安裝的通知。 終端機視窗會顯示將會安裝瀏覽器啟動器的位置。 出現提示時,請輸入您的密碼,然後在安裝完成時選取 Enter 鍵 ,以關閉終端機視窗。

如需為何需要密碼以及 Live Share 放置檔案的詳細資訊,請參閱Linux 瀏覽器整合。 如果您無法讓瀏覽器整合運作,您仍然可以 手動加入共同作業會話。

登入 Live Share

若要共同作業,您必須登入 Visual Studio Live Share,讓每個人都知道您的身分。 這是安全性措施,不會將您新增至行銷活動或其他研究活動。 您可以使用 microsoft 個人帳戶登入 (例如 @outlook .com) 、Microsoft 所支援的工作或學校帳戶 (Azure Active Directory) 或 GitHub 帳戶。 登入很簡單。

選取狀態列上的Live Share ,或選取Ctrl + shift + pCmd + shift + P ,然後選取 [ Live Share:使用瀏覽器登入]。

顯示 Visual Studio Code 登入按鈕的螢幕擷取畫面。

通知會提示您使用網頁瀏覽器登入。 當您選取 [ 啟動登入] 時,瀏覽器將會開啟,讓您可以完成登入程式。 當您完成時,只要關閉瀏覽器即可。

顯示提示網頁瀏覽器登入通知的螢幕擷取畫面。

注意

Linux 使用者:如果您使用較舊版本的 Live Share (0.3.295 或更早的) ,系統可能會提示您輸入使用者程式碼。 更新為最新版本的延伸模組,或在您登入之後,查看程式碼,請選取 [ 有問題嗎? ]。 如需詳細資訊,請參閱 使用使用者程式碼登入

Advanced 提示:liveshare.accountProvider 如果您有多個帳戶的快取認證,和設定可讓您選取用於自動登入的帳戶。 例如,假設您在兩個專案上工作,而您想要使用不同的身分識別來登入它們。 在您的 Visual Studio Code 工作區設定中,您可以 liveshare.account 在每個專案目錄中設定為不同的電子郵件地址。 然後,專案會使用正確的帳戶自動登入。 liveshare.accountProvider"microsoft""github" 如果您對多個提供者使用相同的電子郵件地址,您可以將設定設為或。

如果您在瀏覽器中完成登入程式之後 Visual Studio Code 未收取登入,請參閱使用使用者程式碼登入。 或查看更多秘訣的 疑難排解

使用使用者程式碼登入

如果 Visual Studio Code 未挑選完成的登入,您可以改為輸入使用者程式碼

  1. 選取Ctrl + shift + pCmd + shift + P ,然後執行Live Share:使用使用者程式碼登入] 命令。

  2. 瀏覽器應該會開啟。 使用它來完成登入程式:

    注意

    如果瀏覽器未自動開啟,請移至 https://insiders.liveshare.vsengsaas.visualstudio.com/auth/login 並登入。

  3. 完成之後,請選取 [ 遇到問題嗎?]。按一下這裡可取得使用者程式碼指示 ,以查看使用者程式碼。

    在瀏覽器視窗中顯示使用者程式碼的螢幕擷取畫面。

  4. 複製使用者程式碼。

  5. 將使用者程式碼貼到您執行命令時所出現的輸入欄位。 選取 [ 輸入 ] 以完成登入程式。

    顯示使用者程式碼輸入方塊的螢幕擷取畫面。

尋找 Live Share 命令

在 Live Share viewlet

安裝 Visual Studio Live Share 之後,自訂索引標籤會出現在 [Visual Studio Code] 活動列中。 在此索引標籤上,您可以存取所有 Live Share 函式以進行共同作業。 當您共用或加入共同作業會話時,[ 瀏覽器 ] 索引標籤上也會出現一個視圖,可讓您存取這些功能。