使用策略集中管理 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 步：配置策略值

根据您的要求编辑策略值

字符串策略 - 接受文本值或 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>

布尔策略 - 接受 true/false 值的策略

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

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

移除不需要的策略 - 删除您不想强制执行的任何策略的键和值

<!-- 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 变体），然后选择 显示包内容 (Show Package Contents)。
3. 导航到 Contents/Resources/app/policies。
4. 找到示例 .mobileconfig 文件（例如 vscode-sample.mobileconfig）。

第 2 步：配置策略值

1. 将示例 .mobileconfig 文件复制到工作目录（例如桌面或文档文件夹）。

2. 在文本编辑器（例如 TextEdit、VS Code 或任何 XML 编辑器）中打开复制的文件。

3. 根据您的要求编辑策略值

   字符串策略 - 接受文本值或 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 的窗口日志中检查错误（按 ⇧⌘P（Windows、Linux 为 Ctrl+Shift+P），然后输入 Show Window Log）。

   布尔策略 - 接受 true/false 值的策略

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

   移除不需要的策略 - 删除您不想强制执行的任何策略的键和值

   <!-- 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. 根据您的要求编辑策略值

   字符串策略 - 接受文本值或 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 的窗口日志中检查错误（按 ⇧⌘P（Windows、Linux 为 Ctrl+Shift+P），然后输入 Show Window Log）。

   布尔策略 - 接受 true/false 值的策略

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

   移除不需要的策略 - 删除您不想强制执行的任何策略的键和值

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

有关每个策略接受的值和行为的详细信息，请参阅 策略参考。

第 3 步：部署策略

现在，您可以使用 MDM 解决方案将配置好的策略大规模部署到组织内的所有相关设备。在大规模部署之前，您可以在本地机器上手动测试这些策略。

验证策略实施情况

将企业策略部署到设备后，您可以使用 Developer: Policy Diagnostics 命令确认 VS Code 是否正在读取并执行它们。该命令会打开一个包含设备当前策略状态报告的新的未命名 Markdown 文档。它在 Windows、macOS 和 Linux 上的工作方式相同。

报告包含以下部分：

• 系统信息：VS Code 产品名称、版本和提交记录，有助于将报告与特定构建版本进行匹配。
• 帐户信息：已登录的默认帐户详情，包括帐户提供程序返回的原始帐户级策略数据。
• 帐户策略网关：控制 AI 功能的 已批准 GitHub 组织网关 的状态。可能的状态包括 inactive（未激活）、satisfied（满足）和 restricted（受限）。当状态为 restricted 时，报告还会列出原因，例如 noAccount、wrongProvider、orgNotApproved 或 policyNotResolved。
• 受策略控制的设置：列出每个注册设置的策略状态的两个表格
  • 已应用策略：当前被策略覆盖的设置，包括设置键、策略名称、策略来源、默认值、当前值以及策略强制执行的值。
  • 未应用策略：当前未强制执行的注册策略。使用此表可检测部署错误，例如拼写错误的键或未被读取的策略文件。
• 身份验证信息：已注册的身份验证提供程序、会话、帐户以及有权访问每个帐户的扩展程序。

VS Code 企业策略参考

下表列出了 VS Code 中所有可用的企业策略。