🚀 在 VS Code 中取得 ！

2022 年 7 月 (版本 1.70)

更新 1.70.1：此更新解決了這些 問題。

更新 1.70.2：此更新解決了這些 問題。

更新 1.70.3：此更新僅適用於 Windows 7 使用者，並且是最後一個支援 Windows 7 的版本。

下載：Windows: x64 Arm64 | Mac: 通用 Intel silicon | Linux: deb rpm tarball Arm snap

歡迎使用 Visual Studio Code 2022 年 7 月版。此版本有許多更新，我們希望您會喜歡，其中一些主要重點包括

如果您想在線上閱讀這些版本資訊，請前往 更新，網址為 code.visualstudio.com。

觀看發行派對： 聆聽 VS Code 團隊討論一些新功能。您可以在我們的 YouTube 頻道上找到活動錄影。

Insiders： 想盡快試用新功能嗎？您可以下載每晚的 Insiders 組建，並在最新更新可用時立即試用。

工作台

更輕鬆的標題列自訂

對於使用自訂標題列的使用者 (Windows、macOS 和 Web 上的預設值)，您可能已經注意到我們正在標題列中引入更多互動式內容。雖然已經有設定可以個別隱藏這些元素，但您現在可以按一下滑鼠右鍵標題列來存取內容功能表，以切換功能表列 (macOS 桌面版上未顯示)、命令中心和版面配置控制項。

title bar context menu

對於預期系統內容功能表的 Windows 使用者，仍然可以透過按一下滑鼠右鍵視窗左上角的 VS Code 圖示，或按下 Alt+Space 來觸發功能表。滑鼠位置用於判斷使用 Alt+Space 觸發時的行為，因此如果自訂功能表位於標題列上方，則會顯示自訂功能表。

system context menu

對於 Linux 使用者，由於 問題 #156397，標題列中的空白區域不會開啟內容功能表。您必須按一下滑鼠右鍵您想要隱藏的標題列中的其中一個項目。

改進的功能表列摺疊

隨著命令中心的加入，我們嘗試將功能表列縮減為漢堡功能表以騰出空間。在收到使用者意見反應後，我們切換回舊的功能表列摺疊行為，直到大部分功能表摺疊，然後才切換到漢堡功能表。

可存取的 macOS 標題列縮放

同樣作為改進命令中心體驗的一部分，當 macOS 上標題列中存在互動式元件時，標題列現在會與 UI 的其餘部分一起縮放，以提高可存取性。

摺疊選取範圍

命令從選取範圍建立手動摺疊範圍 (⌘K ⌘, (Windows、Linux Ctrl+K Ctrl+,)) 從目前選取的行建立摺疊範圍，並將其摺疊。此範圍稱為手動摺疊範圍，並且位於摺疊提供者計算的範圍之上。

可以使用命令移除手動摺疊範圍再次移除手動摺疊範圍 (⌘K ⌘. (Windows、Linux Ctrl+K Ctrl+.))。

當沒有程式設計語言支援摺疊時，手動摺疊範圍特別有用。

保留摺疊範圍

即使摺疊範圍不再是摺疊提供者計算的範圍的一部分，VS Code 現在也會保留摺疊範圍。典型的範例是當使用者註解檔案、啟動字串常值或建立語法錯誤時，導致無法建立所有範圍。此類摺疊範圍會變成「已復原」範圍。一旦摺疊提供者在相同位置傳回範圍，或使用命令移除手動摺疊範圍，就會移除這些範圍。

隱藏摺疊控制項

現在可以使用設定 "editor.showFoldingControls": "never" 隱藏裝訂邊中的摺疊控制項。仍然可以使用摺疊命令和快速鍵展開和摺疊摺疊範圍。

3 向合併編輯器改進

我們繼續潤飾新的 3 向合併編輯器，並在此版本中預設啟用它。可以透過按一下原始檔控制檢視中的衝突檔案來開啟合併編輯器。

重點包括從一側接受所有變更的新命令、改進的內容功能表、增強的差異色彩，以及更強調衝突與非衝突變更。

我們也開始探索替代的差異演算法，以提高合併衝突的精確度。如果您在差異或合併編輯器中遇到次佳的變更醒目提示或對齊方式，我們希望在我們的 GitHub 問題追蹤器中記錄這些案例！

命令列選項 merge

您現在可以使用命令列選項在 VS Code 中開啟合併編輯器

-m --merge <path1> <path2> <base> <result> Perform a three-way merge by providing paths for two modified versions of a file, the common origin of both modified versions, and the output file to save merge results.

例如，如果您在 .gitconfig 中設定此選項，這可讓您使用 VS Code 作為 Git 的合併工具

[merge]
  tool = code
[mergetool "code"]
  cmd = code --wait --merge $REMOTE $LOCAL $BASE $MERGED

搜尋檔案裝飾

搜尋檢視中的搜尋結果現在在右側具有檔案裝飾和色彩，以表示檔案的問題和原始檔控制資訊。這與檔案總管中已顯示的檔案裝飾類似。

Search file decorations

搜尋多重選取

搜尋檢視現在也支援多重選取。您對選取範圍中的一個結果執行的任何動作 (例如，關閉或取代) 也會對其他選取的項目執行。

樹狀尋找控制項

樹狀檢視 (例如檔案總管) 現在支援尋找控制項。您可以在樹狀結構內按下 ⌥⌘F (Windows、Linux Ctrl+Alt+F) 以彈出尋找控制項。您可以使用尋找控制項來醒目提示相符的元素，或切換篩選按鈕以隱藏所有不符合搜尋詞彙的元素。

注意： 如果您習慣在檔案總管具有焦點時，透過叫用 ⌥⌘F (Windows、Linux Ctrl+Alt+F) 在編輯器中開啟尋找控制項，您可以據此設定您的鍵盤繫結

{
  "key": "cmd+f", // "ctrl+f" on Windows/Linux
  "command": "-list.find",
  "when": "listFocus && listSupportsFind"
}

透過 [新增檔案] 建立任意檔案

已改進 [檔案] > [新增檔案...] ([歡迎使用] 頁面上的 [新增檔案...] 連結) 體驗，以允許建立任意檔案。您現在可以在快速輸入方塊中輸入檔案名稱，以在磁碟上建立檔案。

A input box with test.js inputted into it and the entry New File(test.js) selected

終端機

預設啟用 Shell 整合

上一個版本移出預覽的 Shell 整合自動注入現在預設為啟用。對於支援的 Shell 設定 (大多數 bash/zsh/pwsh 組態)，它應該可以正常運作，而無需任何變更，而且您應該會看到命令裝飾

When shell integration is enabled, blue, red and grey circles appear next to commands run in the terminal

佈景主題：Sapphire Theme

注意：在 Windows 上，您需要 PowerShell 7 (pwsh) 才能支援 Shell 整合。您可以透過 https://aka.ms/PSWindows 安裝。

如果 Shell 整合功能未自動亮起，您將需要設定手動安裝，這已在此版本中簡化。

當 terminal.integrated.shellIntegration.enabled 設定設定為 true 時，會啟用自動注入，將此設定新增至您的 settings.json 檔案以停用此功能

"terminal.integrated.shellIntegration.enabled": "false"

這將僅停用 VS Code 的 Shell 整合注入。即使停用，如果您的設定已為 VS Code 了解的其他終端機啟用 Shell 整合，它仍然會挑選這些整合。如果您不喜歡命令和/或捲軸裝飾，您可以只停用它們的顯示，同時仍然利用 Shell 整合帶來的額外功能。

簡化的 Shell 整合手動安裝

先前的手動安裝需要多個步驟，並且是平台和 Shell 特定的。新的手動安裝使用 code CLI 來擷取 Shell 整合指令碼，並且跨平台運作，並且在連線到遠端視窗時運作，這表示您可以將其同步到您的點檔案中，而且它應該可以正常運作。

# Manual install on bash
[[ "$TERM_PROGRAM" == "vscode" ]] && . "$(code --locate-shell-integration-path bash)"

您可以在 終端機 Shell 整合中閱讀有關如何為其他 Shell 安裝 Shell 整合的詳細資訊。

更多 Shell 整合組態選項

新的設定 terminal.integrated.shellIntegration.decorationsEnabled 可讓您在 gutter、overviewRuler 或兩者都不顯示命令裝飾。為了方便存取，您可以透過內容功能表中的 [設定命令裝飾] 修改此設定，當您按一下裝飾時 (選取 [切換可見性] 以顯示選項下拉式清單)。

The command decoration context menu contains the new option Configure Command Decorations

您也可以從下拉式清單中設定預設、成功或錯誤圖示。

預設色彩和圖示索引標籤設定

可以使用 terminal.integrated.tabs.defaultIcon 和 terminal.integrated.tabs.defaultColor 為每個資料夾設定預設圖示和終端機索引標籤色彩。

擴充的 PowerShell 鍵盤繫結

由於 Shell 整合，還有其他 PowerShell 鍵盤繫結，例如 Ctrl+Space。由於缺少 VT 編碼，這些以前是不可能的。假設 Shell 整合在 pwsh 中運作，下列鍵盤繫結現在應該可以運作

  • Ctrl+Space - 預設為僅在 Windows 上為 MenuComplete。
  • Alt+Space - 預設為 SetMark。
  • Shift+Enter - 預設為 AddLine。
  • Shift+End - 預設為 SelectLine。
  • Shift+Home - 預設為 SelectBackwardsLine。

這適用於所有平台，甚至是通常不可能使用這些鍵盤繫結的 Linux/macOS。預設值始終可以在您的 pwsh 設定檔中使用 Set-PSReadLineKeyHandler 重設。如果您預期有其他鍵盤繫結，請告訴我們。

執行最近的命令以取代反向搜尋

啟用 Shell 整合時，我們的目標是執行最近的命令，以成為 Shell 反向搜尋 (Ctrl+R) 的跨 Shell 替代方案。有一種新的連續搜尋模式，它是觸發命令時的預設模式。這與大多數 Shell 中的 Ctrl+R 行為類似，並可選擇切換回模糊搜尋

新的 inTerminalRunCommandPicker 內容金鑰可用，可讓您設定鍵盤繫結，例如 Ctrl+R 以移至下一個相符項目。例如，下列鍵盤繫結現在是 Shell 反向搜尋的相當完整的替代方案，Ctrl+Alt+R 作為舊行為的回退

{ "key": "ctrl+r",     "command": "workbench.action.terminal.runRecentCommand", "when": "terminalFocus" },
{ "key": "ctrl+alt+r", "command": "workbench.action.terminal.sendSequence", "args": { "text": "\u0012"/*^R*/ }, "when": "terminalFocus" },
{ "key": "ctrl+r",     "command": "workbench.action.quickOpenNavigateNextInViewPicker", "when": "inQuickOpen && inTerminalRunCommandPicker" },
{ "key": "ctrl+c",     "command": "workbench.action.closeQuickOpen", "when": "inQuickOpen && inTerminalRunCommandPicker" },

多行命令現在會在適當的位置顯示新行符號，並且也會使用括號貼上模式，這表示它們會被視為已貼上，以支援 Shell。這通常表示它們都會新增至相同的提示，而不是個別執行它們。

Run recent command now shows the "Return Symbol" Unicode character (⏎, U+23CE) to visualize new lines

其他 Shell 整合改進

以下是 Shell 整合的較小改進

  • 命令導覽已改進視覺回饋，短暫顯示「焦點邊框」，然後在裝訂邊中保留持續的矩形，以協助醒目提示緩衝區中的位置。

    A solid rectangle the color of your theme's focus color now appears to the left of the command being navigated to

  • 新的 workbench.action.terminal.copyLastCommand 命令可用，以允許鍵盤繫結複製最後一個命令的輸出 (快捷方式為 Ctrl/Cmd+Shift+Up、Ctrl/Cmd+C、Escape、Ctrl/Cmd+End)。

  • Bash Shell 整合

    • 支援更多 $PROMPT_COMMAND 格式。
    • 當已經使用 bash-preexec 協助程式時，Shell 整合應該可以更好地運作。

轉譯改進

啟用 GPU 加速後，終端機轉譯進行了多項改進

  • 半圓形 Powerline 符號現在是自訂轉譯的。與先前版本中的箭號符號一樣，這些符號應與相鄰儲存格無縫融合，並延伸到儲存格的高度，即使使用行高也是如此。

    Semi-circle Powerline symbols now render without needing to configure a font

  • 圓角方塊繪圖字元 (╭、╮、╰、╯) 現在使用更平滑的曲線。

    These round corner symbols now render as perfect 1/4 circles

  • 改進了背景色彩變更時字形的剪輯，這在 npm 輸出警告時很常見。

    Wide characters like W would sometimes escape the background of a cell. For example, when the background of the text was yellow, the W in "WARN" could show unexpected yellow pixels in the top left. The After image shows that it is now fixed

  • 與上述剪輯問題類似，當某些字形中的反鋸齒與其他字元重疊並降低視覺效果時，會出現問題。使用如上所示的背景範例最容易說明此問題。Work 的 k 中的像素也可能逸出另一個方向的儲存格界限。此像素將不再出現在字形中，因為它因與背景幾乎相同的色彩而被移除。

    A pixel in could overlap with the cell to the right, in this case that pixel may not be rendered at all if the difference in color and the background is small

原始檔控制

動作按鈕改進

我們根據使用者意見反應繼續潤飾原始檔控制動作按鈕

  • 只有在高度確定本機分支領先或落後遠端追蹤分支時，才會顯示 [同步變更] 動作按鈕。
  • 只有在考量智慧型認可設定時，才會根據已變更資源的清單啟用 [認可] 動作按鈕
    • git.enableSmartCommit
    • git.suggestSmartCommit
    • git.smartCommitChanges
  • [認可] 動作按鈕圖示會根據分支保護設定更新
    • git.branchProtection
    • git.branchProtectionPrompt

改進的 rebase 衝突解決

在此里程碑中，我們解決了在解決合併衝突時 rebase 流程中的一些較小問題。在解決所有合併衝突後，使用者現在應該能夠使用原始檔控制檢視中的 [認可] 按鈕繼續 rebase 作業。

認可輸入欄位拼字檢查

在此里程碑中，我們確認所有必要的擴充功能 API 均可用於支援認可輸入欄位中的拼字檢查。我們聯絡了兩個熱門拼字檢查擴充功能的作者，並提交了提取要求，說明如何更新其擴充功能以提供認可描述文字的拼字檢查。

偵錯

JavaScript 偵錯

當您建立啟動組態以偵錯 JavaScript/TypeScript 程式時，您可以設定 "console": "integratedTerminal" 以在終端機中執行該程式 (而不是直接產生處理序)。幾個月前，我們注意到 launch.json 組態中的 "args" 部分針對 Shell 逸出，但並非完全逸出。這表示嘗試將引數傳遞至您的程式可能會意外觸發 Shell 中的特殊行為。我們清理了此問題，然後意識到設定包含對 Shell 具有特殊意義的字元的引數是一件有用的事情，而且有些使用者依賴此行為。

我們討論了正確的修正方式，並決定此行為應為選擇加入，並且需要變更 偵錯配接器協定 (DAP)。我們對 DAP 進行了 此變更，在 VS Code 和 js-debug 中實作了它，其他偵錯配接器應該很快就會跟進。

以下說明如何在節點啟動組態中使用新行為

{
    "type": "node",
    "console": "integratedTerminal",
    ...

    // If you pass args as a single string, the characters will not be escaped for the terminal,
    // so the command in backticks will be evaluated, and output will be redirected to "outfile".
    // The user is responsible for knowing the type of shell that this will be run in,
    // and doing any escaping necessary.
    "args": "`echo hello` > outfile",

    // If you pass args as an array, the characters will be escaped for the terminal,
    // so that the program receives them verbatim.
    "args": ["`echo hello` > outfile"]
}

偵錯工作階段的選取器

偵錯時，您現在可以在命令面板中執行 [偵錯：選取偵錯工作階段]。這會顯示一個選取器，其中包含您的作用中偵錯工作階段，您可以使用它來搜尋和篩選您的個別偵錯工作階段。每個選取器項目的描述都會顯示產生它的工作階段 (如果適用)。

在選取器中選取項目將會將偵錯工作階段焦點放在 [呼叫堆疊] 檢視中。偵錯動作 (例如，[暫停]、[逐步執行]、[重新啟動]、[停止]) 將會在焦點偵錯工作階段上執行。選取工作階段也會顯示工作階段的 [偵錯主控台]。

工作

執行工作命令的篩選器支援

[工作：執行工作] (workbench.action.tasks.runTask) 動作支援依工作名稱和類型篩選，以提供更簡潔且可設定的方式來選取和執行工作。

例如

{
  "key": "ctrl+h",
  "command": "workbench.action.tasks.runTask",
  "args": {
    "task": "VS Code - Build",
    "type": "npm"
  }
}

改進的自動工作流程

受信任的工作區功能可讓 VS Code 簡化執行自動工作的流程。根據預設，如果資料夾受信任，則會執行自動工作，否則每個資料夾會提示一次。可以使用 task.allowAutomaticTasks 設定 (預設為 auto) 將此行為設定為永遠 (on) 或永不 (off) 在執行自動工作之前提示。

語言

格式化 JSON 時保留換行符號

您現在可以在格式化 JSON 文件中的行時保留初始行位置。例如，包含單行值的陣列在格式化後仍會將這些值保留在同一行上。JSON 檔案中的額外換行符號 (換行) 也會保留。若要啟用此功能，請在 [設定編輯器] 中設定選項 [JSON > 格式：保留行]。

筆記本

前往最近失敗的儲存格

如果您最近執行的儲存格失敗，現在有一個按鈕可以跳到該儲存格。您也可以執行 [筆記本：前往最近失敗的儲存格] 來執行相同的動作。

當您執行一組儲存格並想要知道哪個儲存格失敗並停止群組執行時，這非常有用。

筆記本 Markdown 預覽附件轉譯

現在可以在 Jupyter 筆記本中轉譯內嵌的 base64 影像。

貼到 Jupyter 筆記本中並透過 ![image alt-text](attachment:image.png) 參考的影像現在將在 VS Code 筆記本中如預期般轉譯。

下列 Markdown 原始碼

Notebook Markdown cell source code with image link

將轉譯為

Notebool Markdown cell preview with attachment rendered

共用筆記本連結

[共用] 子功能表中的 [複製 vscode.dev 連結] 命令現在支援筆記本連結。

適用於 Web 的 VS Code

設定顯示語言

您現在可以使用 [擴充功能] 檢視中語言套件擴充功能上的 [設定顯示語言] 按鈕來設定瀏覽器的顯示語言。

Set Display Language button on a language pack in the Extensions view

設定完成後，您可以使用目前設定的語言套件擴充功能上的 [清除顯示語言] 按鈕來清除顯示語言。

Clear Display Language button on the current language pack in the Extensions view

擴充功能的貢獻

Python

入門體驗

Python 擴充功能逐步解說現在順利地將使用者轉換為安裝 Python (如果他們需要安裝) 和選取 Python。當未安裝 Python 時，會開啟 Microsoft Store 或適當的逐步解說磚，而且使用者可以自動執行顯示的指示。只有在使用者動作需要直譯器時，才會顯示與直譯器相關的任何提示，而不會在啟動時顯示。此外，UI 提示已改進，以更精確地說明錯誤和建議的變更。

Python in-product Get started walkthrough

狀態列中的直譯器資訊

新增了新的設定 python.interpreter.infoVisibility，可控制何時在狀態列中顯示有關選取直譯器的資訊。根據預設，直譯器資訊只會在開啟與 Python 相關的檔案時顯示 (onPythonRelated)。可以將其設定為 always 以還原為舊行為，無論開啟什麼檔案，都會顯示選取的直譯器。新增了警告狀態，以指示選取的直譯器無效的情況

Interpreter information in the Status bar

自動偵錯組態

Python 擴充功能現在支援自動偵錯組態，可分析目前的專案，並為您提供不需要額外修改的偵錯組態。

擴充功能可辨識 Django、Flask 和 FastApi 專案，以及簡單的 Python 檔案。

您可以深入了解自動偵錯組態和最近的一些改進。

實驗性擴充功能：WWBD

有一個新的實驗性 Python 擴充功能，名為 WWBD，可作為 Python 環境工作流程構想的沙箱。到目前為止，有一個用於虛擬環境的 [建立環境] 命令，以查看單一命令是否可以協助使用者設定新的虛擬環境 (請參閱 WWBD 擴充功能頁面以取得完整詳細資料和其他擴充功能)。您可以在專案存放庫中的構想類別中閱讀正在考慮的其他構想，包括 conda 支援。

Jupyter

將繪圖影像複製到剪貼簿

現在可以在 Jupyter 擴充功能中將儲存格輸出中的繪圖複製到剪貼簿。請確定您已選取正確的簡報，因為目前僅支援 PNG 輸出

Select image/png when copying plot to the clipboard

設定正確的簡報類型後，選取右上角的複製到剪貼簿按鈕

Copy plot button

Web 擴充功能

下列功能已移植到 Jupyter 擴充功能的 Web 版本

  • 繪圖檢視器
  • 資料框架檢視器

如果您想試用此功能，請從本機電腦啟動 Jupyter，並使用

jupyter notebook --no-browser --NotebookApp.allow_origin_pat=https://.*\.vscode-cdn\.net

然後使用 vscode.dev 中的 [Jupyter：指定連線的 Jupyter 伺服器] 命令連線到它。

如需詳細資訊 (和評論)，請參閱此討論項目。

互動式視窗還原

現在可以透過開啟設定 interactiveWindow.restore，跨 VS Code 視窗重新載入還原互動式視窗工作階段。

限制：原始核心狀態不會跨視窗重新載入持續存在 (如需詳細資訊，請參閱此討論項目)。如果您使用遠端 Jupyter 伺服器，互動式視窗將在重新載入時連線到先前的核心工作階段。

從 .env 檔案載入環境變數

已對從 .env 檔案載入環境變數進行多項修正，包括偵測 .env 檔案的變更。Python 核心現在將從設定 python.envFile 中定義的檔案載入環境變數。

GitHub 提取要求和問題

在 GitHub 提取要求和問題擴充功能上取得了更多進展，可讓您處理、建立和管理提取要求和問題。此版本的重點包括

  • 有一個新按鈕可以僅顯示自檢視器上次檢閱以來對提取要求的變更。
  • 原始檔控制檢視中的新 [認可並建立提取要求] 動作可讓您執行 Git 認可並移至 [建立 PR] 檢視，一步到位。
  • githubPullRequests.pullRequestDescription 設定可用於設定 PR 描述的來源文字。

查看擴充功能 0.48.0 版本的變更記錄，以查看其他重點。

遠端開發

持續致力於 遠端開發擴充功能，可讓您使用容器、遠端機器或 Windows Subsystem for Linux (WSL) 作為全功能開發環境。

您可以在遠端開發版本資訊中了解新的擴充功能功能和錯誤修正。

預覽功能

編輯器黏性捲動

現在可以顯示 UI，以顯示使用者在捲動期間所在的範圍。「黏性捲動」UI 將顯示編輯器頂端所在的類別/介面/命名空間/函式/方法/建構函式，協助您了解文件中的位置。使用 editor.experimental.stickyScroll.enabled 設定啟用黏性捲動。

<video src="/assets/updates/1_70/sticky-scroll.mp4" autoplay loop controls muted title=""Sticky scroll" showing the source code scope for a TypeScript file">

TypeScript 4.8 支援

此更新包含對即將推出的 TypeScript 4.8 版本的支援。請參閱 TypeScript 4.8 迭代計畫，以取得有關 TypeScript 團隊目前正在處理之工作的詳細資訊。

若要開始使用 TypeScript 4.8 每晚組建，請安裝 TypeScript Nightly 擴充功能。

設定設定檔

我們在過去幾個月中一直致力於在 VS Code 中支援設定設定檔，這是社群中最受歡迎的要求之一。此功能在 Insiders 版本中透過 workbench.experimental.settingsProfiles.enabled 設定提供預覽。試用看看，並透過在 VS Code 存放庫中建立問題或在 問題 #116740 中評論，讓我們知道您的意見反應。

在此里程碑中，我們也在適用於 Web 的 VS Code 中新增了對設定設定檔的支援。您可以使用 insiders.vscode.dev 和相同的 workbench.experimental.settingsProfiles.enabled 設定來試用。

佈景主題：Light Pink

工作重新連線

在視窗重新載入時，可以透過啟用 task.experimental.reconnection 重新連線監看工作，這會在擴充功能變更或 VS Code 版本更新後更快地返回工作。

程式碼動作

我們一直致力於在 VS Code 中提供更好的 程式碼動作體驗。程式碼動作包括重構、來源動作和快速修正。

可以從 內容功能表中選取 [重構] 或 [來源動作]、從燈泡或透過快速修正開啟新的實驗性程式碼動作控制項。透過 editor.experimental.useCustomCodeActionMenu 設定試用看看。透過在 VS Code 存放庫中建立問題或在 問題 #152913 中評論，讓我們知道任何意見反應。

程式碼動作的重構預覽也可以從新的程式碼動作控制項存取。將滑鼠指標停留在已啟用的項目上，以檢視如何預覽。自訂鍵盤繫結支援選取程式碼動作，以及預覽選取範圍。

在此里程碑中，我們也新增了對程式碼動作的自訂鍵盤繫結支援，其中包括快速修正 (⌘. (Windows、Linux Ctrl+.))。您可以嘗試將下列程式碼片段與您想要的鍵盤快速鍵新增至 keybindings.json。

[
  {
    "key": "ctrl+k",
    "when": "codeActionMenuVisible",
    "command": "focusPreviousCodeAction"
  },
  {
    "key": "ctrl+j",
    "when": "codeActionMenuVisible",
    "command": "focusNextCodeAction"
  }
]

跨 VS Code 網頁版和桌面版的編輯工作階段

持續開發編輯工作階段功能，讓您在跨 VS Code 網頁版或桌面版繼續處理儲存庫時，可以帶著您未提交的變更。重點功能包括

  • 現在關閉編輯工作階段功能時，您可以從雲端刪除所有已儲存的編輯工作階段。
  • 現在支援使用 Microsoft 驗證登入。
  • 如果您在尋找編輯工作階段時遇到問題，可以使用 編輯工作階段：顯示編輯工作階段 命令來檢視所有編輯工作階段。

若要試用編輯工作階段，請在設定中設定 workbench.experimental.editSessions.enabled，並使用 編輯工作階段：儲存目前編輯工作階段 命令，並在提示時使用 GitHub 或 Microsoft 驗證登入。然後在另一部機器或 VS Code 執行個體的儲存庫中使用 編輯工作階段：恢復最新的編輯工作階段 命令，將所有已修改檔案的工作內容還原到您的工作區。您可以隨時使用 編輯工作階段：登出 命令登出編輯工作階段。

隨著我們不斷改進編輯工作階段的體驗，請試用此功能，並透過在 issue #141293 中留言，與我們分享您的意見回饋。

擴充功能撰寫

'when' 子句的 'not in' 運算子

在 when 子句中已經有一個運算子 in，它允許在另一個具有陣列或物件類型值的內容金鑰中動態查詢內容金鑰的值。我們新增了一個新的運算子 not in，它會否定此運算。請參閱 when 子句內容 文件以了解詳細資訊。

htmlLanguageParticipants 貢獻點

新的貢獻點 htmlLanguageParticipants 允許類似 HTML 的語言宣告它們想要繼承所有 HTML 語言伺服器功能，例如程式碼完成、hover 和大綱。這對於不想實作完整語言伺服器的程式語言擴充功能很有用。

內建的 handlebars 擴充功能就是一個範例，它現在將自己新增到其 package.json 中的 htmlLanguageParticipants

"contributes": {
  "htmlLanguageParticipants": [
     {
       "languageId": "handlebars"
      }
    ]
}

Quarkus 擴充功能已經採用了此貢獻點。它使用嵌入式 Qute HTML 範本語言的其他建議來豐富 HTML 功能

拖曳到編輯器 API

文字編輯器拖曳 API 讓擴充功能可以處理將檔案或其他內容拖曳到文字編輯器中。這些拖曳事件可能來自 VS Code 內部，例如從 VS Code 的 Explorer 將檔案拖曳到文字編輯器中，或者可能是從作業系統將檔案拖曳到 VS Code 中所產生。

若要將檔案拖曳到編輯器中，使用者可以在拖曳時按住 kbsytyle(Shift)，然後將檔案拖曳到檔案中的特定位置。此時，您的擴充功能可以選擇如何處理拖曳的資料。

請查看 拖曳到編輯器擴充功能範例，以取得此 API 在運作中的簡單範例。

建議的 API

每個里程碑都會推出新的建議 API，擴充功能作者可以試用它們。與往常一樣，我們需要您的意見回饋。以下是試用建議 API 的步驟

  1. 找到您想要試用的提案，並將其名稱新增到 package.json#enabledApiProposals。
  2. 使用最新的 vscode-dts 並執行 vscode-dts dev。它會將對應的 d.ts 檔案下載到您的工作區。
  3. 現在您可以針對該提案進行程式設計。

您不能發佈使用建議 API 的擴充功能。下一個版本中可能會出現重大變更，而我們絕不希望破壞現有的擴充功能。

Webview 內容選單

新的 webview 內容選單提案讓進階 webview 可以輕鬆自訂當使用者在 webview 內按一下滑鼠右鍵時顯示的內容選單。這個新的貢獻點使用 VS Code 的一般內容選單，因此自訂選單可以完美地融入編輯器的其餘部分。Webview 也可以針對 webview 的不同區段顯示自訂內容選單。

若要試用這個新的 API，您需要啟用 contribWebviewContext 提案。

"enabledApiProposals": [
  "contribWebviewContext"
]

若要將新的內容選單項目新增到您的 webview，請在新的 webview/context 區段下的 menus 中新增一個項目。每個貢獻都採用一個 command（這也是標題的來源）和一個 when 子句。when 子句 應包含 webview == 'YOUR_WEBVIEW_VIEW_TYPE'，以確保內容選單僅適用於您擴充功能的 webview

"contributes": {
  "menus": {
    "webview/context": [
      {
        "command": "catCoding.yarn",
        "when": "webview == 'catCoding'"
      },
      {
        "command": "catCoding.insertLion",
        "when": "webview == 'catCoding' && webviewSection == 'editor'"
      }
    ]
  },
  "commands": [
    {
      "command": "catCoding.yarn",
      "title": "Yarn 🧶",
      "category": "Cat Coding"
    },
    {
      "command": "catCoding.insertLion",
      "title": "Insert 🦁",
      "category": "Cat Coding"
    },
    ...
  ]
}

在 webview 內部，您也可以使用 data-vscode-context 資料屬性（或在 JavaScript 中使用 dataset.vscodeContext）來設定 HTML 特定區域的內容。data-vscode-context 值是一個 JSON 物件，指定當使用者在元素上按一下滑鼠右鍵時要設定的內容。最終內容由從文件根目錄到按一下的元素的路徑決定。

以這個 HTML 為例

<div class="main" data-vscode-context='{"webviewSection": "main", "mouseCount": 4}'>
  <h1>Cat Coding</h1>

  <textarea data-vscode-context='{"webviewSection": "editor", "preventDefaultContextMenuItems": true}'></textarea>
</div>

如果使用者在 textarea 上按一下滑鼠右鍵，將會設定以下內容

  • webviewSection == 'editor' — 這會覆寫父元素中的 webviewSection。
  • mouseCount == 4 — 這繼承自父元素。
  • preventDefaultContextMenuItems == true — 這是一個特殊內容，會隱藏 VS Code 通常新增到 webview 內容選單的複製和貼上項目。

如果使用者在 <textarea> 內按一下滑鼠右鍵，他們將會看到

Custom context menus showing in a webview

檢視大小

檢視大小提案讓擴充功能可以為它們貢獻的檢視提供權重

"contributes": {
    "views": {
        "github-pull-request": [
            {
                "id": "github:createPullRequest",
                "type": "webview",
                "name": "Create Pull Request",
                "size": 2
            },
            {
                "id": "github:compareChanges",
                "name": "Compare Changes",
                "size": 1
            }
        ]
    }
}

大小的工作方式與 CSS 屬性 flex-grow 類似。在上面的範例中，"size": 2 的檢視大小將是 "size": 1 的檢視大小的兩倍。只有當檢視容器是由相同的擴充功能貢獻時，才會尊重 size 屬性。

可擴充的 HTML Notebook 轉譯器

我們內建的 Notebook 轉譯器 現在公開了一個實驗性 API，讓擴充功能可以自訂 HTML 內容的轉譯。此 API 目前公開單一 hook，postRender，它會在 HTML 內容的初始轉譯之後調用。

若要試用這個實驗性 API，您的擴充功能 需要擴充 vscode.builtin-renderer API。

"contributes": {
  "notebookRenderer": [
    {
      "id": "vscode-samples.my-custom-html-extension",
      "displayName": "My custom html renderer extension",
      "entrypoint": {
        "extends": "vscode.builtin-renderer",
        "path": "./out/main.js"
      }
    }
  ]
}

然後您的轉譯器可以在 vscode-builtin-renderer 上註冊轉譯 hook

import type { RendererContext } from 'vscode-notebook-renderer';

export async function activate(ctx: RendererContext<void>) {
  const htmlRenderer = await ctx.getRenderer('vscode.builtin-renderer');
  if (!htmlRenderer) {
      throw new Error(`Could not load 'vscode.builtin-renderer'`);
  }

  htmlRenderer.experimental_registerHtmlRenderingHook({
    // Invoked after the HTML content for `outputItem` has been rendered to `element`
    postRender(outputItem: OutputItem, element: HTMLElement): HTMLElement | undefined {
      // You can either modify `element` or return a replacement element
    }
  });
}

測試這個新的 API，並告訴我們您的想法！

偵錯配接器協定

RunInTerminalRequest 的 argsCanBeInterpretedByShell

RunInTerminalRequest 支援一個新的屬性 argsCanBeInterpretedByShell，它會告知用戶端命令 args 中的特殊 shell 字元是否應保持不逸出。這是為了讓使用者能夠編寫將在終端機中啟動的啟動設定，並包含應由 shell 解譯的字元。

工程

Electron 沙箱支援進度

在這個里程碑中，我們在預設啟用 Electron 的 沙箱 方面取得了重大進展。我們計劃在 8 月為 Insiders 啟用沙箱，並最終使其成為 Stable VS Code 中的預設設定。

對於好奇的使用者，在設定中設定 "window.experimental.useSandbox": true 將啟用沙箱模式。希望您不會注意到任何變化，但如果您發現問題，請回報給我們。

Markdown 語言伺服器

在這個迭代中，我們將 VS Code 大部分用於撰寫 Markdown 的工具提取到一個 程式庫 和 語言伺服器 中。這包括我們用於路徑完成、文件大綱和診斷的工具。

VS Code 內建的 Markdown 擴充功能已經切換到使用這個新的語言伺服器，雖然希望您不會注意到行為上的任何差異。這種切換應該有助於提高效能，因為它將 Markdown 工具移至其自己的處理程序。移至語言伺服器也有助於我們改善實驗性 Markdown 連結診斷的效能。

我們希望其他工具和編輯器也能夠從這些新的套件中受益，甚至可以回饋它們。我們可以一起為所有人建立更好的 Markdown 工具！如果您有興趣，請查看相關專案

Debian 套件相依性

Debian 套件相依性現在由腳本產生，而不是硬式編碼。這解決了 早在 2016 年就提出的問題，其中遺失的相依性會導致程式在某些機器上執行時當機。

文件和擴充功能

開發容器 CLI

開發容器命令列介面 (CLI) 主題已針對 CLI 的 最新版本 進行更新。開發容器 CLI 可讓您建置和執行開發容器，並且是 開發容器規格 的開放原始碼參考實作

Banner from the Development Containers Specification website

Azure Developer CLI (azd)

Azure Developer CLI 及其互補的 VS Code 擴充功能 現在已公開預覽。Azure Developer CLI (azd) 透過提供開發人員友善的命令，將您從本機開發環境移至 Azure 的時間縮短，這些命令對應到您工作流程中的關鍵階段：程式碼、建置、部署、監視、重複。

Azure Developer CLI extension

Azure Developer CLI 使用 可擴充的範本，其中包含讓應用程式在 Azure 中啟動並執行所需的一切。這些範本包含最佳實務、應用程式程式碼和可重複使用的基礎架構即程式碼資產。更重要的是，它們涵蓋了遠遠超出「Hello World!」的端對端案例。

使用 Azure Developer CLI，您可以初始化、佈建和部署應用程式，或者更好的是，使用 'azd up' 一步到位！如需支援的 azd 命令清單，請參閱 Developer CLI 參考。

感謝您

最後但絕非最不重要的是，衷心感謝 VS Code 的貢獻者。

Issue 追蹤

對我們的 issue 追蹤的貢獻

Pull requests

對 vscode 的貢獻

對 vscode-generator-code 的貢獻

對 vscode-js-debug 的貢獻

對 vscode-json-languageservice 的貢獻

對 monaco-editor 的貢獻