用户和工作区设置

您可以通过 Visual Studio Code 的各种设置，根据自己的喜好对其进行配置。几乎 VS Code 编辑器、用户界面和功能行为的每个部分都有您可以修改的选项。

VS Code 为设置提供了不同的作用域

• 用户设置 - 全局应用于您打开的任何 VS Code 实例的设置。
• 工作区设置 - 存储在您的工作区内且仅在工作区打开时应用的设置。

VS Code 将设置值存储在设置 JSON 文件中。您可以通过编辑设置 JSON 文件或使用设置编辑器来更改设置值，设置编辑器提供了一个图形界面来管理设置。

用户设置

用户设置是您用于自定义 VS Code 的个人设置。这些设置全局应用于您打开的任何 VS Code 实例。例如，如果您在用户设置中将编辑器字体大小设置为 14，则计算机上所有 VS Code 实例中的字体大小都将为 14。

您可以通过以下几种方式访问您的用户设置

• 在命令面板中选择首选项: 打开用户设置命令 (⇧⌘P (Windows、Linux Ctrl+Shift+P))
• 在设置编辑器中选择用户选项卡 (⌘, (Windows、Linux Ctrl+,))
• 在命令面板中选择首选项: 打开用户设置 (JSON) 命令 (⇧⌘P (Windows、Linux Ctrl+Shift+P))

工作区设置

工作区设置特定于项目，并覆盖用户设置。如果您有想要应用于特定项目的特定设置，则可以使用工作区设置。例如，对于后端服务器项目，您可能希望设置 files.exclude 设置以从文件资源管理器中排除 node_modules 文件夹。

VS Code 将工作区设置存储在项目根目录的 .vscode 文件夹中。这使得在版本控制（例如，Git）项目中与其他人共享设置变得容易。

您可以通过以下几种方式访问工作区设置

• 在命令面板中选择首选项: 打开工作区设置命令 (⇧⌘P (Windows、Linux Ctrl+Shift+P))
• 在设置编辑器中选择工作区选项卡 (⌘, (Windows、Linux Ctrl+,))
• 在命令面板中选择首选项: 打开工作区设置 (JSON) 命令 (⇧⌘P (Windows、Linux Ctrl+Shift+P))

并非所有用户设置都可用作工作区设置。例如，与更新和安全相关的应用程序范围设置不能被工作区设置覆盖。

设置编辑器

设置编辑器提供了一个图形界面来管理用户和工作区设置。要打开设置编辑器，请导航到文件 > 首选项 > 设置。或者，从命令面板 (⇧⌘P (Windows、Linux Ctrl+Shift+P)) 中使用首选项: 打开设置或使用键盘快捷键 (⌘, (Windows、Linux Ctrl+,)) 打开设置编辑器。

当您打开设置编辑器时，您可以搜索和发现您正在查找的设置。当您使用搜索栏进行搜索时，设置编辑器会过滤设置，仅显示与您的条件匹配的设置。这使得查找设置变得快速而简单。

VS Code 会在您更改设置时直接应用更改。您可以通过设置左侧的彩色条来识别您修改的设置，这类似于编辑器中修改的行。

在下面的示例中，侧边栏位置和文件图标主题已更改。

设置旁边的齿轮图标 (⇧F9 (Windows、Linux Shift+F9)) 打开一个上下文菜单，其中包含将设置重置为其默认值、复制设置 ID、复制 JSON 名称-值对或复制设置 URL 的选项。

设置组

设置以组的形式表示，以便您可以快速导航到相关设置。顶部有一个常用组，其中显示了流行的自定义设置。

在以下示例中，通过在树视图中选择源代码管理来聚焦源代码管理设置。

设置编辑器过滤器

设置编辑器搜索栏有多个过滤器，使您可以更轻松地管理您的设置。搜索栏的右侧是一个带有漏斗图标的过滤器按钮，它提供了轻松地向搜索栏添加过滤器的选项。

已修改的设置

要检查您已配置的设置，搜索栏中有一个 @modified 过滤器。如果设置的值与默认值不同，或者如果设置的值在各自的设置 JSON 文件中显式设置，则该设置将在此过滤器下显示。

如果您忘记了是否配置了某个设置，或者如果编辑器的行为与您的预期不符，因为您意外配置了某个设置，则此过滤器可能很有用。

其他过滤器

还有其他几个方便的过滤器可以帮助您搜索设置。在搜索栏中键入 @ 符号以发现不同的过滤器。

以下是一些可用的过滤器

• @ext - 特定于扩展的设置。您提供扩展 ID，例如 @ext:ms-python.python。
• @feature - 特定于功能子组的设置。例如，@feature:explorer 显示文件资源管理器的设置。
• @id - 基于设置 ID 查找设置。例如，@id:workbench.activityBar.visible。
• @lang - 基于语言 ID 应用语言过滤器。例如，@lang:typescript。有关更多详细信息，请参阅语言特定的编辑器设置。
• @tag - 特定于 VS Code 系统的设置。例如，@tag:workspaceTrust 用于与工作区信任相关的设置，或 @tag:accessibility 用于与辅助功能相关的设置。

搜索栏会记住您的设置搜索查询，并支持撤消/重做 (⌘Z (Windows、Linux Ctrl+Z)/⇧⌘Z (Windows、Linux Ctrl+Y))。您可以使用搜索栏右侧的清除设置搜索输入按钮快速清除搜索词或过滤器。

扩展设置

已安装的 VS Code 扩展也可以贡献它们自己的设置，您可以在设置编辑器的扩展部分下查看这些设置。

您还可以从扩展视图 (⇧⌘X (Windows、Linux Ctrl+Shift+X)) 中选择扩展并查看 功能贡献 选项卡，从而查看扩展的设置。

扩展作者可以在配置贡献点文档中了解有关添加自定义设置的更多信息。

设置 JSON 文件

VS Code 将设置值存储在 settings.json 文件中。设置编辑器是用户界面，使您可以查看和修改存储在 settings.json 文件中的设置值。

您还可以通过在编辑器中使用命令面板 (⇧⌘P (Windows、Linux Ctrl+Shift+P)) 中的首选项: 打开用户设置 (JSON) 或 首选项: 打开工作区设置 (JSON) 命令打开 settings.json 文件，从而直接查看和编辑该文件。

设置以 JSON 格式编写，方法是指定设置 ID 和值。您可以通过在设置编辑器中选择设置的齿轮图标，然后选择复制设置为 JSON 操作，从而快速复制设置的相应 JSON 名称-值对。

settings.json 文件具有完整的 IntelliSense，其中包含用于设置和值的智能完成以及描述悬停提示。由于不正确的设置名称或 JSON 格式导致的错误也会突出显示。

某些设置只能在 settings.json 中编辑，例如工作台: 颜色自定义，并在设置编辑器中显示在 settings.json 中编辑链接。

设置文件位置

用户 settings.json 位置

根据您的平台，用户设置文件位于此处

• Windows %APPDATA%\Code\User\settings.json
• macOS $HOME/Library/Application\ Support/Code/User/settings.json
• Linux $HOME/.config/Code/User/settings.json

工作区 settings.json 位置

工作区设置文件位于根文件夹下的 .vscode 文件夹中。当您将工作区设置 settings.json 文件添加到您的项目或源代码管理时，项目的设置将由该项目的所有用户共享。

重置设置

您始终可以通过将鼠标悬停在设置上以显示齿轮图标，单击齿轮图标，然后选择重置设置操作，从而将设置重置为默认值。

虽然您可以通过设置编辑器单独重置设置，但您可以通过打开 settings.json 并删除大括号 {} 之间的条目来重置所有更改的设置。请小心，因为无法恢复您之前的设置值。

语言特定的编辑器设置

自定义语言特定设置的一种方法是打开设置编辑器，按下过滤器按钮，然后选择语言选项以添加语言过滤器。或者，可以直接在搜索小部件中键入 @lang:languageId 形式的语言过滤器。显示的设置将可针对该特定语言进行配置，并且如果适用，将显示特定于该语言的设置值。

当您在语言过滤器生效时修改设置时，该设置将在给定作用域中针对该语言进行配置。例如，当修改用户作用域 diffEditor.codeLens 设置时，如果搜索小部件中存在 @lang:css 过滤器，则设置编辑器会将新值保存到用户设置文件的 CSS 特定部分。

通过语言自定义编辑器的另一种方法是从命令面板 (⇧⌘P (Windows、Linux Ctrl+Shift+P)) 运行全局命令 首选项: 配置语言特定设置 (命令 ID: workbench.action.configureLanguageBasedSettings)，这将打开语言选择器。选择您想要的语言。然后，设置编辑器将打开，其中包含所选语言的语言过滤器，这允许您修改该语言的语言特定设置。但是，如果您将 workbench.settings.editor 设置设置为 json，则 settings.json 文件将打开，其中包含一个新的语言条目，您可以在其中添加适用的设置。

通过下拉列表选择语言

现在您可以开始编辑特定于该语言的设置

或者，如果 workbench.settings.editor 设置为 json，现在您可以开始将语言特定设置添加到您的用户设置中

如果您打开了一个文件，并且想要自定义此文件类型的编辑器，请选择 VS Code 窗口右下角状态栏中的语言模式。这将打开语言模式选择器，其中包含配置“language_name”语言的基于语言的设置选项。选择此选项将打开您的用户 settings.json，其中包含语言条目，您可以在其中添加适用的设置。

语言特定的编辑器设置始终覆盖非语言特定的编辑器设置，即使非语言特定的设置具有更窄的作用域。例如，语言特定的用户设置覆盖非语言特定的工作区设置。

您可以通过将语言特定的设置放置在工作区设置中（就像其他设置一样）来将语言特定的设置限定到工作区。如果您在用户和工作区作用域中都为同一种语言定义了设置，则它们将被合并，并且优先考虑在工作区中定义的设置。

以下示例可以粘贴到设置 JSON 文件中，以自定义 typescript 和 markdown 语言模式的编辑器设置。

{
  "[typescript]": {
    "editor.formatOnSave": true,
    "editor.formatOnPaste": true
  },
  "[markdown]": {
    "editor.formatOnSave": true,
    "editor.wordWrap": "on",
    "editor.renderWhitespace": "all",
    "editor.acceptSuggestionOnEnter": "off"
  }
}

您可以使用 settings.json 中的 IntelliSense 来帮助您查找语言特定的设置。支持所有编辑器设置和一些非编辑器设置。某些语言已经设置了默认的语言特定设置，您可以通过运行首选项: 打开默认设置命令在 defaultSettings.json 中查看这些设置。

多个语言特定的编辑器设置

您可以一次为多种语言配置语言特定的编辑器设置。以下示例显示了如何在您的 settings.json 文件中一起自定义 javascript 和 typescript 语言的设置

"[javascript][typescript]": {
  "editor.maxTokenizationLineLength": 2500
}

配置文件设置

您可以使用 VS Code 中的配置文件 创建自定义设置集并在它们之间快速切换。例如，它们是为特定编程语言自定义 VS Code 的绝佳方式。

当您切换到配置文件时，用户设置的作用域仅限于该配置文件。当您切换到另一个配置文件时，将应用另一个配置文件的用户设置。这样，您可以为不同的配置文件设置不同的设置。

配置文件的用户设置 JSON 文件位于以下目录中

• Windows %APPDATA%\Code\User\profiles\<profile ID>\settings.json
• macOS $HOME/Library/Application\ Support/Code/User/profiles/<profile ID>/settings.json
• Linux $HOME/.config/Code/User/profiles/<profile ID>/settings.json

<profile ID> 是配置文件的唯一标识符。对于每个覆盖设置的配置文件，都将有一个相应的配置文件设置文件。

当您使用非默认配置文件时，您可以使用命令面板 (⇧⌘P (Windows、Linux Ctrl+Shift+P)) 中的 首选项: 打开应用程序设置 (JSON) 命令访问与默认配置文件关联的 settings.json 文件。

设置优先级

配置可以通过不同的设置作用域在多个级别被覆盖。在以下列表中，后面的作用域覆盖前面的作用域

• 默认设置 - 此作用域表示默认的未配置设置值。
• 用户设置 - 全局应用于所有 VS Code 实例。
• 远程设置 - 应用于用户打开的远程计算机。
• 工作区设置 - 应用于打开的文件夹或工作区。
• 工作区文件夹设置 - 应用于多根工作区的特定文件夹。
• 语言特定的默认设置 - 这些是扩展可以贡献的语言特定的默认值。
• 语言特定的用户设置 - 与用户设置相同，但特定于语言。
• 语言特定的远程设置 - 与远程设置相同，但特定于语言。
• 语言特定的工作区设置 - 与工作区设置相同，但特定于语言。
• 语言特定的工作区文件夹设置 - 与工作区文件夹设置相同，但特定于语言。
• 策略设置 - 由系统管理员设置，这些值始终覆盖其他设置值。

设置值可以是各种类型

• 字符串 - "files.autoSave": "afterDelay"
• 布尔值 - "editor.minimap.enabled": true
• 数字 - "files.autoSaveDelay": 1000
• 数组 - "editor.rulers": []
• 对象 - "search.exclude": { "**/node_modules": true, "**/bower_components": true }

具有原始类型和数组类型的值将被覆盖，这意味着将使用优先于另一个作用域的作用域中配置的值，而不是另一个作用域中的值。但是，具有对象类型的值将被合并。

例如，workbench.colorCustomizations 接受一个对象，该对象指定一组 UI 元素及其所需的颜色。如果您的用户设置将编辑器背景设置为蓝色和绿色

  "workbench.colorCustomizations": {
    "editor.background": "#000088",
    "editor.selectionBackground": "#008800"
  }

并且您打开的工作区设置将编辑器前景色设置为红色

  "workbench.colorCustomizations": {
    "editor.foreground": "#880000",
    "editor.selectionBackground": "#00FF00"
  }

当该工作区打开时，结果是这两种颜色自定义的组合，就好像您指定了

  "workbench.colorCustomizations": {
    "editor.background": "#000088",
    "editor.selectionBackground": "#00FF00",
    "editor.foreground": "#880000"
  }

如果存在冲突的值，例如上面示例中的 editor.selectionBackground，则会发生通常的覆盖行为，其中工作区值优先于用户值，语言特定的值优先于非语言特定的值。

关于多个语言特定设置的说明

如果您正在使用多个语言特定设置，请注意，语言特定设置将被合并，并且优先级是基于完整的语言字符串（例如 "[typescript][javascript]"）而不是单个语言 ID（typescript 和 javascript）设置的。这意味着，例如，"[typescript][javascript]" 工作区设置不会覆盖 "[javascript]" 用户设置。

设置和安全

某些设置允许您指定 VS Code 将运行的可执行文件来执行某些操作。例如，您可以选择集成终端应使用的 shell。为了增强安全性，此类设置只能在用户设置中定义，而不能在工作区作用域中定义。

以下是不支持在工作区设置中使用的设置列表

• git.path
• terminal.external.windowsExec
• terminal.external.osxExec
• terminal.external.linuxExec

首次打开定义了其中任何设置的工作区时，VS Code 将警告您，然后始终忽略之后的值。

设置同步

您可以使用 Settings Sync (设置同步) 功能在您的 VS Code 实例之间共享您的用户设置。此功能允许您在不同机器上的 VS Code 安装之间共享设置、键盘快捷方式和已安装的扩展。您可以通过设置编辑器右侧的 Backup and Sync Settings (备份和同步设置) 命令或 Accounts (帐户) Activity Bar (活动栏) 上下文菜单启用 Settings Sync (设置同步)。

您可以在 Settings Sync (设置同步) 用户指南中了解有关启用和配置 Settings Sync (设置同步) 的更多信息。

功能生命周期

功能及其对应的设置可能处于以下状态之一。根据状态，您可能需要谨慎地在您的工作流程中使用该功能或设置。

• Experimental (实验性) - 供早期使用者使用的探索性功能。这些功能将来可能会更改或删除。在 Settings editor (设置编辑器) 中，这些设置具有 Experimental 标签。您还可以在搜索框中输入 @tag:experimental 来搜索实验性设置。

  

• Preview (预览) - 预览功能和设置具有最终功能，但仍可能为了稳定性和完善性而进行迭代。通常，预览功能默认情况下是禁用的。在 Settings editor (设置编辑器) 中，这些设置具有 Preview 标签。您还可以在搜索框中输入 @tag:preview 来搜索预览设置。

  

• Stable (稳定) - 该功能稳定并在 VS Code 中得到完全支持。

Experimental (实验性) 和 Preview (预览) 功能使您能够试用新功能并提供反馈。在 我们的 VS Code issues (VS Code 问题) 中分享您的反馈。

相关资源

• VS Code 默认设置参考
• 跨机器同步设置

常见问题

VS Code 提示 “无法写入设置。”

如果您尝试更改设置（例如打开自动保存或选择新的颜色主题）并且看到 “无法写入用户设置。请打开用户设置以更正其中的错误/警告，然后重试。”，则表示您的 settings.json 文件格式不正确或有错误。错误可能很简单，例如缺少逗号或设置值不正确。使用 Command Palette (命令面板) 中的 Preferences: Open User Settings (JSON) (首选项: 打开用户设置 (JSON)) 命令 (⇧⌘P (Windows, Linux Ctrl+Shift+P)) 打开 settings.json 文件，您应该会看到用红色波浪线突出显示的错误。

如何重置我的用户设置？

将 VS Code 重置回默认设置的最简单方法是清除您的用户 settings.json 文件。您可以使用 Command Palette (命令面板) 中的 Preferences: Open User Settings (JSON) (首选项: 打开用户设置 (JSON)) 命令 (⇧⌘P (Windows, Linux Ctrl+Shift+P)) 打开 settings.json 文件。文件在编辑器中打开后，删除两个花括号 {} 之间的所有内容，保存文件，VS Code 将恢复使用默认值。

什么时候使用 workspace settings (工作区设置) 才有意义？

如果您正在使用需要自定义设置的 workspace (工作区)，但您不想将它们应用到您的其他 VS Code 项目。一个很好的例子是特定于语言的 linting 规则。

在哪里可以找到扩展设置？

通常，VS Code 扩展将其设置存储在您的用户或 workspace settings (工作区设置) 文件中，并且可以通过 Settings editor UI (设置编辑器用户界面)（Preferences: Open Settings (UI) (首选项: 打开设置 (UI)) 命令）或通过 settings.json 文件中的 IntelliSense (智能感知)（Preferences: Open User Settings (JSON) (首选项: 打开用户设置 (JSON)) 命令）访问它们。按扩展名称（例如 gitlens 或 python）搜索可以帮助将设置过滤到仅由扩展贡献的设置。