Visual Studio Code 中的配置文件

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

访问配置文件编辑器

配置文件编辑器使您能够在一个地方创建和管理 VS Code 中的配置文件。配置文件编辑器默认以模态叠加层 (modal overlay) 的形式在编辑器区域上方打开。

Screenshot that shows the Profiles editor.

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

通过 文件 (File) > 首选项 (Preferences) > 配置文件 (Profiles) 菜单项
通过活动栏底部的管理 (Manage) 齿轮按钮。

创建配置文件

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

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

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

Copy from options

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

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

Configure, browse and preview profile

在创建新配置文件之前，可以点击预览 (Preview) 按钮进行查看。这会打开一个新的 VS Code 窗口，并应用该新配置文件。如果您对预览满意，可以点击创建 (Create) 按钮来创建新配置文件。

检查当前配置文件

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

在 VS Code 标题栏中
将鼠标悬停在活动栏中的管理 (Manage) 按钮上时显示的悬停文本中

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

如果您没有配置图标，管理 (Manage) 齿轮按钮会显示一个徽章，上面有活动配置文件的前两个字母，以便您可以快速查看当前正在运行的配置文件。
在配置文件编辑器中

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

配置配置文件

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

文件夹与工作区关联

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

您可以在配置文件编辑器的文件夹与工作区 (Folders & Workspaces) 部分查看与配置文件关联的文件夹列表。

Folders & Workspaces section

管理配置文件

切换配置文件

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

您还可以通过配置文件编辑器进行切换，点击您想要切换到的配置文件旁边的为此窗口使用此配置文件 (Use this Profile for Current Window) 按钮。

编辑配置文件

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

删除配置文件

您可以在配置文件编辑器中点击要删除的配置文件溢出菜单中的删除配置文件 (Delete Profile) 按钮来删除它。

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

使用配置文件打开新窗口

您可以在配置文件编辑器的“配置文件内容”视图中使用用于新窗口 (Use for New Windows) 选项，来选择打开新 VS Code 窗口时使用的配置文件。

您可以通过文件 (File) > 使用配置文件新建窗口 (New Window with Profile) 菜单直接为特定配置文件打开一个新的 VS Code 窗口，并选择要使用的配置文件。

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

要将某个设置应用于所有配置文件，请在设置编辑器中使用将设置应用到所有配置文件 (Apply Setting to all Profiles) 操作。

Apply setting to all Profiles

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

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

要将某个扩展应用于所有配置文件，请在扩展视图中选择将扩展应用到所有配置文件 (Apply Extension to all Profiles) 操作。

Apply an extension to all Profiles

这将使该扩展在您的所有配置文件中可用。您随时可以通过取消勾选将扩展应用到所有配置文件操作来撤销此行为。

跨机器同步配置文件

您可以使用设置同步 (Settings Sync) 在不同机器之间移动配置文件。在启用设置同步并在设置同步：配置 (Settings Sync: Configure) 下拉菜单中勾选配置文件 (Profiles) 后，您的所有配置文件都将在已同步的机器上可用。

Settings Sync data drop down with Profiles checked

注意：VS Code 不会同步您在远程窗口（例如连接到 SSH、开发容器或 WSL 时）中安装或卸载的扩展。

共享配置文件

导出

您可以通过点击要导出的配置文件溢出菜单中的导出... (Export...) 按钮来导出配置文件，以便保存或与他人共享。

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

保存为 GitHub Gist

将配置文件保存到 GitHub 后（系统会提示您登录 GitHub），对话框会为您提供复制链接 (Copy Link) 选项，以便与他人共享您的配置文件 Gist URL。该 URL 包含自动生成的 GUID，格式为 https://vscode.dev/editor/profile/github/{GUID}。GitHub Gist 被标记为私密 (Secret)，因此只有拥有链接的人才能看到该 Gist。

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

您还可以选择在 Visual Studio Code 中导入配置文件 (Import Profile in Visual Studio Code)，这将打开 VS Code 桌面版并显示配置文件内容，以及一个导入配置文件 (Import Profile) 按钮。

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

保存为本地文件

如果您选择将配置文件保存为本地文件，保存配置文件 (Save Profile) 对话框允许您将其放置在本地机器上。配置文件将以扩展名为 .code-profile 的文件格式持久化存储。

导入

您可以在配置文件编辑器中，通过点击新建配置文件按钮下拉操作中的导入配置文件... (Import 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
    }

文档编写者配置文件模板

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

Code Spell Checker - 源代码拼写检查器。
Markdown Checkboxes - 为 VS Code 内置的 Markdown 预览添加复选框支持。
Markdown Emoji - 为 Markdown 预览和笔记本 Markdown 单元格添加 emoji 语法支持。
Markdown Footnotes - 为 Markdown 预览添加 ^脚注语法支持。
Markdown Preview GitHub Styling - 在 Markdown 预览中使用 GitHub 样式。
Markdown Preview Mermaid Support - Mermaid 图表和流程图。
Markdown yaml Preamble - 将 YAML Front Matter 渲染为表格。
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 - 为 Visual Studio 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 Client。
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 - 为 Visual Studio Code 提供 EditorConfig 支持。
ESLint - 将 ESLint JavaScript 集成到 VS Code 中。
JavaScript (ES6) code snippets - ES6 语法的 JavaScript 代码片段。
Jest - 使用 Facebook 的 jest 测试框架。
Material Icon Theme - Visual Studio Code 的 Material Design 图标主题。
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 Client。
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 General) 配置文件是所有 Java 工作的良好起点。它自定义了布局以改善 Java 体验，并附带了来自 Java 扩展包 (Extension Pack for Java) 的以下扩展：

Debugger for Java - 轻量级 Java 调试器。
IntelliCode - AI 辅助开发。
IntelliCode API Usage Examples - 提供超过 10 万个不同 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 扩展包的以下扩展：

Spring Boot Dashboard - 在您运行的 Spring 应用程序中提供 Spring Boot 实时数据可视化和观察。
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。

什么是临时配置文件？

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

如果您想在不修改默认或现有配置文件的情况下尝试新配置或测试扩展，临时配置文件非常有用。重启 VS Code 将重新为您的工作区启用当前配置文件。

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

目前无法从另一个配置文件继承设置（即覆盖特定设置而保留其他所有设置）。我们正在跟踪这个功能请求。

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

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

您可以将项目重置回“默认配置文件”。如果您想移除所有工作区配置文件的关联，可以使用 Developer: Reset Workspace Profiles Associations，它会将当前分配了配置文件的所有本地文件夹重置回默认配置文件。Reset Workspace Profiles Associations 不会删除任何现有配置文件。

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

导出配置文件时，机器特定的设置不包含在内，因为这些设置在其他机器上可能不适用。例如，指向本地路径的设置就不会被包含。

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

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

02/04/2026