本站点文档内容均翻译自code.visualstudio.com，仅供个人学习，如有差异请以官网为准。

Visual Studio Code 中的配置文件

Visual Studio Code 有数百个设置，数千个扩展，以及无数种调整用户界面布局以定制编辑器的方法。VS Code配置文件 让你可以创建一组定制并快速在它们之间切换或与他人分享。本主题解释了如何使用配置文件编辑器来创建、修改、导出和导入配置文件。

访问配置文件编辑器

该配置文件编辑器使您能够在 VS Code 中从一个地方创建和管理您的配置文件。

显示配置文件编辑器的截图。

您可以通过以下任何一种方式访问配置文件编辑器：

  • 从 文件 > 首选项 > 配置文件 菜单项

    配置文件编辑器 菜单项

  • 从活动栏底部的管理齿轮按钮。

    通过活动栏中的管理按钮打开配置文件编辑器

创建个人资料

VS Code 将您当前的配置视为 默认配置文件。当您修改设置、安装扩展或通过移动视图更改用户界面布局时，这些自定义设置会在默认配置文件中进行跟踪。

要创建一个新的配置文件，请打开配置文件编辑器并选择新建配置文件按钮。这将打开新建配置文件表单，您可以在其中输入配置文件名称、选择图标，并配置新配置文件中包含的内容。

创建个人资料

您可以选择通过复制配置文件模板或现有配置文件的内容来创建新的配置文件，或者创建一个空配置文件。空配置文件不包括任何用户自定义设置，例如设置、扩展、片段等。

从选项中复制

您可以限制新配置文件仅包含一组配置（设置、键盘快捷键、MCP服务器、片段、任务和扩展），并从默认配置文件中使用其余配置。例如，您可以创建一个包含所有配置的配置文件，但不包括键盘快捷键，当此配置文件激活时，VS Code 将应用默认配置文件中的键盘快捷键。

您可以在内容部分浏览您正在复制的模板或配置文件的内容。在每个部分旁边都有一个打开按钮，您可以选择该按钮以查看其内容。

配置、浏览和预览配置文件

在创建之前预览新的配置文件，选择预览按钮。这将打开一个带有新配置文件的新VS CodeWindows。一旦你对预览满意，你可以选择创建按钮来创建新的配置文件。

检查当前配置文件

您可以在 VS Code Windows的 VS Code 用户界面的几个地方找到当前正在使用的配置文件：

  • 在 VS Code 标题栏

  • 当您将鼠标悬停在活动栏上的管理按钮上时的工具提示

    如果为配置文件配置了图标，此图标将用作活动栏中的管理按钮。请注意以下屏幕截图中，管理按钮现在有一个麦克风图标，表示配置文件已激活。

    管理齿轮显示图标以表示用户资料是活动的

    如果你还没有配置图标，那么管理齿轮按钮会显示当前活动配置文件的前两个字母的徽章，这样你就可以快速检查你正在运行哪个配置文件。

    管理显示“DA”的装备，以指示用户的数据科学配置文件处于活动状态

  • 在配置文件编辑器中

    正在编辑的当前配置文件

注意：如果您使用的是默认配置文件，则不会显示配置文件名称。

配置个人资料

您可以像更改任何 VS Code 配置一样配置个人资料。您可以安装/卸载/禁用扩展、更改设置并调整编辑器的用户界面布局（例如，移动和隐藏视图）。当您应用这些更改时，它们将存储在您当前活动的个人资料中。

文件夹和工作区关联

当您创建或选择一个配置文件时，它会与当前文件夹或工作区关联。每当您打开该文件夹时，工作区的配置文件将变得活跃。如果您打开另一个文件夹，配置文件会更改为另一个文件夹的配置文件（如果已设置）。

您可以在文件夹和工作区部分的配置文件编辑器中查看与配置文件关联的文件夹列表。

文件夹和工作区部分

管理个人资料

切换配置文件

您可以通过命令面板中的配置文件：切换配置文件命令快速切换配置文件，该命令会显示一个下拉菜单，列出您可用的配置文件。

你也可以在配置文件编辑器中切换配置文件，通过选择你想要切换到的配置文件旁边的为当前Windows使用此配置文件按钮。

在配置文件编辑器中切换配置文件

编辑个人资料

您可以在配置文件编辑器中编辑现有配置文件的名称、图标和其他配置。

删除一个配置文件

您可以通过选择配置文件编辑器中的删除配置文件按钮从您要删除的配置文件的溢出操作中删除配置文件。

从配置文件编辑器中删除配置文件

您还可以通过删除配置文件命令删除配置文件。 删除配置文件下拉菜单可让您选择要删除的配置文件。

打开一个带有配置文件的新Windows

您可以在打开新的 VS Code Windows时通过使用 Use for New Windows 选项来选择一个配置文件，该选项可在配置文件编辑器的配置文件内容视图中找到。

为新Windows配置自定义配置文件

您可以通过使用文件 > 使用配置文件新建Windows菜单并选择您要使用的配置文件，直接打开一个特定配置文件的 VS Code Windows。

将设置应用到所有配置文件

要将设置应用到所有配置文件，请在设置编辑器中使用应用设置到所有配置文件操作。

应用设置到所有配置文件

在任何配置文件中对此设置的更改也会应用到所有其他配置文件。您可以通过取消选中将设置应用到所有配置文件操作随时恢复此行为。

将扩展应用到所有配置文件

要将扩展应用到所有配置文件，请在扩展视图中选择应用扩展到所有配置文件操作。

将扩展应用到所有配置文件

这将使此扩展在您的所有配置文件中可用。您可以通过取消选中将扩展应用于所有配置文件操作随时恢复此行为。

在机器之间同步配置文件

您可以使用设置同步在不同机器之间移动您的配置文件。启用设置同步并选中配置文件在设置同步：配置下拉菜单中，所有配置文件将在同步的机器上可用。

设置同步数据下拉菜单，勾选配置文件

注意：VS Code 不会在 远程 Windows（例如您连接到 SSH、开发容器 (devcontainer) 或 WSL 时）同步您的扩展。

分享个人资料

导出

您可以使用导出...按钮导出配置文件，以保存或与他人分享。

从配置文件编辑器导出配置文件

当你选择 导出...时，系统会提示你输入配置文件名称，并询问你是否要导出到 GitHub gist 或者本地文件系统。

保存为 GitHub 代码片段

在 GitHub 上保存个人资料后（您将被提示登录 GitHub），对话框会提供一个选项 复制链接，以便与他人分享您的个人资料 gist URL。该 URL 包含一个自动生成的 GUID，格式为 https://vscode.dev/editor/profile/github/{GUID}GitHub 代码片段被标记为 秘密，因此只有链接持有者可以看到代码片段。

如果你启动配置文件链接，它会打开VS Code for the Web，并打开配置文件编辑器，显示导入的配置文件内容。如果你不希望选择配置文件元素，且你希望继续在VS Code for the Web中使用该配置文件，你需要手动安装扩展（通过下载云按钮）。

您还可以选择在Visual Studio Code中导入配置文件，这将打开VS Code桌面，并显示配置文件的内容和一个导入配置文件按钮。

您可以查看您的代码片段https://gist.github.com/{用户名}从你的 GitHub gist 页面，你可以重命名、删除或复制 gist 的 GUID。

保存为本地文件

如果您选择将配置文件保存为本地文件，一个保存配置文件对话框允许您将文件放置在本地机器上。配置文件以扩展名为保存在文件中.代码-个人资料输入：.

导入

您可以通过在配置文件编辑器中选择导入配置文件...按钮来导入现有的配置文件，该按钮位于新建配置文件按钮的下拉操作中。

从配置文件编辑器导入配置文件

当您选择导入配置文件...时，系统会通过一个导入配置文件对话框提示您输入GitHub gist的URL或配置文件的文件位置。一旦您选择了配置文件，配置文件创建表单将打开，并且导入的配置文件将被预选中。您可以继续修改配置文件并选择创建以导入配置文件。

个人资料的用途

配置文件是定制 VS Code 以更好地满足您的需求的绝佳方式。在本节中，我们将探讨一些配置文件的常见用例。

由于配置文件是按工作区记住的，它们是为特定编程语言定制 VS Code 的绝佳方式。例如，您可以创建一个 JavaScript 前端配置文件，该文件包含在单个工作区中您用于 JavaScript 开发的扩展、设置和自定义内容，并且可以创建一个 Python 后端配置文件，该文件包含在另一个工作区中您用于 Python 开发的扩展、设置和自定义内容。使用这种方法，您可以轻松地在工作区之间切换，并始终将 VS Code 配置为正确的状态。

演示

在进行演示时，您可以使用配置文件来设置演示的特定配置。例如，您可以创建一个包含特定扩展和设置（如缩放级别、字体大小和颜色主题）的配置文件。通过这样做，演示不会干扰您正常的 VS Code 设置，并且您可以在演示期间自定义 VS Code 以获得更好的可见性。

教育

配置文件可以用于为学生定制 VS Code，以便在课堂环境中更轻松地使用。配置文件允许教育工作者快速与学生分享定制的 VS Code 设置。例如，教育工作者可以创建一个包含特定扩展和计算机科学课程所需设置的配置文件，然后与学生分享该配置文件。

报告 VS Code 问题

创建一个空配置文件的用途之一是在您想报告 VS Code 问题时重置您的编辑器。空配置文件禁用所有扩展和修改的设置，这样您就可以快速确定问题是由于扩展、设置还是 VS Code 核心引起的。

个人资料模板

VS Code 附带了一组预定义的配置模板，您可以使用这些模板来为特定的工作流程定制 VS Code。要基于模板创建新的配置，请在创建配置流程中选择一个配置模板。

Python 个人资料模板

Python 代码分析是一个很好的 Python 开发起点。它包含特定于 Python 的代码片段，并具有以下扩展：

  • 自动文档字符串 - 自动生成Python文档字符串。
  • 容器工具 - 创建、管理和调试容器化应用程序。
  • 更好的 TOML - 提供完全功能的 TOML 支持，例如 pyproject.toml文件。
  • Python - 提供智能感知、环境管理、调试、重构。
  • Python 环境 - 使用您喜欢的环境管理器管理 Python 环境和包。
  • 远程开发 扩展包 - 支持 SSH、WSL 和 Dev Containers。
  • Ruff - 集成了Ruff Python 代码检查器和格式化工具。

此配置文件还设置以下设置：

    "python.analysis.autoImportCompletions"：真，
    "python.analysis.fixAll"：["source.unusedImports"]，
    "editor.defaultFormatter"："charliermarsh.ruff"

数据科学个人简介模板

数据科学配置文件是所有数据和笔记本工作的良好起点。它带有特定的片段，并具有以下扩展：

  • 数据整理师 - 数据查看、清理和准备用于表格数据集和Excel/CSV/Parquet文件。
  • GitHub Copilot - 你的AI编程伙伴。
  • Jupyter - 在 VS Code 中使用 Jupyter 笔记本。
  • Python - 提供智能感知、环境管理、调试、重构。
  • 远程开发 扩展包 - 支持 SSH、WSL 和 Dev Containers。
  • Ruff - 集成了Ruff Python 代码检查器和格式化工具。

此配置文件还设置以下设置：

    "[python]": {
        "editor.defaultFormatter": "charliermarsh.ruff",
        "editor.formatOnType": true,
        "editor.formatOnSave": true
    },
    "editor.inlineSuggest.enabled": true,
    "editor.lineHeight": 17,
    "breadcrumbs.enabled": false,
    "files.autoSave": "afterDelay",
    "notebook.output.scrolling": true,
    "jupyter.themeMatplotlibPlots": true,
    "jupyter.widgetScriptSources": [
        "unpkg.com",
        "jsdelivr.com"
    ],
    "files.exclude": {
        "**/.csv": true,
        "**/.parquet": true,
        "**/.pkl": true,
        "**/.xls": true
    }

文档撰写者个人资料模板

Doc Writer 配置文件是一个轻量级的文档编写设置。它包含以下扩展：

此配置文件还设置以下设置：

    "workbench.colorTheme": "Default Light Modern",
    "editor.minimap.enabled": false,
    "breadcrumbs.enabled": false,
    "editor.glyphMargin": false,
    "explorer.decorations.badges": false,
    "explorer.decorations.colors": false,
    "editor.fontLigatures": true,
    "files.autoSave": "afterDelay",
    "git.enableSmartCommit": true,
    "window.commandCenter": true,
    "editor.renderWhitespace": "none",
    "workbench.editor.untitled.hint": "hidden",
    "markdown.validate.enabled": true,
    "markdown.updateLinksOnFileMove.enabled": "prompt",
    "workbench.startupEditor": "none"

Node.js 个人资料模板

Node.js配置文件是所有Node.js工作的良好起点。它包含以下扩展：

此配置文件包含以下设置：

    "editor.formatOnPaste": true,
    "git.autofetch": true,
    "[markdown]":  {
        "editor.wordWrap": "on"
    },
    "[json]": {
        "editor.defaultFormatter": "esbenp.prettier-vscode"
    },
    "[jsonc]": {
        "editor.defaultFormatter": "vscode.json-language-features"
    },
    "[html]": {
        "editor.defaultFormatter": "esbenp.prettier-vscode"
    },
    "[javascript]": {
        "editor.defaultFormatter"："esbenp.prettier-vscode"
    },
    "[typescript]"：
        "editor.defaultFormatter"："esbenp.prettier-vscode"
    }

角形轮廓模板

Angular 模板是一个适合所有Angular工作的良好起点。它包含以下扩展：

此配置文件设置以下设置：

    "editor.formatOnPaste": true,
    "git.autofetch": true,
    "[markdown]":  {
        "editor.wordWrap": "on"
    },
    "[json]": {
        "editor.defaultFormatter": "esbenp.prettier-vscode"
    },
    "[jsonc]": {
        "editor.defaultFormatter": "vscode.json-language-features"
    },
    "[html]": {
        "editor.defaultFormatter": "esbenp.prettier-vscode"
    },
    "[javascript]": {
        "editor.defaultFormatter": "esbenp.prettier-vscode"
    },
    "[typescript]": {
        "editor.defaultFormatter": "esbenp.prettier-vscode"
    },
    "workbench.iconTheme": "material-icon-theme"

Java通用配置文件模板

Java通用配置是所有Java工作的一个很好的起点。它定制了布局以改善Java体验，并附带了Java扩展包中的以下扩展：

Java Spring 配置文件模板

Java Spring 配置文件是所有 Java 和 Spring 开发人员的良好起点。它基于 Java 通用配置文件，并添加了 Spring Boot 扩展包中的以下扩展：

此配置文件设置以下设置：

    "[java]": {
        "editor.defaultFormatter": "redhat.java"
    },
    "boot-java.rewrite.reconcile": true

命令行

你可以通过以下方式使用特定配置文件启动 VS Code--配置文件命令行界面选项。您在后面传递配置文件的名称。--配置文件参数并使用该配置文件打开一个文件夹或一个工作区。下面的命令行打开网页样本包含"Web Development"配置文件的文件夹：

代码 ~/projects/web-sample --profile "Web Development"

如果指定的配置文件不存在，则创建一个具有给定名称的新空配置文件。

常见问题

用户资料保存在哪里？

配置文件存储在您的用户配置中，类似于您的用户设置和键盘快捷键。

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

如果您正在使用Insiders版本，中间文件夹名称是代码 - 内幕者输入：.

什么是临时配置文件？

临时配置文件是每次 VS Code 会话结束后不会保存的配置文件。您可以通过命令面板中的 配置文件：创建一个临时配置文件 命令创建一个临时配置文件。临时配置文件初始为一个空配置文件，并有一个自动生成的名称（例如 Temp 1）。您可以修改配置文件设置和扩展，在 VS Code 会话期间使用该配置文件，但一旦关闭 VS Code，它将被删除。

临时配置文件在您想尝试新的配置或测试扩展而不想修改默认或现有配置文件时非常有用。重新启动 VS Code 会重新启用当前配置文件。

我可以继承另一个配置文件的设置吗？

目前，无法从另一个配置文件继承设置，您可以在其中覆盖特定设置并保留其他设置。我们正在跟踪这个功能请求在vscode库中。

当您创建一个新的配置文件时，您可以选择从另一个或默认配置文件复制设置。这会在新的配置文件中创建设置的副本，但不会保持到您用作源的配置文件的链接。

如何从我的项目中删除配置文件？

您可以将项目恢复到默认配置文件。如果您想移除所有配置文件工作区关联，您可以使用开发者：重置工作区配置文件关联，这将把当前分配了配置文件的所有本地文件夹恢复到默认配置文件。重置工作区配置文件关联不会删除任何现有的配置文件。

为什么在导出配置文件时某些设置没有导出？

在导出配置文件时，不包括机器特定的设置，因为这些设置在另一台机器上是不适用的。例如，指向本地路径的设置不包括在内。

为什么在创建新配置文件时无法使用模板？

配置文件模板由 VS Code 外部托管，只有在连接到互联网时才能下载和应用模板。如果发现配置文件模板不可用，请确保检查您的互联网连接。