探索 Agent 式開發 -

Visual Studio Code 中的設定檔

Visual Studio Code 擁有數百種設定、數千個擴充功能，以及無數種調整 UI 版面配置以自訂編輯器的方式。VS Code **設定檔**可讓您建立自訂組合，並在它們之間快速切換或與他人共用。本主題說明如何使用**設定檔編輯器**來建立、修改、匯出及匯入設定檔。

存取設定檔編輯器

**設定檔編輯器**可讓您在 VS Code 中從單一位置建立及管理設定檔。設定檔編輯器預設會在編輯器區域上方以強制回應覆疊的方式開啟。

Screenshot that shows the Profiles editor.

您可以透過以下任一方式存取設定檔編輯器

  • 從**檔案** > **喜好設定** > **設定檔**選單項目

    Profiles editor Menu Item

  • 從活動列底部的**管理**齒輪按鈕

    Profiles editor via the Manage button in the Activity bar

建立設定檔

VS Code 將您目前的組態視為**預設設定檔**。當您修改設定、安裝擴充功能，或透過移動檢視來變更 UI 版面配置時，這些自訂項目都會在預設設定檔中追蹤。

若要建立新的設定檔，請開啟設定檔編輯器並選取**新增設定檔**按鈕。這會開啟「新增設定檔」表單，您可以在其中輸入設定檔名稱、選擇圖示，並設定新設定檔中包含的內容。

Create Profile

您可以選擇透過複製「設定檔範本」或現有設定檔的內容來建立新設定檔，或建立**空白設定檔**。空白設定檔不包含任何使用者自訂項目，例如設定、擴充功能、程式碼片段等等。

Copy from options

您可以限制新設定檔只包含一部分組態（設定、鍵盤快速鍵、MCP 伺服器、程式碼片段、工作和擴充功能），並使用預設設定檔中的其餘組態。例如，您可以建立一個包含所有組態（除了鍵盤快速鍵）的設定檔，當此設定檔啟用時，VS Code 將套用預設設定檔中的鍵盤快速鍵。

您可以在**內容**區段中瀏覽您要複製的範本或設定檔的內容。每個區段旁邊都有一個**開啟**按鈕，您可以選取它來查看其內容。

Configure, browse and preview profile

在建立新設定檔之前，您可以選取**預覽**按鈕來預覽新設定檔。這會開啟一個新的 VS Code 視窗，並套用新的設定檔。一旦您對預覽滿意，就可以選取**建立**按鈕來建立新的設定檔。

檢查目前設定檔

您可以在 VS Code UI 的多個位置找到 VS Code 視窗目前正在使用的設定檔

  • 在 VS Code 標題列中

  • 當您將滑鼠游標停留在活動列中的**管理**按鈕上時，會在懸停文字中顯示

    如果您已為設定檔設定圖示，此圖示會用作活動列中的**管理**按鈕。請注意，在下列螢幕截圖中，「管理」按鈕現在具有麥克風圖示，表示設定檔已啟用。

    Manage gear displaying icon to indicate that the user's profile is active

    如果您尚未設定圖示，則**管理**齒輪按鈕會顯示一個徽章，其中包含啟用設定檔的前兩個字母，以便您快速檢查正在執行哪個設定檔。

    Manage gear displaying 'DA' to indicate that the user's 'Data Science' profile is active

  • 在設定檔編輯器中

    Showing current profile in the Profiles editor

**注意**：如果您使用的是預設設定檔，則不會顯示設定檔名稱。

設定設定檔

您可以像變更任何 VS Code 組態一樣設定設定檔。您可以安裝/解除安裝/停用擴充功能、變更設定，並調整編輯器的 UI 版面配置（例如，移動和隱藏檢視）。當您套用這些變更時，它們會儲存到您目前啟用的設定檔中。

資料夾與工作區關聯

當您建立或選取設定檔時，它會與目前的資料夾或工作區產生關聯。每當您開啟該資料夾時，工作區的設定檔就會啟用。如果您開啟另一個資料夾，如果已經設定，設定檔會變更為該資料夾的設定檔。

您可以在**設定檔編輯器**的**資料夾與工作區**區段中檢視與設定檔相關聯的資料夾清單。

Folders & Workspaces section

管理設定檔

切換設定檔

您可以使用命令選擇區中的**設定檔：切換設定檔**命令快速切換設定檔，該命令會顯示一個下拉式清單，列出您可用的設定檔。

您也可以在**設定檔編輯器**中，選取您要切換的設定檔旁邊的**將此設定檔用於目前視窗**按鈕來切換設定檔。

Switch profile from the Profiles editor

編輯設定檔

您可以在**設定檔編輯器**中編輯現有設定檔的名稱、圖示和其他組態。

刪除設定檔

您可以從**設定檔編輯器**中，選取您要刪除的設定檔之溢出動作中的**刪除設定檔**按鈕來刪除設定檔。

Delete profile from the Profiles editor

您也可以透過**刪除設定檔**命令來刪除設定檔。**刪除設定檔**下拉式清單可讓您選取要刪除的設定檔。

使用設定檔開啟新視窗

您可以在設定檔編輯器中的「設定檔內容」檢視中，使用**用於新視窗**選項，選擇開啟新的 VS Code 視窗時要使用的設定檔。

Configure custom profile for new window

您可以透過**檔案** > **使用設定檔開啟新視窗**選單，並選取您要使用的設定檔，直接開啟用於特定設定檔的新 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 時。

共用設定檔

匯出

您可以透過在您要匯出的設定檔之溢出動作中，使用**匯出...** 按鈕來匯出設定檔，以供儲存或與他人共用。

Export profile from the Profiles editor

當您選取**匯出...** 時，系統會提示您輸入設定檔名稱，以及是否要匯出至 GitHub gist 或您的本機檔案系統。

儲存為 GitHub gist

將設定檔儲存到 GitHub 後（系統會提示您登入 GitHub），一個對話方塊會提供您**複製連結**選項，以便與他人共用您的設定檔 gist URL。該 URL 包含自動產生的 GUID，格式為https://vscode.dev/editor/profile/github/{GUID}。GitHub gist 會標示為**機密**，因此只有擁有連結的人才能看到該 gist。

如果您啟動設定檔 URL，它會開啟網頁版 VS Code，並開啟設定檔編輯器並顯示匯入的設定檔內容。如果您願意，可以取消選取設定檔元素，如果您想繼續在網頁版 VS Code 中使用該設定檔，則需要手動**安裝擴充功能**（透過下載雲端按鈕）。

您還可以選擇**在 Visual Studio Code 中匯入設定檔**，這會開啟 VS Code 桌面版，並顯示設定檔的內容和一個**匯入設定檔**按鈕。

您可以在 https://gist.github.com/{username} 檢閱您的 gists。從您的 GitHub gist 頁面，您可以重新命名、刪除或複製 gist 的 GUID。

儲存為本機檔案

如果您選擇將設定檔儲存為本機檔案，**儲存設定檔**對話方塊可讓您將檔案放置在您的本機電腦上。設定檔會儲存在副檔名為 .code-profile 的檔案中。

匯入

您可以從**設定檔編輯器**中，透過選取**新增設定檔**按鈕下拉式動作中的**匯入設定檔...** 按鈕來匯入現有設定檔。

Import profile from the Profiles editor

當您選取**匯入設定檔...** 時，系統會透過**匯入設定檔**對話方塊提示您輸入 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 環境和套件。
  • 遠端開發擴充功能套件 - 支援 SSH、WSL 和開發容器。
  • Ruff - 整合 Ruff Python 程式碼檢查器和格式化工具。

此設定檔還會設定以下設定

    "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、環境管理、偵錯、重構。
  • 遠端開發擴充功能套件 - 支援 SSH、WSL 和開發容器。
  • 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
    }

文件撰寫者設定檔範本

文件撰寫者設定檔是撰寫文件的輕量級良好設定。它隨附以下擴充功能

此設定檔還會設定以下設定

    "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 設定檔是所有 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

命令列

您可以透過 --profile 命令列介面選項，使用特定設定檔啟動 VS Code。您在 --profile 引數之後傳遞設定檔名稱，並使用該設定檔開啟資料夾或工作區。下面的命令列會使用「Web 開發」設定檔開啟 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

如果您使用的是預覽版，中間資料夾名稱為 Code - Insiders。

什麼是暫時設定檔？

暫時設定檔是指不會跨 VS Code 工作階段儲存的設定檔。您可以透過命令選擇區中的**設定檔：建立暫時設定檔**命令來建立暫時設定檔。暫時設定檔以空白設定檔開始，並具有自動產生的名稱（例如**暫時 1**）。您可以修改設定檔設定和擴充功能，在您的 VS Code 工作階段期間使用該設定檔，但一旦您關閉 VS Code，它將會被刪除。

如果您想嘗試新的組態或測試擴充功能，而無需修改您的預設或現有設定檔，暫時設定檔會很有用。重新啟動 VS Code 會為您的工作區重新啟用目前設定檔。

我可以從另一個設定檔繼承設定嗎？

目前無法從另一個設定檔繼承設定，也就是您覆寫特定設定並保留其他設定檔的其餘設定。我們正在vscode 儲存庫中追蹤此功能要求。

當您建立新的設定檔時，您可以選擇從另一個設定檔或預設設定檔複製設定。這會在新的設定檔中建立設定的副本，但不會維護與您作為來源使用的設定檔的連結。

如何從我的專案中移除設定檔？

您可以將您的專案設定回預設設定檔。如果您想移除所有設定檔工作區關聯，您可以使用**開發人員：重設工作區設定檔關聯**，這會將目前已指派設定檔的所有本機資料夾設定回預設設定檔。**重設工作區設定檔關聯**不會刪除任何現有的設定檔。

為什麼匯出設定檔時某些設定未匯出？

匯出設定檔時，不包含機器特定的設定，因為這些設定不適用於另一台機器。例如，指向本機路徑的設定不包含在內。

為什麼建立新設定檔時無法使用範本？

設定檔範本由 VS Code 外部託管，您只有在連接到網際網路時才能下載和套用範本。如果您發現設定檔範本不可用，請務必檢查您的網際網路連線。

02/04/2026
English 한국어 中文(简体) 中文(繁體)
© . This site is unofficial and not affiliated with Microsoft.