使用原則集中管理 VS Code 設定

Visual Studio Code 中的企業原則讓組織能夠為其開發團隊集中管理 VS Code 設定，以確保整個組織內的一致性與相容性。當原則值設定後，該值將會覆寫在任何層級（預設值、使用者與工作區）所設定的 VS Code 設定值。

IT 管理員可以透過不同的裝置管理解決方案，在使用者裝置上部署並強制執行特定的 VS Code 設定。VS Code 支援在 Windows、macOS 和 Linux 上套用原則。

在本文中，您將了解 VS Code 提供哪些企業原則，以及如何在不同的作業系統上進行設定。

Windows 群組原則

VS Code 支援基於 Windows 登錄檔的群組原則。

這些描述檔可以使用行動裝置管理 (MDM) 解決方案進行部署，或手動安裝在個別裝置上。

步驟 1：取得範例 ADMX 與 ADML 檔案

從 VS Code 1.69 版本開始，每個發行版本都會附帶一個 policies 目錄，其中包含定義可用原則的 ADMX 範本檔案。

您可以從現有的安裝目錄取得 ADMX 和 ADML 檔案，或是下載並解壓縮 VS Code zip 封存檔。請遵循下列步驟來取得這些檔案：

1. 下載適合您 VS Code 版本的 VS Code zip 封存檔。
2. 將 zip 檔案解壓縮至暫存位置。
3. 導覽至解壓縮檔案中的 policies 資料夾。此資料夾包含 ADMX 範本檔案（例如 vscode.admx）以及一個包含不同語言 ADML 檔案的 locales 子資料夾。

步驟 2：設定原則值

根據您的需求編輯原則值

字串原則 (String policies) - 接受文字值或 JSON 字串的原則

<!-- Example: Allow extensions from specific publishers -->
<key>AllowedExtensions</key>
<string>{"microsoft": true, "github": true}</string>

<!-- Example: Set update mode to a specific value -->
<key>UpdateMode</key>
<string>start</string>

布林原則 (Boolean policies) - 接受 true/false 值的原則

<!-- Example: Enable user feedback -->
<key>EnableFeedback</key>
<true/>

<!-- Example: Disable telemetry -->
<key>EnableTelemetry</key>
<false/>

移除不需要的原則 - 刪除您不想強制執行之任何原則的機碼 (key) 與值 (value)

<!-- To not enforce an update mode policy, remove these lines: -->
<key>UpdateMode</key>
<string>start</string>

請參閱下方的原則參考，以了解每項原則的接受值與行為詳情。

步驟 3：部署原則

現在，您可以使用裝置管理解決方案，將設定好的原則大規模部署到組織內所有相關的裝置。在進行大規模部署之前，您可以先使用「本機群組原則編輯器」在 Windows 本機機器上測試原則。

macOS 設定描述檔

設定描述檔用於管理 macOS 裝置上的設定。描述檔是一個包含對應至可用原則之鍵值對的 XML 檔案 (.mobileconfig)。

這些描述檔可以使用行動裝置管理 (MDM) 解決方案進行部署，或手動安裝在個別裝置上。

步驟 1：取得範例設定描述檔

從 VS Code 1.99 版本開始，每個發行版本都會附帶一個範例 .mobileconfig 檔案。請遵循下列步驟，在已安裝 VS Code 的 macOS 裝置上找到該範例檔案：

1. 開啟「Finder」並導覽至 /Applications。
2. 對 Visual Studio Code.app（或您的 VS Code 變體）按右鍵，並選取 顯示套件內容。
3. 導覽至 Contents/Resources/app/policies。
4. 找到範例 .mobileconfig 檔案（例如 vscode-sample.mobileconfig）。

步驟 2：設定原則值

1. 將範例 .mobileconfig 檔案複製到工作位置（例如您的「桌面」或「文件」資料夾）。

2. 使用文字編輯器（例如 TextEdit、VS Code 或任何 XML 編輯器）開啟該複製的檔案。

3. 根據您的需求編輯原則值

   字串原則 (String policies) - 接受文字值或 JSON 字串的原則

   <!-- Example: Allow extensions from specific publishers -->
   <key>AllowedExtensions</key>
   <string>{"microsoft": true, "github": true}</string>
   
   <!-- Example: Set update mode to a specific value -->
   <key>UpdateMode</key>
   <string>start</string>
   

   重要

   如果原則值中出現語法錯誤，該設定將不會被套用。您可以在 VS Code 中檢查視窗記錄 (Window log) 以查看錯誤（按下 ⇧⌘P (Windows, Linux Ctrl+Shift+P) 並輸入 Show Window Log）。

   布林原則 (Boolean policies) - 接受 true/false 值的原則

   <!-- Example: Enable user feedback -->
   <key>EnableFeedback</key>
   <true/>
   
   <!-- Example: Disable telemetry -->
   <key>EnableTelemetry</key>
   <false/>
   

   移除不需要的原則 - 刪除您不想強制執行之任何原則的機碼 (key) 與值 (value)

   <!-- To not enforce an update mode policy, remove these lines: -->
   <key>UpdateMode</key>
   <string>start</string>
   

請參閱原則參考以了解每項原則的接受值與行為詳情。

步驟 3：部署原則

現在，您可以使用 MDM 解決方案將設定好的原則大規模部署到組織內所有相關的裝置。在進行大規模部署之前，您可以先在機器上手動測試這些原則。

Linux JSON 原則

從 VS Code 1.106 版本開始，您可以透過將 JSON 原則檔案放置於 /etc/vscode/policy.json，在 Linux 裝置上設定 VS Code 設定原則。此方法使用簡單的 JSON 格式來定義原則值。

這些描述檔可以使用行動裝置管理 (MDM) 解決方案進行部署，或手動安裝在個別裝置上。

步驟 1：取得範例原則檔案

從 VS Code 1.106 版本開始，每個發行版本都會附帶一個範例 .policy.json 檔案。您可以從現有的安裝目錄取得，或是下載並解壓縮 VS Code 封存檔。該檔案位於 resources/app/policies 目錄中。

步驟 2：設定原則值

1. 將範例 policy.json 檔案複製到工作位置

   sudo cp /usr/share/code/resources/app/policies/policy.json /tmp/policy.json
   

2. 使用您偏好的文字編輯器編輯該檔案

   sudo nano /tmp/policy.json
   # or
   sudo vim /tmp/policy.json
   # or
   code /tmp/policy.json
   

3. 根據您的需求編輯原則值

   字串原則 (String policies) - 接受文字值或 JSON 字串的原則

   <!-- Example: Allow extensions from specific publishers -->
   <key>AllowedExtensions</key>
   <string>{"microsoft": true, "github": true}</string>
   
   <!-- Example: Set update mode to a specific value -->
   <key>UpdateMode</key>
   <string>start</string>
   

   重要

   如果原則值中出現語法錯誤，該設定將不會被套用。您可以在 VS Code 中檢查視窗記錄 (Window log) 以查看錯誤（按下 ⇧⌘P (Windows, Linux Ctrl+Shift+P) 並輸入 Show Window Log）。

   布林原則 (Boolean policies) - 接受 true/false 值的原則

   <!-- Example: Enable user feedback -->
   <key>EnableFeedback</key>
   <true/>
   
   <!-- Example: Disable telemetry -->
   <key>EnableTelemetry</key>
   <false/>
   

   移除不需要的原則 - 刪除您不想強制執行之任何原則的機碼 (key) 與值 (value)

   <!-- To not enforce an update mode policy, remove these lines: -->
   <key>UpdateMode</key>
   <string>start</string>
   

請參閱原則參考以了解每項原則的接受值與行為詳情。

步驟 3：部署原則

現在，您可以使用 MDM 解決方案將設定好的原則大規模部署到組織內所有相關的裝置。在進行大規模部署之前，您可以先在機器上手動測試這些原則。

VS Code 企業原則參考

下表列出了所有在 VS Code 中可用的企業原則。