Visual Studio Code 中的配置文件

Visual Studio Code 拥有数百项设置、数千个扩展，以及无数种调整 UI 布局的方法来定制编辑器。VS Code 的 **配置文件** 允许您创建自定义集，并快速在它们之间切换或与他人共享。本主题将介绍如何使用 **配置文件编辑器** 创建、修改、导出和导入配置文件。

访问配置文件编辑器

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

Screenshot that shows the Profiles editor.

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

从 **文件** > **首选项** > **配置文件** 菜单项
从活动栏底部的 **管理**（齿轮状按钮）

创建配置文件

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

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

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

Copy from options

您可以限制新配置文件仅包含配置（设置、键盘快捷键、MCP 服务器、代码片段、任务和扩展）的子集，并使用默认配置文件中的其余配置。例如，您可以创建一个包含所有配置但排除键盘快捷键的配置文件，当此配置文件处于活动状态时，VS Code 将应用默认配置文件中的键盘快捷键。

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

Configure, browse and preview profile

通过选择 **预览** 按钮，在创建新配置文件之前对其进行预览。这将打开一个新的 VS Code 窗口，其中应用了新配置文件。预览满意后，您可以选择 **创建** 按钮来创建新配置文件。

查看当前配置文件

您可以在 VS Code UI 的多个位置找到当前 VS Code 窗口正在使用的配置文件：

在 VS Code 标题栏中
在活动栏中的 **管理** 按钮上悬停时的工具提示中

如果您为配置文件配置了图标，该图标将用作活动栏中的 **管理** 按钮。请注意，在以下屏幕截图中，“管理”按钮现在显示一个麦克风图标，表示某个配置文件处于活动状态。

如果您未配置图标，则 **管理**（齿轮状按钮）上会显示一个带有活动配置文件前两个字母的徽章，以便您快速查看正在运行的配置文件。
在配置文件编辑器中

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

配置配置文件

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

文件夹和工作区关联

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

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

Folders & Workspaces section

管理配置文件

切换配置文件

您可以使用命令面板中的 **Profiles: Switch Profile** 命令在配置文件之间快速切换，该命令会显示一个列出可用配置文件的下拉列表。

您还可以从 **配置文件编辑器** 切换配置文件，方法是选择要切换到的配置文件旁边的 **将此配置文件用于当前窗口** 按钮。

编辑配置文件

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

删除配置文件

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

您还可以通过 **Delete Profile** 命令删除配置文件。**Delete Profile** 下拉菜单允许您选择要删除的配置文件。

使用配置文件打开新窗口

您可以在打开新 VS Code 窗口时选择要使用的配置文件，方法是使用配置文件编辑器中配置文件内容视图的 **用于新窗口** 选项。

您可以使用 **文件** > **使用配置文件新建窗口** 菜单，然后选择要使用的配置文件，直接为特定配置文件打开一个新的 VS Code 窗口。

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

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

Apply setting to all Profiles

从任何配置文件中对该设置进行的更新也会应用于所有其他配置文件。您可以通过取消选中 **将设置应用于所有配置文件** 操作来撤消此行为。

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

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

Apply an extension to all Profiles

这将使该扩展在所有配置文件中都可用。您可以通过取消选中 **将扩展应用于所有配置文件** 操作来撤消此行为。

跨计算机同步配置文件

您可以使用设置同步将您的配置文件移动到各种计算机。启用设置同步并选中 **设置同步：配置** 下拉列表中的 **配置文件** 后，您所有的配置文件都将在同步的计算机上可用。

Settings Sync data drop down with Profiles checked

注意：VS Code 不会与远程窗口同步您的扩展，例如当您连接到 SSH、开发容器（devcontainer）或 WSL 时。

共享配置文件

导出

您可以通过配置文件溢出操作中的 **导出...** 按钮导出配置文件，以便保存或与他人共享。

选择 **导出...** 后，系统会提示您输入配置文件名称，并询问您是要导出到 GitHub Gist 还是本地文件系统。

保存为 GitHub Gist

在将配置文件保存到 GitHub 后（会提示您登录 GitHub），将弹出一个对话框，让您选择 **复制链接** 以与他人共享您的配置文件 Gist URL。该 URL 包含一个自动生成的 GUID，格式为 https://vscode.dev/editor/profile/github/{GUID}。GitHub Gist 会被标记为 **Secret**，因此只有拥有链接的人才能看到该 Gist。

如果您启动配置文件 URL，它将在 Web 版 VS Code 中打开，并显示配置文件编辑器和导入的配置文件内容。您可以根据需要取消选择配置文件元素，如果您想在 Web 版 VS Code 中继续使用该配置文件，则需要手动 **安装扩展**（通过下载云按钮）。

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

您可以在 https://gist.github.com/{username} 查看您的 Gists。从您的 GitHub Gist 页面，您可以重命名、删除或复制 Gist 的 GUID。

保存为本地文件

如果您选择将配置文件保存为本地文件，则 **保存配置文件** 对话框允许您将文件保存在本地计算机上。配置文件将以 .code-profile 扩展名的文件形式持久保存。

导入

您可以从 **配置文件编辑器** 导入现有配置文件，方法是选择 **新建配置文件** 按钮的下拉操作中的 **导入配置文件...** 按钮。

选择 **导入配置文件...** 后，将弹出一个 **导入配置文件** 对话框，提示您输入 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 特定的代码片段，并具有以下扩展：

autoDocstring - 自动生成 Python 文档字符串。
Container Tools - 创建、管理和调试容器化应用程序。
Even Better TOML - 提供全面的 TOML 支持，例如用于 pyproject.toml 文件。
Python - IntelliSense、环境管理、调试、重构。
Python Environments - 使用您喜欢的环境管理器管理 Python 环境和包。
Remote Development 扩展包 - 支持 SSH、WSL 和 Dev Containers。
Ruff - 集成了 Ruff Python linter 和格式化程序。

此配置文件还设置了以下选项：

    "python.analysis.autoImportCompletions": true,
    "python.analysis.fixAll": ["source.unusedImports"],
    "editor.defaultFormatter": "charliermarsh.ruff"

数据科学配置文件模板

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

Data Wrangler - 表格数据集和 Excel/CSV/Parquet 文件的可视化、清理和准备。
GitHub Copilot - 您的 AI 编程助手。
Jupyter - 在 VS Code 中使用 Jupyter 笔记本。
Python - IntelliSense、环境管理、调试、重构。
Remote Development 扩展包 - 支持 SSH、WSL 和 Dev Containers。
Ruff - 集成了 Ruff Python linter 和格式化程序。

此配置文件还设置了以下选项：

    "[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
    }

文档编写者配置文件模板

文档编写者配置文件是一个轻量级的文档编写设置。它附带以下扩展：

Code Spell Checker - 源代码拼写检查器。
Markdown Checkboxes - 为 VS Code 内置的 Markdown 预览添加复选框支持。
Markdown Emoji - 为 Markdown 预览和笔记本 Markdown 单元格添加表情符号语法支持。
Markdown Footnotes - 为 Markdown 预览添加 ^ 脚注语法支持。
Markdown Preview GitHub Styling - 在 Markdown 预览中使用 GitHub 样式。
Markdown Preview Mermaid Support - Mermaid 图表和流程图。
Markdown yaml Preamble - 将 YAML 前导信息渲染为表格。
markdownlint - Visual Studio Code 的 Markdown 检查和样式检查。
Word Count - 在状态栏中查看 Markdown 文档的字数。
Read Time - 估算阅读 Markdown 所需的时间。

此配置文件还设置了以下选项：

    "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 工作的一个良好起点。它附带以下扩展：

Container Tools - 创建、管理和调试容器化应用程序。
Dev Containers - 在 Docker 容器中创建自定义开发环境。
DotENV - 支持 dotenv 文件语法。
EditorConfig for VS Code - VS Code 的 EditorConfig 支持。
ESLint - 将 ESLint JavaScript 集成到 VS Code 中。
JavaScript (ES6) code snippets - ES6 语法 JavaScript 代码片段。
Jest - 使用 Facebook 的 Jest 测试框架。
Microsoft Edge Tools for VS Code - 从 VS Code 中使用 Microsoft Edge 工具。
npm Intellisense - 在 import 语句中自动补全 npm 模块。
Prettier - Code formatter - 使用 Prettier 进行代码格式化。
Rest Client - Visual Studio Code 的 REST 客户端。
YAML - 具有内置 Kubernetes 语法的 YAML 语言支持。

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

    "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 配置文件是所有 Angular 工作的一个良好起点。它附带以下扩展：

Angular Language Service - Angular 模板的编辑器服务。
Angular Schematics - 集成 Angular schematics（CLI 命令）。
angular2-switcher - 轻松导航到 Angular2 项目中的 typescript|template|style。
Dev Containers - 在 Docker 容器中创建自定义开发环境。
EditorConfig for VS Code - VS Code 的 EditorConfig 支持。
ESLint - 将 ESLint JavaScript 集成到 VS Code 中。
JavaScript (ES6) code snippets - ES6 语法 JavaScript 代码片段。
Jest - 使用 Facebook 的 Jest 测试框架。
Material Icon Theme - Material Design 图标用于 Visual Studio Code。
Microsoft Edge Tools for VS Code - 从 VS Code 中使用 Microsoft Edge 工具。
Playwright Test for VSCode - 在 Visual Studio Code 中运行 Playwright 测试。
Prettier - Code formatter - 使用 Prettier 进行代码格式化。
Rest Client - Visual Studio Code 的 REST 客户端。
YAML - 具有内置 Kubernetes 语法的 YAML 语言支持。

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

    "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 体验，并附带以下来自 Extension Pack for Java 的扩展：

Debugger for Java - 轻量级 Java 调试器。
IntelliCode - AI 辅助开发。
IntelliCode API Usage Examples - 为超过 100,000 个不同 API 提供代码示例。
Language Support for Java(TM) by Red Hat - 基础 Java 语言支持、代码检查、Intellisense、格式化、重构。
Maven for Java - 管理 Maven 项目和构建。
Project Manager for Java - 在 VS Code 中管理 Java 项目。
Test Runner for Java - 运行和调试 JUnit 或 TestNG 测试用例。

Java Spring 配置文件模板

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

Spring Boot Dashboard - 提供 Spring Boot 实时数据可视化和对正在运行的 Spring 应用程序的观测。
Spring Boot Tools - 为 Spring Boot 文件提供丰富的语言支持。
Spring Initializr Java Support - 脚手架和生成 Spring Boot Java 项目。

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

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

命令行

您可以通过 --profile 命令行接口选项来启动具有特定配置文件的 VS Code。您在 --profile 参数后传入配置文件的名称，并使用该配置文件打开文件夹或工作区。下面的命令行使用“Web Development”配置文件打开 web-sample 文件夹。

code ~/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 版本，中间文件夹名称为 Code - Insiders。

什么是临时配置文件？

临时配置文件是在 VS Code 会话之间不保存的配置文件。您可以通过命令面板中的 **Profiles: Create a Temporary Profile** 命令创建临时配置文件。临时配置文件以空配置文件开始，并具有自动生成的名称（例如 **Temp 1**）。您可以修改配置文件设置和扩展，在 VS Code 会话期间使用该配置文件，但关闭 VS Code 后它将被删除。

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

我能从其他配置文件继承设置吗？

目前，无法从其他配置文件继承设置，即您覆盖特定设置并保留其他设置。我们正在跟踪此功能请求在 vscode 存储库中。

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

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

您可以将项目恢复到默认配置文件。如果您想删除所有配置文件工作区关联，可以使用 **Developer: Reset Workspace Profiles Associations** 命令，这将把所有当前分配了配置文件的本地文件夹恢复到默认配置文件。**Reset Workspace Profiles Associations** 不会删除任何现有配置文件。

导出配置文件时，为什么有些设置未被导出？

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

为什么在创建新配置文件时模板不可用？

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

01/08/2026