Visual Studio Codeの「ワークスペース」とは何ですか？

この質問をしているとは信じられませんが、ドキュメントで定義を見つけることができませんでした。ひどく明白ではない場合でも、私は（非常に）Visual Studio Codeを初めて使用します。

たとえば、Visual Studio Codeは、ユーザーレベルとワークスペースレベルでの設定の適用について説明しています。

一方では、

• （a）開いているプロジェクトディレクトリを参照している可能性があります。または
• （b）特定のウィンドウで開いたすべてのことを指す場合があります。

上で参照されたページは言う

"Workspace: These settings are stored inside your workspace
in a .vscode folder and only apply when the workspace is opened."

ワークスペースとは何ですか？

1つ以上のルートフォルダーで構成されるプロジェクトと、そのプロジェクトに属するすべてのVisual Studio Code構成。「ルートフォルダ」は、ファイルシステムの最上位ディレクトリです。これらの構成には、次のようなデータが含まれます。

• そのプロジェクトが開いているときに適用する必要がある設定
• プロジェクトの推奨拡張機能（構成ファイルを同僚と共有する場合に役立ちます）
• プロジェクト固有のデバッグ構成

なぜワークスペースはとても混乱するのですか？

Visual Studio Codeは、UI全体で一貫してこの用語を使用していません（これに対処するためにGitHubの問題を開きました）。上記のようにワークスペースを参照することもあれば、.code-workspaceファイルに具体的に関連付けられているプロジェクトとしてワークスペースを参照することもあります。

最近のファイルウィジェットがその良い例です。リンクされたスクリーンショットで、すべてのプロジェクトが同じ「ワークスペース」の見出しの下にグループ化されていることに注意してください。これは、ワークスペースがすべてあることを示します。ただし、.code-workspaceファイルを含むプロジェクトには「ワークスペース」という接尾辞が付けられ、見出しと矛盾し、それらのファイルのみが実際にワークスペースであることを示します。

.code-workspaceファイルとは何ですか？

上記のすべての構成データと以下に加えて、コメント付き のJSONファイル：

• ワークスペースに属するすべてのルートフォルダの場所

.code-workspaceファイルは必要ですか？

マルチルートワークスペースを作成する場合のみ。マルチルートワークスペースで.code-workspaceは、エクスプローラーに表示するすべてのルートフォルダーを開く単一のファイルがあります（つまり、手動で複数のフォルダーを開く必要はありません）。また、そのワークスペースに適用するすべてのVisual Studio Code設定/構成は、そのワークスペースファイルを開くたびに復元されます。

シングルフォルダープロジェクトはどうですか？

すべてが自動化されています。Visual Studio Codeでフォルダーを開き、現在作業中のプロジェクトに特に関連するエディターに変更を加えると、Visual Studio Codeは自動的に.vscodeフォルダーを作成し、それをプロジェクトフォルダーのルートに保存します再作業。この.vscodeフォルダには、加えた変更を保存するファイルがあります。たとえば、現在のプロジェクトにのみ適用するVisual Studio Code設定を変更した場合、Visual Studio Codeはsettings.jsonそれらの更新を含むファイルを作成し、そのファイルは.vscodeフォルダーに保存されます。

.code-workspace本当に必要な場合は、単一のルートフォルダーだけを含むファイルを作成できます。その後、プロジェクトフォルダーを直接開くか、ワークスペースファイルを開くことができます。しかし、これが有益である理由は何も考えられません。

.code-workspaceファイルを作成するにはどうすればよいですか？

メニューの[ファイル ] → [ ワークスペースに名前を付けて保存... ]を選択します。

ワークスペースにルートフォルダーを追加するにはどうすればよいですか？

メニューの[ファイル ] → [ フォルダをワークスペースに追加... ]に移動します。

.code-workspaceファイルで定義されているワークスペースを開くにはどうすればよいですか？

.code-workspaceファイルをダブルクリックします。Visual Studio Codeは実際のファイルを開きません。代わりに、そのファイルを読み取り、そのワークスペースに属するフォルダーを開きます。または、メニューのファイル → ワークスペースを開く...を選択します。

実際の.code-workspaceファイルを表示するにはどうすればよいですか？

メニューのファイル → 開く...に移動し、対象の.code-workspaceファイルを選択します。または、そのファイルに関連付けられているワークスペースを開き、コマンドパレットを開いて検索し、[ ワークスペース：ワークスペース構成ファイルを開く]コマンドを選択します。

ワークスペースレベルで設定を保存したり、ワークスペースで複数のフォルダを開いたりできます。これらのいずれかを実行する場合は、ワークスペースを使用します。それ以外の場合は、フォルダを開きます。

Visual Studio Codeワークスペースは、プロジェクトのフォルダーとファイルのリストです。ワークスペースには複数のフォルダを含めることができます。ワークスペースの設定とプリファレンスをカスタマイズできます。

ワークスペースは、拡張子が（.code-workspace）の単なるテキストファイルです。テキストエディタで開くことで確認できます。私も、ワークスペースのアイデアと、それがVisual Studio Codeにどのように実装されているかに不満を感じていました。自分に合った方法を見つけました。

単一の「プロジェクト」フォルダから始めます。

Visual Studio Codeを開き、開いているワークスペース、ファイル、またはフォルダーをすべて閉じます。EXPLORERには「OPEN EDITORS」と「NO FOLDER OPENED」のみが表示されます。

メニューバー*→からファイル → フォルダを開きます...。フォルダを配置する場所に移動し、右クリックして新しいフォルダを開きます。任意の名前を付け、[フォルダの選択 ]をクリックします。* Visual Studioコードエクスプローラーに表示されます。

今、メニューからファイル → ワークスペースの保存として...。ワークスペースに名前を付けて、すべてのワークスペースを保持したい場所に保存します（プロジェクトフォルダがある場所とは限りません）。私はすべて「Visual Studio Code workspace」というフォルダに入れました。

これは（.code-workspace）ファイルとして保存され、ハードドライブ上のどこに含まれている（または指している）すべてのファイルとフォルダーのインデックスにすぎません。テキストエディタで開くことで確認できます。作成したフォルダーを閉じ、Visual Studio Codeを閉じます。

ワークスペースの「ファイル」を見つけてダブルクリックします。これにより、ワークスペースに作成したフォルダーでVisual Studio Codeが開きます。または、Visual Studio Codeを開き、「ワークスペースを開く」を使用できます。

Visual Studio Codeワークスペース内から作成したフォルダーは、最初のフォルダー内にあります。最上位のフォルダーをさらに追加する場合は、最初に必要な場所にフォルダーを作成してから、Visual Studio Codeの「ワークスペースに追加...」を使用します。

OPのタイトルとそれに続く質問は次のように要約されているようです。

1. VS Codeのワークスペースとは何ですか？
2. ワークスペース設定はどのように機能しますか？

簡潔な答え：

ワークスペースは、VSCodeで同時に開かれ、.code-workspaceファイルで定義されたフォルダーの仮想コレクションです。このファイルを開くと、フォルダーのコレクションが自動的に開きます。これは「マルチルート」ワークスペースと呼ばれます。

この.code-workspaceファイルは、ワークスペースが開かれているVSCodeのインスタンスによって使用されるワークスペース設定も定義します。

ワークスペースが定義されていない場合、つまり独自にフォルダーを開く場合.vscode\settings.json、そのフォルダー構造のルートにあるファイルに保存される「ワークスペース設定」を作成できます。

さらに詳細に：

VSCodeでは、「ワークスペース」という単語が場所によって少しあいまいに使用されています。最初に検討する用途は、いわゆるマルチルートワークスペースです。

マルチルートワークスペースは、VSCodeのインスタンスでまとめて開かれる一連のフォルダ（「ルート」）です。これらのフォルダが親フォルダを共有する必要はありません。実際、VSCodeは通常、エクスプローラーのサイドバーにある単一のフォルダーを使用するため、これがポイントです。

マルチルートワークスペースは.code-workspace、ワークスペースに含まれるフォルダーのリストとVSCode設定の両方を含む（JSON）ファイルによって定義されます。

• https://code.visualstudio.com/docs/editor/multi-root-workspaces

これらのワークスペース設定について...

[ファイル]> [設定]> [設定]を開くと、設定エディタが表示されます。少なくとも、[ ユーザー設定 ]タブが表示されます。これらは、ローカルマシンのユーザーアカウントに共通のVSCode設定です。Windowsでは、これらはに保存され%APPDATA%\Code\User\settings.jsonます。

• VSコード設定ファイルの場所

個々のフォルダー（多くの場合、ワークスペース内の各「ルート」フォルダー）には.vscode、独自のsettings.jsonファイルを含むフォルダーがあります。ワークスペースの一部としてではなく個別に開いた場合、これらのsettings.jsonファイルのコンテンツは[ワークスペース設定 ]タブに表示され、そのファイルのすべての設定は実行中のVSCodeインスタンスによって使用されます。

マルチルートワークスペースを開くと、動作が異なります。まず、[ ワークスペース設定 ]タブには、.code-workspaceファイルに設定されているオプションが表示されます。次に、settings.jsonファイルのあるフォルダが新しい[フォルダ設定 ]タブに表示されます。マルチルートワークスペースでは、各フォルダの限られた数の設定のみsettings.jsonが使用されることに注意してください。上記のリンクを開いてさらに読むことをお勧めします。

ワークスペース（およびおそらく唯一のワークスペース）の主なユーティリティは、プロジェクトを構成する複数の独立したフォルダーを追加できるようにすることです。例えば：

- WorkspaceProjectX  
-- ApiFolder   (maybe /usr/share/www/api)  
-- DocsFolder  (maybe /home/user/projx/html/docs)  
-- WebFolder   (maybe /usr/share/www/web)

そのため、複数のフォルダウィンドウを開かなくても、特定のプロジェクトのワークスペースでそれらをグループ化できます。

詳細については、こちらをご覧ください。

一部の調査では、答えは（a）のようです。

設定を変更すると、設定ファイルがプロジェクトディレクトリの.vscodeディレクトリに移動します。

Visual Studio Code v1.25.1をインストールしました。Windows 7 Professional SP1マシン。ワークスペースを詳しく理解したかったので、このバージョンのVisual Studio Codeでワークスペースがどのように機能するかを理解するために数時間を費やしました。 私の研究の結果はコミュニティにとって興味深いものになると思いました。

最初に、ワークスペースは、MicrosoftによってVisual Studio Codeドキュメントで「マルチルートワークスペース」と呼ばれています。わかりやすい英語では、「マルチフォルダ（別名「root」）作業環境」を意味します。Visual Studio Codeワークスペースは、単にフォルダーのコレクションであり、必要な任意のコレクションを任意の順序で配置できます。フォルダーの典型的なコレクションは、ソフトウェア開発プロジェクトを構成します。ただし、フォルダーコレクションは、ソフトウェアコードが開発されている他のすべての目的に使用できます。

Visual Studio Codeがワークスペースを処理する方法の背後にあるメカニズムは、少し複雑です。私が学んだことを伝える最も速い方法は、ワークスペースがコンピューターでどのように機能するかを確認するために使用できる一連の指示を与えることです。 Visual Studio Code v1.25.1の新規インストールから始めることを想定しています。Visual Studio Codeの製品版を使用している場合、既存のVisual Studio Code構成の一部またはすべてが失われる可能性があるため、私の指示に従うことはお勧めしません。Visual Studio Code v1.25.1のテストバージョンが既にインストールされており、既存の構成を失っても構わない場合は、次の手順を実行して、Visual Studio Codeを新規インストールの状態に戻す必要があります。

次のフォルダを削除します（存在する場合）。

  C:\Users\%username%\AppData\Roaming\Code\Workspaces (where "%username%" is the name of the currently logged-on user)

Visual Studio Codeにフォルダーを追加して、新しいワークスペースを作成します。この新しいワークスペースの作成に使用する予定のフォルダーのいずれかが以前にVisual Studio Codeで使用されている場合は、新しいワークスペースの作成に使用される各フォルダー内の「.vscode」サブフォルダー（存在する場合）を削除してください。

Visual Studio Codeを起動します。ウェルカムページが表示されたら、閉じます。パネル（水平ペイン）が表示されている場合は、同じ操作を行います。Gitがインストールされていないというメッセージを受け取った場合は、[後で通知する]をクリックします。表示された場合は、デフォルトのコードページとして起動された「無題」のコードページも閉じます。エクスプローラペインが表示されていない場合は、メインメニューの[表示]をクリックし、[エクスプローラ]をクリックしてエクスプローラペインを表示します。エクスプローラーペイン内には、3つのビューヘッダーが表示されます-開いているエディター、開いているフォルダーなし、アウトライン（エクスプローラーペインの一番下にあります）。少なくとも、開いているエディターがあり、フォルダーが開いていないビューヘッダーが表示されていないことを確認してください。

Visual Studio Codeには、「フォルダーを開く」というボタンが表示されます。このボタンをクリックして、任意のフォルダを選択します。Visual Studio Codeが更新され、選択したフォルダーの名前が「開いているフォルダーなし」ビューの名前に置き換わります。選択したフォルダー内に存在するフォルダーとファイルは、ビュー名の下に表示されます。

今すぐVisual Studioのコード開くプリファレンス設定ファイルを。これを行うには多くの方法があります。私は、メニューである覚えておくことが最も簡単に使用しますファイル → 設定 → [設定]。設定ファイルは2つの列に表示されます。左側の列は、すべてのVisual Studio Code機能のデフォルト値の読み取り専用リストです。右側の列には、3種類のユーザー設定が一覧表示されます。テストのこの時点では、ユーザー設定とワークスペース設定の2つのユーザー設定のみが表示されます。デフォルトではユーザー設定が表示されます。これにより、ユーザー設定.jsonファイルの内容が表示されます。このファイルの場所を確認するには、エクスプローラーの[エディターを開く]ビューの下に表示される[ユーザー設定]リストの上にマウスを置きます。OPEN EDITORSビューのこのリストは、右側の列の「ユーザー設定」オプションを選択すると自動的に選択されます。パスは次のようになります。

C:\Users\%username%\AppData\Roaming\Code\User\settings.json

このsettings.jsonファイルは、Visual Studio Codeのユーザー設定が保存される場所です。

次に、設定リストの右側の列にあるワークスペース設定オプションをクリックします。これを行うと、「。vscode」という名前のサブフォルダーが、数ステップ前にエクスプローラーに追加したフォルダーに自動的に作成されます。エクスプローラーでフォルダーの一覧を見て、.vscodeサブフォルダーが追加されていることを確認します。新しい.vscodeサブフォルダー内には、別のsettings.jsonファイルがあります。このファイルには、数ステップ前にエクスプローラーに追加したフォルダーのワークスペース設定が含まれています。

この時点で、ユーザー設定が次の場所に保存されている単一のフォルダーがあります。

C:\Users\%username%\AppData\Roaming\Code\User\settings.json

ワークスペース設定は次の場所に保存されています：

C:\TheLocationOfYourFolder\settings.json

これは、Visual Studio Codeの新規インストールに単一のフォルダーが追加されたときの構成です。2つ目（またはそれ以上）のフォルダーを追加すると、状況が乱雑になります。これは、Visual Studio Codeのユーザー設定とワークスペース設定を変更して、複数のフォルダーに対応するためです。単一フォルダー環境では、上記の2つのsettings.jsonファイルのみが必要です。 ただし、マルチフォルダー環境では、.vscodeサブフォルダーがエクスプローラーに追加された各フォルダーに作成され、新しいファイル「workspaces.json」がマルチフォルダー環境を管理するために作成されます。 新しい「workspaces.json」ファイルは次の場所に作成されます。

c:\Users\%username%\AppData\Roaming\Code\Workspaces\%workspace_id%\workspaces.json

「％workspaces_id％」は、一意のすべて番号の名前を持つフォルダです。

[設定]右側の列に、3つのユーザー設定オプションが表示されます-ユーザー設定、ワークスペース設定、フォルダー設定。ユーザー設定の機能は、単一フォルダー環境の場合と同じです。ただし、ワークスペース設定の背後にある設定ファイルは、単一フォルダーの.vscodeサブフォルダーにあるsettings.jsonファイルから、上記のworkspaces.jsonファイルパスにあるworkspaces.jsonファイルに変更されています。 各フォルダーの.vscodeサブフォルダーにあるsettings.jsonファイルは、3番目のユーザー設定であるフォルダーオプションによって制御されるようになりました。 これは、各フォルダーの.vscodeサブフォルダーにある各フォルダーのsettings.jsonファイルの管理を可能にするドロップダウン選択リストです。注：.vscodeサブフォルダーは、新しく追加されたフォルダーがフォルダーオプションのユーザー設定で少なくとも1回選択されるまで、新しく追加されたエクスプローラーフォルダーに作成されません。

Explorerの単一フォルダー名が「UNTITLED（WORKSPACE）」に変更されていることに注意してください。これは次のことを示しています。

1. マルチフォルダワークスペースは、「タイトルなし（ワークスペース）」という名前で作成されています。
2. ワークスペースは「UNTITLED（WORKSPACE）」という名前で、ワークスペースが個別の一意のワークスペースファイルとしてまだ保存されていないことを伝えます。
3. UNTITLED（WORKSPACE）ワークスペースには、フォルダーを追加および削除できますが、Visual Studio Codeの唯一のワークスペース環境として機能します

Visual Studio Codeワークスペースのすべての機能は、ワークスペースが必要に応じて再読み込みできるファイルとして保存されている場合にのみ実現されます。これにより、独自のマルチフォルダーワークスペース（プロジェクトなど）を作成し、後で使用できるようにファイルとして保存できます。これを行うには、[ ファイル ] → [ ワークスペースに名前を付けて保存 ]を選択します。メインメニューから、現在のワークスペース構成を一意のワークスペースファイルとして保存します。「ゼロから」ワークスペースを作成する必要がある場合は、まず現在のワークスペース構成を保存し（必要な場合）、各エクスプローラーのフォルダー名を右クリックして[ワークスペースからフォルダーを削除]をクリックします。すべてのフォルダーがワークスペースから削除されたら、新しいワークスペースに必要なフォルダーを追加します。新しいフォルダの追加が完了したら、新しいワークスペースを新しいワークスペースファイルとして保存するだけです。

重要な注意 -Visual Studio Codeは、エクスプローラーにフォルダーが1つしか残っていない場合、または新しいワークスペースを「最初から」作成するときにすべてのフォルダーがエクスプローラーから削除されている場合、単一フォルダーモードに「戻りません」。3つのユーザー設定を利用するマルチフォルダーワークスペース構成は引き続き有効です。つまり、この投稿の冒頭の指示に従わない限り、Visual Studio Codeをシングルフォルダーモードの操作に戻すことはできません。常にマルチフォルダーワークスペースモードのままになります。

彼らはこれをマルチルートワークスペースと呼び、次の理由でデバッグを簡単に行うことができます。

「マルチルートワークスペースの場合、Visual Studio Codeはすべてのフォルダーでlaunch.jsonデバッグ構成ファイルを検索し、フォルダー名をサフィックスとして表示します。」

アプリケーションフォルダー内にサーバーとクライアントフォルダーがあるとします。それらを一緒にデバッグする場合は、ワークスペースなしで、サーバー用とクライアント用の2つのVisual Studio Codeインスタンスを開始する必要があり、前後に切り替える必要があります。

しかし、現在（1.24）は、ワークスペースに1つのファイルを追加することはできません。フォルダのみを追加することは、少し不便です。

そのため、プロジェクトのソースツリーを、そのプロジェクトに直接関連しないアーティファクトで汚染しないというレッスンは無視されています。

あるゼロのVisual Studioのコードワークスペースファイル（workspaces.json）またはディレクトリ（.vscode）または任意のソースツリーに配置する理由は。それはあなたのユーザー設定の下に置かれるのと同じくらい簡単でした。

これは20年以上前にわかったと思いましたが、一部のレッスンは繰り返される運命にあるようです。

「ワークスペースとは何ですか？」

だから、私はこの混乱のためにここに上陸するすべての人々を助けるために、VS Code（私のものではない）のための次のプラグイン、「Project Manager」を投稿したいと思いました：https : //marketplace.visualstudio.com/items?itemName=alefragnani 。プロジェクトマネージャ

これには、単一フォルダーのプロジェクトを管理（保存および開く）するための素晴らしいUIがあります。

プロジェクトを保存：

パレットでプロジェクトを開く：

ステータスバーに現在のプロジェクトを表示します（クリックしてプロジェクトパレットを開きます）。

サイドバーのプロジェクトにアクセスします。

2018年5月の時点で、Visual Studio Codeのワークスペースを使用すると、異なるが関連するプロジェクトにすばやくアクセスできるようです。別のフォルダを開く必要がないすべて。

また、複数のワークスペースを持つこともできます。ここで参考文献を参照すると、その全体像がわかります。

リファレンス1
リファレンス2

Visual Studio Codeが新規インストールの場合。

1. 拡張機能をクリックし、「python」を検索して、インストールをクリックします

2. ビューをクリック->エクスプローラーフォルダーがない場合、ワークスペースにフォルダーを追加します（ファイル->ワークスペースにフォルダーを追加）

3. 仮想Python環境を使用する場合は、[ファイル]-> [設定]-> [設定]をクリックします。

ウィンドウの右上隅にある「{} open settings JSON」をクリックして、仮想環境にあるpython.exeファイルへのパスを追加します

{
    "python.pythonPath": "C:\\PathTo\\VirtualENV\\python.exe"
}

4. 新しいターミナルを起動し、正しいPythonインタープリターが選択されていることを確認します

テストプロジェクトまたはメインプロジェクトに追加する機能のために、新しいディレクトリを作成して新しいVisual Studioコードウィンドウを開く必要がありますか？では、ワークスペースと十分なCPU使用率が必要です...

他のすべての回答に加えて、Visual Studio Codeでのワークスペースの一般的な使用法について言及したいと思います。