【簡単？詳細！】VS CodeでSwift開発環境を整える手順の完全ガイド

はじめに

Swiftは、Appleによって開発された強力で直感的なプログラミング言語です。iOS、macOS、watchOS、tvOSといったAppleプラットフォーム向けのアプリケーション開発はもちろんのこと、サーバーサイド開発、Linux上でのCLIツール開発など、その活躍の場は広がり続けています。Swift開発の主要な開発環境として、macOS上で提供される統合開発環境（IDE）であるXcodeが広く知られていますが、近年ではクロスプラットフォーム対応が進み、LinuxやWSL（Windows Subsystem for Linux）上のWindows環境でもSwift開発が可能になっています。

こうしたクロスプラットフォーム化の波と並行して、特定のOSやプロジェクトに縛られない軽量かつ高機能なコードエディタとして、Visual Studio Code（VS Code）の人気が高まっています。VS Codeは、豊富な拡張機能のエコシステムによって、様々なプログラミング言語に対応できる柔軟性を持っています。では、このVS Codeを使ってSwift開発環境を構築するには、どのような手順が必要なのでしょうか？

この記事では、VS Codeをメインエディタとして利用し、Swift開発環境を構築するための詳細な手順を、macOS、Linux、そしてWSL上のWindowsといった主要なプラットフォーム別に網羅的に解説します。単に手順を追うだけでなく、なぜその手順が必要なのか、それぞれの設定が何を意味するのか、そして遭遇しうる問題への対処法についても詳しく説明します。この記事を読めば、VS Codeで快適なSwift開発を始めるための準備が整うはずです。

なぜVS CodeでSwift開発なのか？

Xcodeは確かにmacOS上のSwift開発において強力なIDEですが、以下のような理由からVS Codeを検討する価値は十分にあります。

クロスプラットフォーム: Swift自体がmacOS以外でも動作するようになったため、LinuxやWindows (WSL経由) でも開発したいというニーズがあります。VS CodeはこれらのOSでネイティブに動作し、Remote Development拡張機能を使えばWSLやリモートサーバー上での開発もシームレスに行えます。
軽量で高速: Xcodeと比較して、VS Codeは起動が速く、リソース消費も少ない傾向があります。普段使いのテキストエディタに近い感覚で利用できます。
豊富な拡張機能: Swift開発だけでなく、様々な言語や技術を扱う開発者にとって、VS Codeは多機能な統一環境として非常に便利です。Git連携、ターミナル統合、様々なLinterやFormatterとの連携など、開発効率を高める機能が豊富です。
カスタマイズ性: キーバインド、UIテーマ、エディタの動作など、細部にわたって自分の好みに合わせてカスタマイズできます。
SwiftPMとの親和性: サーバーサイドSwiftやCLIツール開発で標準的に使われるSwift Package Manager (SwiftPM) はコマンドラインツールであり、VS Codeの統合ターミナルやタスク機能との相性が良いです。

一方で、VS CodeでのSwift開発は、Xcodeのような統合的なGUIツール（Storyboardエディタ、Interface Builder、Instruments、Asset Catalog管理など）や、特定のプラットフォーム（iOS/macOSアプリ）向けの専用ビルド・デバッグ機能（シミュレータ、実機デバッグプロビジョニングなど）は提供しません。そのため、主にサーバーサイドSwift、CLIツール、ライブラリ開発、またはUI開発以外のロジック部分の開発に適しています。GUIアプリケーション開発の場合でも、UI設計以外はVS Codeで行い、ビルドやデバッグの一部をXcodeで行う、といった連携は可能です。

この記事の目的

この記事は、以下のゴールを達成することを目指します。

VS Codeと必要なツールをインストールし、Swift開発が可能な状態にする。
Swift Language Serverを活用し、コード補完やエラー表示などの基本的なエディタ機能を利用できるようにする。
Swift Package Manager (SwiftPM) プロジェクトをVS Codeで扱い、ビルド、実行、テストを実行できるようにする。
CodeLLDB拡張機能を用いて、VS Code上でSwiftコードのデバッグができるようにする。
LintツールやFormatterツールを導入し、コード品質の向上を図る。
各プラットフォーム（macOS, Linux, Windows/WSL）における環境構築の具体的な違いを理解する。

対象読者

VS Codeを普段使っており、Swift開発もVS Codeで行いたいと考えている開発者。
macOS以外の環境（Linux, Windows/WSL）でSwift開発を始めたい開発者。
Xcode以外の選択肢として、より軽量で柔軟な開発環境を探している開発者。
Swift Package Managerベースの開発に関心がある開発者。

必要なもの

VS Codeをインストールするコンピュータ
インターネット接続環境
(Windowsの場合) WSL2がセットアップされた環境 (推奨)

それでは、早速環境構築の手順に入りましょう。

1. Swift開発環境の基本

VS Codeでの開発環境構築に入る前に、Swift開発そのものに必要な基本的な要素を理解しておきましょう。

1.1 Swiftとは？

Swiftはモダンで強力な、そして比較的学習しやすいプログラミング言語です。安全性、パフォーマンス、そして表現力に重点が置かれています。CやObjective-Cとの相互運用性も高く、既存のコード資産を活用しながら新しい開発を進めることができます。

1.2 Swiftのコンパイラ・ツールチェイン

Swiftコードを実行可能なプログラムやライブラリにするためには、コンパイラが必要です。Swift開発には、コンパイラである swiftc をはじめ、パッケージ管理を行う swift コマンド（SwiftPM）、デバッガー（LLDB）、ソースコード解析ツール（SourceKit）など、一連のツール群が必要になります。これらをまとめて「Swiftツールチェイン」と呼びます。

主要なツールチェインの構成要素：

swiftc: Swiftコンパイラ本体。ソースコードを機械語などに変換します。
swift: Swift Package Manager (SwiftPM) のコマンドラインインターフェース。パッケージの作成、依存関係の管理、ビルド、実行、テストなどを担います。VS CodeでSwift開発を行う場合、このコマンドを頻繁に使用します。
lldb: 低レベルのデバッガー。プログラムの実行を一時停止させたり、変数の内容を確認したり、ステップ実行したりするために使われます。VS Codeのデバッグ機能はこのLLDBを利用します。
SourceKit: ソースコード解析エンジン。エディタのコード補完、シンボル定義へのジャンプ、エラー・警告表示などのインテリジェンス機能を提供します。VS CodeのSwift拡張機能は、このSourceKitをベースにしたLanguage Server Protocol (LSP) 実装であるSourceKit-LSPを利用します。

1.3 Swiftツールチェインの入手・インストール方法

Swiftツールチェインの入手方法は、利用するOSによって異なります。

macOSの場合

macOSでは、Swiftツールチェインは通常、Xcodeに同梱されています。Xcodeをインストールするのが最も一般的で簡単な方法です。

Xcodeのインストール: App StoreからXcodeをインストールします。Xcodeには最新版のSwiftツールチェインが含まれています。
Swift.orgからインストール: Xcodeを使わずに、特定のバージョンのSwiftツールチェインだけをインストールすることも可能です。Swift.orgのダウンロードページから .pkg ファイルをダウンロードして実行します。これにより、/Library/Developer/Toolchains/ ディレクトリ以下にツールチェインがインストールされます。
ツールチェインの切り替え: 複数のツールチェインがインストールされている場合、xcode-select コマンドでアクティブなツールチェインを切り替えることができます。
- xcode-select --install: Xcode Command Line Toolsがインストールされていない場合に実行します。
- xcode-select --print-path: 現在アクティブな開発者ディレクトリ（通常はXcodeのDeveloperディレクトリ）を表示します。
- xcode-select --switch <path>: 指定したパスにある開発者ディレクトリをアクティブにします。例えば、/Library/Developer/Toolchains/Swift-5.x.x-RELEASE.xctoolchain のようなパスを指定することで、Xcode同梱ではないツールチェインを使うことができます。

Linuxの場合

LinuxでもSwiftは公式にサポートされており、Swift.orgから特定のバージョンのバイナリディストリビューションをダウンロードしてインストールするのが一般的です。パッケージマネージャー経由でのインストールも可能な場合がありますが、公式の方法としてはバイナリのダウンロードが推奨されています。対応しているLinuxディストリビューション（Ubuntu, CentOSなど）のバージョンに注意が必要です。

典型的なインストール手順（Ubuntuを例に）：

依存関係のインストール: Swiftツールチェインが動作するために必要なライブラリやツールをインストールします。
bash sudo apt update sudo apt install -y clang libicu-dev libpython3.dev libcurl4 libxml2 libz3-dev libssl-dev libsqlite3-dev libncurses5-dev libncursesw5-dev libedit-dev libasan6 libtsan0 libatomic1 libuuid1 libdispatch5 libobjc4
必要な依存関係はSwiftのバージョンやLinuxのディストリビューションによって異なる場合があるため、公式ドキュメントを確認してください。
ツールチェインのダウンロード: Swift.orgのダウンロードページから、利用したいSwiftのバージョンとLinuxディストリビューションに対応した .tar.gz ファイルをダウンロードします。
アーカイブの展開: ダウンロードしたファイルを任意のディレクトリに展開します。例えば、ホームディレクトリの ~/swift ディレクトリに展開する場合：
bash mkdir ~/swift cd ~/swift tar xzf /path/to/downloaded/swift-5.x.x-RELEASE-ubuntuXX.xx.tar.gz
環境変数 PATH の設定: 展開したツールチェイン内の usr/bin ディレクトリにパスを通します。これにより、どのディレクトリからでも swift や swiftc コマンドが実行できるようになります。.bashrc や .zshrc などのシェルの設定ファイルに以下の行を追加します（~/swift/swift-5.x.x-RELEASE-ubuntuXX.xx は展開先のディレクトリパスに合わせて変更してください）。
bash export PATH=~/swift/swift-5.x.x-RELEASE-ubuntuXX.xx/usr/bin:"${PATH}"
設定ファイルを保存した後、シェルを再起動するか、source ~/.bashrc などで設定を反映させます。

Windowsの場合

WSL2のインストール: Microsoftの公式ドキュメントに従って、WSL2とLinuxディストリビューション（例: Ubuntu）をインストール・セットアップします。
WSL2内でLinux向け手順を実行: WSL2で起動したLinux環境上で、上記の「Linuxの場合」と同じ手順でSwiftツールチェインをインストールします。

実験的ながら、Swift.orgではWindowsネイティブで動作するツールチェインも提供されていますが、こちらは開発段階であり、依存関係の解決やVS Codeからの利用において現時点ではWSL2上のLinux環境の方が安定して容易であるため、WSL2+Linuxの方法を強く推奨します。

1.4 Swiftバージョンの確認

ツールチェインのインストールが完了したら、正しくパスが通っているか、意図したバージョンのSwiftが利用できるかを確認しましょう。

bash swift --version

このコマンドを実行して、インストールしたSwiftのバージョン情報が表示されれば、Swiftツールチェインのインストールは成功です。

2. VS Codeの準備

Swiftツールチェインの準備ができたら、次にVS Code自体の準備を行います。

2.1 VS Codeのインストール

VS Codeは公式ウェブサイトから無料でダウンロードできます。利用しているOS（macOS, Windows, Linux）に合わせて適切なインストーラーをダウンロードし、指示に従ってインストールしてください。

VS Code 公式ダウンロードページ

2.2 VS Codeの基本的な使い方

VS Codeは非常に多機能なエディタですが、Swift開発を行う上で最低限知っておくべき基本的な機能を紹介します。

エクスプローラー (Explorer): 左側のサイドバーにあるアイコン。ファイルやフォルダの構造を表示し、ファイルを開いたり作成したりできます。
検索 (Search): サイドバーの虫眼鏡アイコン。プロジェクト内の文字列を検索したり置換したりできます。
ソース管理 (Source Control): サイドバーの分岐アイコン。Gitなどのバージョン管理システムと連携し、変更の追跡、コミット、プッシュなどを行えます。SwiftPMプロジェクトは通常Gitで管理されるため、この機能は非常に便利です。
実行とデバッグ (Run and Debug): サイドバーの再生ボタンと虫アイコン。プログラムの実行、ブレークポイント設定、ステップ実行、変数監視など、デバッグを行うためのインターフェースです。後述するlaunch.jsonと連携します。
拡張機能 (Extensions): サイドバーの四角形アイコン。VS Codeの機能を拡張するアドオンを検索、インストール、管理できます。Swift開発に必須となる拡張機能はここでインストールします。
コマンドパレット (Command Palette): Cmd+Shift+P (macOS) または Ctrl+Shift+P (Windows/Linux) で開きます。VS Codeのあらゆるコマンドを実行できる便利なインターフェースです。「Show All Commands」で全てのコマンドを一覧表示できます。拡張機能の機能などもここから実行することが多いです。
統合ターミナル (Integrated Terminal): Ctrl+~ (Windows/Linux) または Cmd+~ (macOS) で開きます。VS Code内でコマンドライン操作ができます。SwiftPMコマンド（swift build, swift run, swift testなど）を実行する際に非常に便利です。デフォルトのシェルはOSの設定に基づきます。

2.3 VS Codeでの開発ワークフローの紹介

VS CodeでのSwift開発は、主に以下の要素を連携させて行います。

エディタ: ソースコードの記述、編集を行います。VS Codeの強力なコード補完、シンボルジャンプ、構文強調、エラー表示などの機能が開発効率を高めます。これは、Swift拡張機能とSwift Language Server (SourceKit-LSP) の連携によって実現されます。
統合ターミナル: SwiftPMコマンドを実行して、プロジェクトのビルド、実行、テストを行います。また、Gitコマンドなどもここから実行できます。
デバッグ機能: CodeLLDB拡張機能とlaunch.jsonの設定を利用して、プログラムにブレークポイントを設定し、実行中の状態を検査します。
拡張機能: Swift Language Server、デバッガー連携、Linter、Formatterなど、開発に必要な追加機能を提供します。

これらの要素をVS Codeという単一のアプリケーション内でシームレスに行き来しながら開発を進めるのが、VS Codeを用いた開発スタイルです。

3. VS CodeにおけるSwift開発のための拡張機能

VS CodeをSwift開発に最適化するためには、いくつかの重要な拡張機能をインストールする必要があります。

3.1 必須の拡張機能

Swift (vscode-swift)

この拡張機能は、VS CodeでSwift開発を行う上での中核となります。Swift Language Server (SourceKit-LSP) と連携し、以下の機能を提供します。

コード補完 (IntelliSense): 入力中のコードに対して、クラス名、メソッド名、変数名などを提案します。
定義へ移動 (Go to Definition): シンボルの定義元にジャンプします。
定義のプレビュー (Peek Definition): カーソル位置のシンボル定義をその場でプレビューします。
参照の検索 (Find All References): シンボルがコードのどこで使用されているかを検索します。
シンボルの名前変更 (Rename Symbol): 変数名や関数名などを、コード全体で安全に変更します。
型の情報表示 (Hover Information): カーソルをシンボルに重ねると、その型やドキュメントコメントが表示されます。
診断 (Diagnostics): コンパイルエラーや警告をリアルタイムで表示します。問題のある箇所には波線が表示され、Problemsパネルに一覧表示されます。
ドキュメントコメント: ドキュメントコメント (///, /** */) を表示したり、入力補完したりします。

インストール方法:

VS Codeを開きます。
左側のサイドバーにある拡張機能アイコン (四角形が4つ並んだアイコン) をクリックします。
検索ボックスに Swift と入力します。
検索結果から Swift という名前の拡張機能（通常は公式または推奨として表示されます）を見つけ、「Install」ボタンをクリックします。

インストール後、VS Codeを再起動することが推奨されます。

設定:

Swift拡張機能は、通常、システムにインストールされているアクティブなSwiftツールチェインを自動的に検出して利用します。しかし、特定のツールチェインを指定したい場合や、Language Serverの挙動を調整したい場合は、VS Codeの設定（File -> Preferences -> Settings または Code -> Preferences -> Settings）で swift と検索して設定項目を変更できます。

例えば、使用するSwiftツールチェインのパスを明示的に指定したい場合は、Swift: Toolchain Path 設定を利用します。これは、複数のSwiftツールチェインがインストールされている環境や、標準的ではない場所にインストールした場合に役立ちます。

CodeLLDB

SwiftコードをVS Code上でデバッグするためには、CodeLLDB拡張機能が必須です。CodeLLDBは、LLDBデバッガーとVS Codeのデバッグインターフェースを連携させます。

インストール方法:

VS Codeを開きます。
左側のサイドバーにある拡張機能アイコンをクリックします。
検索ボックスに CodeLLDB と入力します。
検索結果から CodeLLDB という名前の拡張機能を見つけ、「Install」ボタンをクリックします。

インストール後、VS Codeを再起動することが推奨されます。

CodeLLDBは、システムの lldb コマンドを自動的に検出して使用します。Swiftツールチェインに含まれる lldb が利用されるため、Swiftツールチェインが正しくインストールされ、パスが通っていることが重要です。

3.2 その他の便利な拡張機能

SwiftLint: Swiftコードのスタイルや規約をチェックするツール「SwiftLint」との連携を強化する拡張機能です。VS Code上でリアルタイムにLint結果を表示したり、コードフォーマットを実行したりできます。SwiftLint自体は別途インストールが必要です（後述）。
SwiftFormat: Swiftコードを自動的にフォーマットするツール「SwiftFormat」との連携を強化する拡張機能です。保存時に自動的にフォーマットしたり、コマンドパレットから実行したりできます。SwiftFormat自体は別途インストールが必要です（後述）。
Docker: Swift開発をDockerコンテナ内で行う場合に便利な拡張機能です。
Remote – SSH / Remote – WSL: リモートサーバー上の環境や、Windows上のWSL環境で、あたかもローカルで開発しているかのようにVS Codeを利用するための拡張機能です。Windows + WSLでSwift開発を行う場合は、このRemote – WSL拡張機能を利用することが強く推奨されます。

これらの拡張機能も、VS Codeの拡張機能ビューで名前を検索してインストールできます。

4. SwiftToolchainのインストールと設定 (プラットフォーム別詳細)

前述の基本的な説明に加え、各プラットフォームでのツールチェインインストールについて、より詳細な手順と注意点を解説します。

4.1 macOSでのインストールと設定の詳細

macOSでSwift開発を行う場合、主にXcodeをインストールする方法と、Swift.orgからツールチェインをダウンロードする方法があります。

方法1: Xcodeをインストールする (最も簡単)

手順: App Storeを開き、「Xcode」を検索してインストールします。非常に容量が大きい（数GB）ですが、macOS/iOSアプリ開発に必要な全てのツールと、最新版のSwiftツールチェインが含まれています。
利点:
- Swiftツールチェインが自動的にインストールされ、システムに認識されます。
- Command Line Toolsも自動的にインストールされるか、必要に応じてインストールを促されます。
- 後述するSwift拡張機能やCodeLLDBは、Xcodeに同梱されているツールチェインを自動的に検出して利用します。
注意点: XcodeはmacOSの最新バージョンに近いものでないとインストールできない場合があります。また、単にSwiftのCLIツールやサーバーサイド開発だけを行いたい場合でも、大容量のXcode全体をインストールする必要があります。
確認: Xcodeインストール後、ターミナルで swift --version を実行し、バージョンが表示されるか確認します。また、xcode-select --print-path でXcodeの開発者ディレクトリ (/Applications/Xcode.app/Contents/Developer) が表示されることを確認します。

方法2: Swift.orgからツールチェインをインストールする

特定のSwiftバージョンを使いたい場合や、Xcodeをインストールしたくない場合に利用します。

手順:
1. Swift.orgのダウンロードページ (https://www.swift.org/download/) を開きます。
2. macOS向けの、利用したいSwiftバージョンとReleaseタイプ（例えば、「Swift 5.9.2 Release」）を選択します。
3. 「macOS」セクションにある「macOS (x86_64)」または「macOS (ARM64)」(.pkgファイル) をダウンロードします。利用しているMacのCPUアーキテクチャに合わせて選択してください（Intel Macならx86_64、Apple Silicon MacならARM64）。
4. ダウンロードした .pkg ファイルを実行し、インストーラーの指示に従ってインストールします。デフォルトでは /Library/Developer/Toolchains/ ディレクトリ以下にインストールされます。
5. アクティブなツールチェインの設定: インストールしたツールチェインをVS Codeやターミナルで利用するためには、xcode-select コマンドでそのツールチェインをアクティブに設定する必要があります。
  bash sudo xcode-select --switch /Library/Developer/Toolchains/Swift-5.x.x-RELEASE.xctoolchain
  (Swift-5.x.x-RELEASE.xctoolchain の部分は、インストールされたツールチェインの正確なディレクトリ名に置き換えてください。)
利点: XcodeをインストールせずにSwift開発環境を構築できます。特定のSwiftバージョンを厳密に管理したい場合に便利です。
注意点: xcode-select で切り替えたツールチェインは、Xcode自体からも利用される開発者ツール（git, make など）のパスにも影響を与える可能性があります。複数のツールチェインを頻繁に切り替えたい場合は、後述するVS Codeの設定でツールチェインパスを固定するか、direnvのようなツールを利用する方が管理しやすい場合があります。
確認: ターミナルで swift --version を実行し、xcode-select で指定したバージョンの情報が表示されるか確認します。

4.2 Linuxでのインストールと設定の詳細 (Ubuntuを例に)

Linux上でSwiftをインストールする場合、Swift.orgから公式バイナリをダウンロード・展開し、パスを設定するのが最も信頼できる方法です。

手順:
1. 依存関係の確認とインストール: 利用しているLinuxディストリビューションとSwiftのバージョンに必要な依存関係を確認します。公式ドキュメントのダウンロードページに記載されています。Ubuntuの場合、前述のapt installコマンドで必要なパッケージをインストールします。
  bash sudo apt update sudo apt install -y clang libicu-dev libpython3.dev libcurl4 libxml2 libz3-dev libssl-dev libsqlite3-dev libncurses5-dev libncursesw5-dev libedit-dev libasan6 libtsan0 libatomic1 libuuid1 libdispatch5 libobjc4 # その他の必要な依存関係も確認し、インストール
2. ツールチェインのダウンロード: Swift.orgのダウンロードページから、利用したいSwiftバージョンとLinuxディストリビューション（例: Ubuntu 22.04）に対応した .tar.gz ファイルをダウンロードします。適切なアーキテクチャ（x86_64）を選択します。
3. アーカイブの展開: ダウンロードしたファイルを任意のディレクトリに展開します。よく使われるのは /opt/swift やホームディレクトリ以下などです。システム全体で利用可能にしたい場合は /opt 以下に展開し、root権限で行います。
  bash # 例えば、/opt に展開する場合 sudo mkdir /opt/swift cd /opt/swift sudo tar xzf /path/to/downloaded/swift-5.x.x-RELEASE-ubuntuXX.xx.tar.gz --strip-components=1 # --strip-components=1 は、アーカイブ内の最上位ディレクトリを取り除くオプションです。 # これにより、/opt/swift/usr/bin/... のような構造になります。
  ホームディレクトリに展開する場合、--strip-components=1 を使用しない方が管理しやすいかもしれません。その場合、パスの設定時に展開されたルートディレクトリを含めます。
4. 環境変数 PATH の設定: 展開したツールチェインの usr/bin ディレクトリにパスを通します。この設定は、ユーザー単位で行うのが一般的です。使用しているシェルの設定ファイル（.bashrc, .zshrc など）を開き、以下の行を追加します。
  bash # ~/.bashrc または ~/.zshrc を編集 export SWIFT_TOOLCHAIN_PATH="/opt/swift" # 展開先のパスに合わせて変更 export PATH="$SWIFT_TOOLCHAIN_PATH/usr/bin:$PATH"
  変更を保存した後、新しいターミナルセッションを開始するか、設定ファイルを再読み込みします。
  bash source ~/.bashrc # または ~/.zshrc
利点: Linux上でSwift開発が可能です。サーバーサイド開発やCLIツール開発に適しています。
注意点: 依存関係のインストールが必要です。SwiftのバージョンやLinuxディストリビューションのバージョンによって必要な依存関係が異なるため、公式ドキュメントの確認は必須です。システム全体にインストールする場合はroot権限が必要になります。パスの設定を誤ると、Swiftコマンドが認識されません。
確認: 新しいターミナルを開き、swift --version を実行してバージョンが表示されるか確認します。which swift コマンドで、設定したパスのSwiftバイナリが選択されているか確認することも有効です。

4.3 Windowsでのインストールと設定の詳細 (WSL2 + Ubuntuを推奨)

WindowsでのSwift開発は、WSL2とLinux環境を組み合わせるのが最も現実的で推奨される方法です。

手順:
1. WSL2のインストールとUbuntuのセットアップ: Microsoftの公式ドキュメントに従って、WSL2をインストールし、UbuntuなどのLinuxディストリビューションをセットアップします。Microsoft StoreからUbuntuをインストールするのが簡単です。
2. WSL2上でLinux環境を設定: WSL2でインストールしたUbuntuを起動します。このUbuntu環境は、独立したLinuxシステムとして動作します。
3. Ubuntu上でSwiftツールチェインをインストール: 前述の「Linuxの場合」の手順に従って、WSL2上のUbuntu環境にSwiftツールチェインをインストールします。依存関係のインストール、バイナリのダウンロード・展開、PATH 環境変数の設定などを行います。これらの作業は全てWSL2のUbuntuターミナル上で行います。
4. VS Code Remote – WSL拡張機能のインストール: Windows上のVS Codeに「Remote – WSL」拡張機能をインストールします（前述の「その他の便利な拡張機能」を参照）。
5. WSL内のフォルダをVS Codeで開く: Windows上のVS Codeから、コマンドパレット (Ctrl+Shift+P) を開きます。「Remote-WSL: New Window」または「Remote-WSL: Open Folder in WSL…」を選択し、WSL2内のプロジェクトフォルダや作業フォルダを開きます。初めてWSL内のフォルダを開く際は、VS CodeサーバーがWSL内にインストールされます。
6. VS Code拡張機能のインストール (WSL環境): WSL内のフォルダをVS Codeで開くと、VS CodeはWSL環境で動作します。この環境向けに、Swift開発に必要な拡張機能（Swift、CodeLLDBなど）をインストールする必要があります。拡張機能ビューを開くと、「Install in WSL: Ubuntu」のようなボタンが表示されるので、それをクリックしてインストールします。WSL環境で拡張機能が有効になると、拡張機能のアイコンに「WSL」と表示されるようになります。
利点: Windows上でLinuxのSwift環境を利用できます。ネイティブWindows版Swiftよりも安定しており、Linux向けの情報やツールがそのまま使えます。VS CodeのRemote – WSL機能により、WindowsのGUIを使いながらWSL内のファイルシステムやツールを利用できます。
注意点: WSL2のセットアップが必要です。WindowsネイティブでのSwift開発ではありません（WSLという仮想化環境内）。ファイルの扱いでWindows側とWSL側でパフォーマンスの違いが生じることがあります。
確認: VS CodeでWSL内のSwiftプロジェクトフォルダを開き、統合ターミナルを開きます（ターミナル上部に「WSL: Ubuntu」のように表示されます）。そこで swift --version を実行し、バージョンが表示されるか確認します。VS CodeのSwift拡張機能がWSL環境にインストールされていることを確認します。

5. VS CodeでのSwiftプロジェクト作成と基本操作

SwiftツールチェインとVS Code、必要な拡張機能の準備ができたら、実際にプロジェクトを作成して基本操作を試してみましょう。

5.1 SwiftPMプロジェクトの作成

VS CodeでSwift開発を行う場合、Swift Package Manager (SwiftPM) を利用したプロジェクト構造が標準的です。SwiftPMは、プロジェクトのビルド、実行、テスト、依存関係管理を一元的に行うためのツールです。

VS Codeの統合ターミナルを開き、プロジェクトを作成したいディレクトリに移動して、以下のコマンドを実行します。

“`bash

プロジェクト用のディレクトリを作成

mkdir MySwiftProject
cd MySwiftProject

SwiftPMプロジェクトを初期化

タイプを指定しないとexecutable (実行可能形式) がデフォルト

swift package init –type executable # 実行可能なCLIツールを作成する場合

swift package init –type library # 再利用可能なライブラリを作成する場合

swift package init # デフォルト（executable）

“`

このコマンドを実行すると、MySwiftProject ディレクトリ内にSwiftPMプロジェクトの基本的なファイル構造が作成されます。

作成される主なファイルとディレクトリ:

Package.swift: パッケージマニフェストファイル。プロジェクト名、ターゲット、依存関係などが記述されます。SwiftPMはこのファイルを読み込んでプロジェクトを管理します。
Sources/: ソースコードを配置するディレクトリ。
- Sources/MySwiftProject/: 実行可能ターゲットのソースコードディレクトリ。
- Sources/MyLibrary/: ライブラリターゲットのソースコードディレクトリ（ライブラリタイプの場合）。
Tests/: テストコードを配置するディレクトリ。
- Tests/MySwiftProjectTests/: 実行可能ターゲットのテストコードディレクトリ。
- Tests/MyLibraryTests/: ライブラリターゲットのテストコードディレクトリ（ライブラリタイプの場合）。
.gitignore: Gitが追跡しないファイルを指定するファイル。.build/ など、ビルド生成物がデフォルトで無視されるように設定されています。

実行可能形式 (--type executable) で初期化した場合、Sources/MySwiftProject/main.swift というファイルが作成され、簡単なサンプルコード (print("Hello, world!")) が含まれています。

5.2 VS Codeでプロジェクトを開く

作成したSwiftPMプロジェクトディレクトリをVS Codeで開きます。

VS Codeを開きます。
File -> Open Folder... を選択します。
作成したプロジェクトディレクトリ (MySwiftProject) を選択して開きます。

WSL上でプロジェクトを作成した場合は、VS Code Remote – WSL拡張機能を利用して、WSL内のプロジェクトディレクトリを開いてください（前述の「Windowsでのインストールと設定の詳細」を参照）。

プロジェクトフォルダを開くと、VS Codeのエクスプローラーにプロジェクトのファイル構造が表示されます。

5.3 Swift拡張機能によるLanguage Serverの起動と連携確認

プロジェクトフォルダを開くと、VS CodeのSwift拡張機能が自動的にアクティブになり、Swift Language Server (SourceKit-LSP) を起動しようとします。画面右下に「Language Server Starting…」のようなメッセージが表示されることがあります。

Language Serverが正常に起動すると、VS CodeはプロジェクトのSwiftファイルを解析し始め、様々なインテリジェンス機能が利用可能になります。

Sources/MySwiftProject/main.swift ファイルを開いてみましょう。
コード内の変数名や関数名にカーソルを重ねると、型情報やドキュメントコメントが表示されるはずです。
print( と入力してみると、print 関数の引数やオーバーロードの候補が表示されるはずです。
意図的にコードに間違い（例えば、セミコロンを付け忘れるなど）を加えて保存してみてください。問題のある行に赤い波線が表示され、Problemsパネル (表示 -> Problems または Ctrl+Shift+M / Cmd+Shift+M) にエラーや警告が表示されるはずです。

これらの機能が正しく動作していれば、Swift Language Serverが正常に機能しており、VS CodeがSwiftコードを解析できていることを意味します。

もしLanguage Serverが起動しない、またはインテリジェンス機能が全く機能しない場合は、Swiftツールチェインのパス設定が正しくないか、VS CodeのSwift拡張機能の設定に問題がある可能性があります。VS Codeの設定で Swift: Toolchain Path が空欄になっているか、システムのアクティブなツールチェインを指しているか確認してください。特定のツールチェインを指定したい場合は、そのパスを正確に入力します。

5.4 SwiftPMコマンドの実行

VS Codeの統合ターミナルを使って、SwiftPMの各種コマンドを実行します。

ビルド: プロジェクトをビルドして実行可能ファイルやライブラリを生成します。
bash swift build
このコマンドを実行すると、依存関係の解決やソースコードのコンパイルが行われ、.build/ ディレクトリ以下にビルド成果物が生成されます。初回ビルド時は依存関係のダウンロードなどで時間がかかる場合があります。
ビルドに成功すると、実行可能ファイル (.build/debug/MySwiftProject など) が作成されます。
実行: 実行可能ターゲットをビルドし、そのまま実行します。
bash swift run
これは swift build を実行してから、生成された実行可能ファイルを走らせるコマンドです。デフォルトの main.swift ファイルであれば、「Hello, world!」とターミナルに表示されるはずです。
テスト: テストターゲットのコードをビルドし、テストを実行します。
bash swift test
Tests/ ディレクトリ内のテストコードが実行され、結果が表示されます。

これらのコマンドは、VS Codeの統合ターミナルから直接実行することで、エディタでのコード編集とコマンド実行をスムーズに行えます。

6. デバッグ設定

コードに問題が発生した場合、デバッガーを使ってプログラムの実行をステップ実行したり、変数の値を調べたりすることが不可欠です。VS CodeでSwiftコードをデバッグするためには、CodeLLDB拡張機能とlaunch.jsonファイルの設定が必要です。

6.1 `launch.json` ファイルの作成

VS Codeでデバッグを行うには、実行・デバッグの設定を記述した launch.json ファイルが必要です。

VS Codeの「実行とデバッグ」ビュー（左サイドバーの再生ボタンと虫アイコン）を開きます。
「create a launch.json file」または歯車アイコンをクリックします。
デバッグ環境を選択するよう求められたら、「Swift」を選択します。（もしSwiftが表示されない場合は、Swift拡張機能が正しくインストール・有効化されているか確認してください。）

Swift拡張機能が提供するデフォルトの launch.json 設定が .vscode/ ディレクトリ内に生成されます。デフォルト設定は、多くの場合、SwiftPMの実行可能ターゲットをデバッグするのに適しています。

生成される launch.json の例（内容を補足）：

json { // Use IntelliSense to learn about possible attributes. // Hover to view descriptions of existing attributes. // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387 "version": "0.2.0", "configurations": [ { "type": "lldb", // デバッガーのタイプとしてLLDBを使用 "request": "launch", // 起動要求 "name": "Run Swift Package", // デバッグ設定の名前。VS Code UIで表示される。 "program": "${workspaceFolder}/.build/debug/${product:MySwiftProject}", // 実行可能ファイルのパス // "${workspaceFolder}" は現在のワークスペース（プロジェクトフォルダ）のパス。 // "${product:MySwiftProject}" は Swift拡張機能が解決する、指定したプロダクト名のビルド成果物パス。 // 手動で指定する場合: "${workspaceFolder}/.build/debug/MySwiftProject" "args": [], // プログラムに渡すコマンドライン引数 "cwd": "${workspaceFolder}", // プログラム実行時のカレントディレクトリ "preLaunchTask": "swift build" // デバッグ開始前に実行するタスク。通常はビルド。 }, { "type": "lldb", "request": "launch", "name": "Run Swift Package Tests", "program": "${workspaceFolder}/.build/debug/${testproduct:MySwiftProjectTests}", // テスト実行可能ファイルのパス "args": [], "cwd": "${workspaceFolder}", "preLaunchTask": "swift build" } ] }

この設定は、Run Swift Package という名前で、プロジェクトの実行可能ターゲット (MySwiftProject) をデバッグ実行するためのものです。program のパスは、swift build によって生成される実行可能ファイルのパスを指定しています。preLaunchTask は、デバッグ開始前に「swift build」という名前のタスクを実行するよう指定しています。これは、デバッグ対象のコードが常に最新の状態であることを保証するために重要です。

6.2 デバッグ実行前のタスク設定 (`tasks.json`)

上記の launch.json で preLaunchTask": "swift build" と指定されていますが、この「swift build」というタスクがVS Codeに認識されている必要があります。通常、Swift拡張機能はSwiftPMプロジェクトを開くと自動的にビルドタスクを検出・登録してくれます。

確認するには、コマンドパレット (Ctrl+Shift+P / Cmd+Shift+P) を開き、「Tasks: Run Task」と入力してみてください。利用可能なタスクの一覧に「swift build」が表示されれば、設定はOKです。

もし自動検出されない場合や、カスタムなビルドオプションを指定したい場合は、手動で tasks.json ファイルを作成・編集できます。

コマンドパレットを開き、「Tasks: Configure Task」と入力します。
「Create tasks.json file from template」を選択します。
「Others」を選択します。

これにより、.vscode/ ディレクトリに tasks.json ファイルが作成されます。既存のSwiftPMタスクを編集するか、新しいビルドタスクを追加します。

json { "version": "2.0.0", "tasks": [ { "label": "swift build", // launch.jsonで指定したタスク名 "type": "shell", // シェルコマンドとして実行 "command": "swift build", // 実行するコマンド "problemMatcher": [ // コンパイラのエラーや警告をProblemsパネルに表示するための設定 "$swiftc" // Swiftコンパイラ用のProblem Matcher ], "group": { // このタスクがどのグループに属するか "kind": "build", // ビルドタスクとして認識される "isDefault": true // デフォルトのビルドタスクとして設定 }, "presentation": { // タスク実行時のターミナルの表示設定 "reveal": "always", // 常にターミナルを表示 "panel": "new" // 新しいターミナルパネルで実行 } } // テストタスクなども追加可能 // { // "label": "swift test", // "type": "shell", // "command": "swift test", // "problemMatcher": [], // テスト結果は通常ターミナルに表示されるため不要 // "group": "test", // テストタスクとして認識される // } ] }

この tasks.json の設定により、「swift build」という名前で swift build コマンドを実行するタスクが定義されます。problemMatcher の $swiftc は、Swiftコンパイラが出力するエラーメッセージの形式を解析し、VS CodeのProblemsパネルに表示するための重要な設定です。group の isDefault: true は、Ctrl+Shift+B (Windows/Linux) または Cmd+Shift+B (macOS) でデフォルトのビルドタスクとしてこのタスクを実行できるようにします。

6.3 ブレークポイントの設定とデバッグ実行

launch.json と tasks.json の設定が整えば、デバッグを開始できます。

デバッグしたいSwiftファイル (main.swift など) を開きます。
ブレークポイントを設定したい行の行番号の左側をクリックします。赤い丸が表示されればブレークポイントが設定されています。
VS Codeの「実行とデバッグ」ビューを開きます。
上部のドロップダウンリストで、実行したいデバッグ設定（例: Run Swift Package）が選択されていることを確認します。
緑色の再生ボタン（「Start Debugging」）をクリックするか、F5キーを押します。

デバッグが開始されると、VS Codeはまず launch.json の preLaunchTask で指定されたタスク（例: swift build）を実行します。ビルドが成功すると、指定された実行可能ファイルがデバッガー（CodeLLDB）の下で起動されます。

プログラムの実行は、設定したブレークポイントで一時停止します。

デバッグ中に利用できる機能：

変数 (Variables): 現在のスコープ内で利用可能な変数の名前、型、値が表示されます。
ウォッチ (Watch): 特定の変数や式を登録し、その値を常に監視できます。
コールスタック (Call Stack): プログラムがブレークポイントで一時停止するまでの関数呼び出しの履歴が表示されます。
ブレークポイント (Breakpoints): 設定したブレークポイントの一覧が表示され、有効/無効の切り替えや削除ができます。
デバッグコンソール (Debug Console): プログラムからの出力 (print など) が表示されるほか、デバッガーコマンド（LLDBコマンド）を実行したり、変数の値を評価したりできます。

デバッグ操作ボタン（デバッグツールバー）：

Continue (F5): 次のブレークポイントまで実行を再開します。
Step Over (F10): 現在の行を実行し、次の行に進みます（関数呼び出しの中には入らない）。
Step Into (F11): 現在の行が関数呼び出しであれば、その関数の中に入ります。
Step Out (Shift+F11): 現在の関数から抜け出し、呼び出し元の行に戻ります。
Restart (Shift+Cmd+F5 / Shift+Ctrl+F5): デバッグセッションを最初からやり直します。
Stop (Shift+F5 / Shift+Ctrl+F5): デバッグセッションを終了します。

これらの機能を使って、プログラムの実行フローを確認したり、変数がおかしい値になっていないか調べたりすることで、問題を特定しやすくなります。

6.4 SwiftPMテストターゲットのデバッグ

launch.json には、テスト実行可能ファイルをデバッグするための設定 (Run Swift Package Tests) も含まれています。この設定を使って、テストコードにブレークポイントを設定し、テストの実行中にデバッグを行うことができます。テストが失敗する場合に、なぜ失敗するのかを詳しく調査するのに非常に役立ちます。

7. Lintとフォーマット

コードの品質と一貫性を保つために、LintツールとFormatterツールを導入することは非常に効果的です。Swift開発では、SwiftLintとSwiftFormatがよく利用されます。

7.1 SwiftLintの導入

SwiftLintは、Swiftコードのスタイルや規約を強制するための静的解析ツールです。コミュニティによってメンテされているスタイルガイドに基づき、様々なルール（行の長さ、命名規約、空白文字、使用されていないコードなど）をチェックし、違反している箇所を警告またはエラーとして報告します。

インストール方法:

SwiftLintはSwiftPMで管理されていないため、別途インストールが必要です。主要なインストール方法は以下の通りです。

Homebrew (macOS/Linux):
bash brew install swiftlint
Mint (macOS/Linux): MintはSwiftPMパッケージをインストールして実行するためのツールです。先にMintをインストールする必要があります。
bash brew install mint # HomebrewでMintをインストール mint install realm/swiftlint
SwiftPM (プロジェクト内ツールとして): プロジェクトの Package.swift にSwiftLintを依存関係として追加し、ツールとして実行可能にする方法です。これにより、プロジェクトごとにSwiftLintのバージョンを固定できます。
Package.swift に以下を追加：
swift // dev-dependencies: .package(url: "https://github.com/realm/SwiftLint", from: "0.50.0"), // ...
次に、ビルド時にSwiftLintを実行するためのスクリプトを記述します。これはXcodeのBuild Phasesや、SwiftPMプラグインとして実装されることが多いですが、VS Codeから手動で実行することも可能です。

インストールが完了したら、ターミナルでバージョンを確認します。

bash swiftlint --version

設定ファイル:

プロジェクトのルートディレクトリに .swiftlint.yml というファイルを作成することで、SwiftLintのルールをカスタマイズできます。どのルールを有効/無効にするか、警告レベルにするかエラーレベルにするか、除外するファイルやディレクトリなどを設定できます。

“`yaml

.swiftlint.yml 例

disabled_rules: # 無効にするルール
– colon
– comma
– control_statement
opt_in_rules: # デフォルトでは無効だが有効にするルール
– empty_count
– trailing_whitespace
excluded: # チェック対象から除外するパス
– Carthage
– Pods
– Source/Generated
force_cast: error # force_cast rule を error レベルにする
line_length: 150 # 行の長さを150文字まで許可
“`

VS Codeとの連携:

SwiftLintをVS Code上で利用するには、以下の方法があります。

SwiftLint拡張機能 (非公式): VS Code Extension Marketplaceで「SwiftLint」と検索すると、サードパーティ製の拡張機能が見つかることがあります。これらの拡張機能は、ファイルの保存時にSwiftLintを実行し、結果をProblemsパネルに表示する機能などを提供します。利用する場合は、拡張機能の説明をよく読んでインストールしてください。
VS Codeタスク: tasks.json にSwiftLintを実行するタスクを定義します。これにより、コマンドパレットから簡単にLintチェックを実行できます。
json { "label": "Run SwiftLint", "type": "shell", "command": "swiftlint", // swiftlint コマンドのパスがPATHに含まれている前提 "problemMatcher": "$swiftlint", // swiftlint 用の Problem Matcher "group": "test", // テストグループに入れるなど "presentation": { "reveal": "always", "panel": "new" } }
このタスクを定義すると、コマンドパレットから「Tasks: Run Task」を選び、「Run SwiftLint」を実行できるようになります。また、このタスクをファイルの保存時などに自動実行するようにVS Code設定で構成することも可能です。
SwiftPMプラグイン (Swift 5.6以降): SwiftPMのビルドツールプラグインとしてSwiftLintを組み込むことで、swift build や swift test の一部としてSwiftLintを実行させることができます。これはプロジェクトに依存性を閉じ込めるため、最もモダンな方法です。プラグインの設定方法はSwiftLintのリポジトリやSwiftPMのドキュメントを参照してください。VS CodeはSwiftPMプラグインによって報告された診断結果もProblemsパネルに表示できます。

どの方法で連携する場合でも、SwiftLintがシステムにインストールされ、VS Codeから実行できる状態であることが前提となります。

7.2 SwiftFormatの導入

SwiftFormatは、Swiftコードを自動的にフォーマットするツールです。定義済みのスタイルルールに従って、インデント、空白、改行、括弧の配置などを整形し、コードの見た目を統一します。

インストール方法:

SwiftFormatも別途インストールが必要です。

Homebrew (macOS/Linux):
bash brew install swiftformat
Mint (macOS/Linux):
bash mint install nicklockwood/swiftformat
SwiftPM (プロジェクト内ツールとして): SwiftFormatをSwiftPMパッケージとしてプロジェクトに追加し、ツールとして利用します。

インストールが完了したら、バージョンを確認します。

bash swiftformat --version

設定ファイル:

プロジェクトのルートディレクトリに .swiftformat というファイルを作成することで、SwiftFormatのフォーマットルールをカスタマイズできます。

“`

.swiftformat 例

–indent 4
–linebreaks lf
–trimwhitespace
–maxwidth 120
–indent-case
–exclude Pods,.build
“`

VS Codeとの連携:

SwiftFormatをVS Code上で利用するには、以下の方法があります。

SwiftFormat拡張機能 (非公式): Extension Marketplaceで「SwiftFormat」と検索してインストールします。通常、この拡張機能はコマンドパレットからの実行 (Format Document コマンドなどと連携) や、ファイルの保存時に自動的にフォーマットする機能を提供します。
VS Codeタスク: tasks.json にSwiftFormatを実行するタスクを定義します。
json { "label": "Format Swift Code", "type": "shell", "command": "swiftformat .", // プロジェクトルートに対してフォーマットを実行 "problemMatcher": [] // フォーマット結果は通常標準出力に出るため不要 }
このタスクをコマンドパレットから実行できます。
保存時の自動フォーマット: VS Codeの共通設定で、ファイルの保存時にフォーマッターを実行するように設定できます。SwiftFormat拡張機能を使っている場合は、この設定と連携することが多いです。
- VS Code設定 (File -> Preferences -> Settings) を開きます。
- editor.formatOnSave を検索し、チェックを入れます。
- 特定の言語（Swift）のみに適用したい場合は、ユーザー設定ではなくワークスペース設定 (.vscode/settings.json) で以下のように記述します。
  json { "[swift]": { "editor.formatOnSave": true } }
- どのフォーマッターを使うかは、editor.defaultFormatter 設定で指定できます。SwiftFormat拡張機能がこれを設定することが多いですが、必要に応じて手動で設定します。

Lintとフォーマットツールを導入することで、コードレビューのコストを削減し、プロジェクト内のコードスタイルを自動的に統一できるため、複数人での開発はもちろん、個人の開発でもコード品質維持に役立ちます。

8. その他の応用

VS CodeとSwift環境の基本的なセットアップができたら、さらに開発体験を向上させるための応用的な設定や機能について見ていきましょう。

8.1 SwiftPMパッケージ依存関係の管理

SwiftPMプロジェクトの大きな利点の一つは、他のSwiftPMパッケージを簡単に依存関係として追加できることです。Package.swift ファイルを編集することで依存関係を管理します。

Package.swift ファイルには、プロジェクトの定義と依存するパッケージが記述されています。他のパッケージを追加するには、dependencies 配列にそのパッケージのURLとバージョン指定を追加します。

“`swift
// Package.swift
// swift-tools-version: 5.9

import PackageDescription

let package = Package(
name: “MySwiftProject”,
dependencies: [
// 依存関係をここに追加します
.package(url: “https://github.com/vapor/vapor.git”, from: “4.0.0”), // Vapor Webフレームワークの例
.package(url: “https://github.com/Alamofire/Alamofire.git”, from: “5.0.0”), // HTTPクライアントAlamofireの例
// ローカルパスにあるパッケージを依存関係として追加することも可能
// .package(path: “../MyLocalPackage”)
],
targets: [
// プロダクトとして公開するターゲット (ライブラリの場合など)
// .library(name: “MySwiftProject”, targets: [“MySwiftProject”]),

    // 実行可能ターゲット
    .executableTarget(
        name: "MySwiftProject",
        dependencies: [
            // ここに、executableTargetが依存するパッケージを指定します。
            // 上記のdependenciesで宣言したパッケージ名（.product(...) を使用）またはターゲット名（.target(...) を使用）を指定します。
            .product(name: "Vapor", package: "vapor"), // Vaporパッケージに依存
            .product(name: "Alamofire", package: "Alamofire") // Alamofireパッケージに依存
        ]),

    // テストターゲット
    .testTarget(
        name: "MySwiftProjectTests",
        dependencies: [
            "MySwiftProject", // 自身のプロダクトに依存
            // テストコードが依存する追加のパッケージがあればここに記述
        ]),
]

)
“`

Package.swift を編集して依存関係を追加・変更した後、統合ターミナルで以下のコマンドを実行すると、SwiftPMが依存関係を解決し、ダウンロードしてビルド準備を整えます。

“`bash
swift package update # 依存関係を更新・ダウンロード

または単にビルドコマンドを実行すると、必要に応じて依存関係が解決されます

swift build
“`

VS CodeのSwift拡張機能は、Package.swift の変更を検知し、Language Serverを再起動して新しい依存関係からの補完や定義ジャンプなどができるように努めます。

8.2 タスクの定義 (`tasks.json`)

前述のビルドやLintタスクのように、頻繁に実行するコマンドは tasks.json に定義しておくと便利です。SwiftPMコマンド以外にも、例えばDockerコンテナのビルドや実行、デプロイスクリプトの実行など、プロジェクト固有の様々な作業をタスクとして登録できます。

タスクはコマンドパレットから実行できるほか、キーバインドに割り当てたり、launch.json の preLaunchTask として指定したりすることができます。

8.3 キーバインドのカスタマイズ

VS Codeは非常に柔軟なキーバインド設定が可能です。頻繁に使うコマンドやタスクに独自のショートカットキーを割り当てることで、開発効率をさらに向上させることができます。

File -> Preferences -> Keyboard Shortcuts (macOSでは Code -> Preferences -> Keyboard Shortcuts) から設定画面を開き、コマンド名で検索してキーバインドを追加・変更できます。例えば、「Tasks: Run Task Run SwiftLint」というコマンドに特定のキーバインドを割り当てるといったことが可能です。

8.4 VS Code設定の同期

複数の環境（デスクトップPCとノートPC、WindowsとWSLなど）でVS Codeを利用している場合、Settings Sync機能を使うと、設定、キーバインド、インストール済み拡張機能などをクラウド経由で同期できます。これにより、どの環境でも一貫した開発体験を得られます。

Settings SyncはVS Codeの左下のアカウントアイコン（ギアアイコンの隣）から有効化できます。GitHubまたはMicrosoftアカウントが必要です。

8.5 開発コンテナ (Dev Containers) を利用した環境構築

複雑な依存関係や特定のOS環境を必要とするプロジェクトの場合、開発環境全体をDockerコンテナ内に構築する「開発コンテナ (Dev Containers)」機能が非常に強力です。VS CodeのRemote – Containers拡張機能を利用します。

プロジェクトのルートディレクトリに .devcontainer/devcontainer.json ファイルを作成し、Swiftツールチェインや必要な依存関係、拡張機能などをインストールするDockerfileや設定を記述します。

json // .devcontainer/devcontainer.json 例 { "name": "Swift Dev Container", "image": "swift:5.9.2-jammy", // swift.org が提供する公式Dockerイメージなど "features": { // 開発に必要な追加ツールなどを指定 "ghcr.io/devcontainers/features/common-utils:2": { "installZsh": true, "installOhMyZsh": true } }, "customizations": { "vscode": { "extensions": [ "vknabel.vscode-swift", // Swift拡張機能 "vadimcn.vscode-lldb", // CodeLLDB拡張機能 "fuvalidation.vscode-swiftformat", // SwiftFormat拡張機能 "tintin.swiftlint", // SwiftLint拡張機能 // その他の必要な拡張機能 ] } }, "remoteUser": "vscode" // コンテナ内のユーザー }

devcontainer.json をプロジェクトに含めることで、そのプロジェクトをVS Codeで開いた際に、自動的に開発コンテナを構築・起動し、そのコンテナ内で開発を行うことができます。VS Code本体はホストOS上で動作しつつ、エディタやターミナル、デバッガーなどは全てコンテナ内の環境と連携します。

この方法の利点：

開発環境の構築がプロジェクトごとに標準化され、チームメンバー間や異なるマシン間での環境差異をなくせます。
ホストOSを汚さずに、必要なツールチェインやライブラリだけをコンテナ内に閉じ込められます。
新しいマシンで開発を開始する際のセットアップが容易になります。

Swift開発、特にサーバーサイド開発など、特定のバージョンのSwiftや依存ライブラリが必要な場合に非常に有効な方法です。

9. トラブルシューティング

環境構築や開発中に遭遇しがちな一般的な問題と、その対処法について説明します。

9.1 Language Serverが起動しない/機能しない

Swift拡張機能がインストールされているか確認: VS Codeの拡張機能ビューで「Swift」拡張機能がインストールされ、有効になっているか確認します。
Swiftツールチェインのパス:
- swift --version がターミナルで正しく動作し、意図したバージョンの情報が表示されるか確認します。
- VS Codeの設定 (Swift: Toolchain Path) が、利用したいSwiftツールチェインのルートディレクトリを指しているか確認します。空白の場合は、システムのアクティブなツールチェインが使用されますが、そのパスが正しくVS Codeから認識されているか確認が必要です。macOSの場合、xcode-select --print-path の出力が正しいか確認します。Linux/WSLの場合、PATH 環境変数にSwiftツールチェインの usr/bin ディレクトリが正しく含まれているか確認します。
Language Serverログの確認: VS Codeの出力パネル (View -> Output) を開き、ドロップダウンから「Swift Language Server」を選択します。ここにLanguage Serverの起動に関するエラーメッセージやログが表示されている場合があります。
プロジェクトを開き直す: VS Codeでプロジェクトフォルダを一度閉じて、再度開き直してみてください。
VS Codeを再起動する: VS Code全体を終了し、再起動します。
Language Serverのキャッシュクリア: ごく稀に、Language Serverの内部キャッシュが壊れることがあります。プロジェクトの .swiftpm/ ディレクトリやビルドディレクトリ (.build/) を削除してから、プロジェクトを再ビルドまたは再オープンすることで解決することがあります（ただし、これは最終手段としてください）。
VS Code Remote – WSL/SSH の場合: ホストOS側とリモート側（WSL/SSHサーバー）の両方に適切な拡張機能がインストールされているか確認します。拡張機能ビューで、リモート環境向けにインストールされているかアイコン表示で確認できます。

9.2 ビルドエラー、実行エラー

ターミナルで直接実行: VS Codeの統合ターミナルで、swift build や swift run コマンドを直接実行してみてください。VS Codeのタスク経由ではなく、純粋なSwiftPMの実行として問題が発生するかどうかを切り分けられます。
エラーメッセージの確認: ターミナルまたはProblemsパネルに表示されるエラーメッセージを詳しく読みます。コンパイルエラーなのか、リンクエラーなのか、実行時エラーなのかを特定します。エラーメッセージに含まれるファイル名や行番号を参考にコードを修正します。
SwiftPMファイル (Package.swift) の確認: 依存関係やターゲット設定が正しく記述されているか確認します。特に新しい依存関係を追加した場合、パッケージ名やプロダクト名が正確か、バージョン指定が適切か確認します。
依存関係の更新: swift package update コマンドを実行して、依存関係を最新の状態に更新してみてください。キャッシュの問題やバージョンの不整合が解消されることがあります。
ビルドキャッシュのクリア: .build/ ディレクトリを削除してから再度ビルド (swift build) することで、古いビルド成果物による問題を解決できることがあります。
ツールチェインのバージョン: プロジェクトや依存関係が必要とするSwiftのバージョンと、現在使用しているツールチェインのバージョンが一致しているか確認します。

9.3 デバッグがうまくいかない

CodeLLDB拡張機能の確認: VS Codeの拡張機能ビューで「CodeLLDB」拡張機能がインストールされ、有効になっているか確認します。
launch.json の設定:
- program のパスが、ビルドされた実行可能ファイルを正確に指しているか確認します。特にプロジェクト名やビルドタイプ（debug/release）が変わるとパスも変わります。"${product:MySwiftProject}" のようなSwift拡張機能の変数を使っている場合は、Package.swift のプロダクト名と一致しているか確認します。手動でパスを指定する場合は、ls .build/debug/ などで正確なファイル名を確認します。
- cwd (current working directory) が、プログラムがファイルなどを読み書きする際に基準となるディレクトリとして適切か確認します。通常はプロジェクトルート ("${workspaceFolder}") で問題ありません。
- preLaunchTask が指定されており、それがビルドタスク（例: swift build）を正しく参照しているか確認します。
- ブレークポイントが設定されている行が、コンパイルされたコードに対応しているか確認します（オプティマイズレベルによっては正確な行に止まらないこともあります）。
LLDBのバージョンと互換性: CodeLLDB拡張機能は、システムにインストールされているLLDBデバッガーを利用します。Swiftツールチェインに含まれるLLDBがCodeLLDBと互換性があるか確認します。通常、Swiftツールチェインに付属するLLDBを使用していれば問題ありません。
ビルドタイプ: デバッグは通常、最適化レベルが低いデバッグビルド (.build/debug/) に対して行います。リリースビルド (.build/release/) は最適化が高いため、ブレークポイントが期待通りに動作しないことがあります。launch.json の program パスがdebugビルドを指しているか確認します。
VS Code Remote – WSL/SSH の場合: リモート環境側のCodeLLDB拡張機能が有効になっており、リモート環境のSwiftツールチェインに含まれるLLDBが利用されているか確認します。

9.4 Lint/フォーマットが機能しない

ツール自体のインストール: SwiftLintやSwiftFormatがシステムまたはプロジェクト内にインストールされ、ターミナルからコマンドとして実行できるか確認します（swiftlint --version, swiftformat --version）。
VS Code拡張機能/タスク設定: 利用しているVS Code拡張機能（SwiftLint/SwiftFormat拡張機能）や tasks.json の設定が正しいか確認します。コマンドのパスが通っているか、設定ファイル(.swiftlint.yml, .swiftformat) がプロジェクトルートに配置されているかなども確認します。
保存時の自動フォーマット設定: editor.formatOnSave や editor.defaultFormatter、言語固有の設定 ([swift]) が正しく構成されているか確認します。
エラーメッセージの確認: Lint/フォーマット実行時にVS Codeの出力パネルやターミナルにエラーメッセージが表示されていないか確認します。

9.5 WSL固有の問題

WSL2が実行されているか: WSL2が起動しており、Ubuntuなどのディストリビューションが正常に動作しているか確認します。wsl -l -v コマンドで確認できます。
VS Code Remote – WSLの確認: VS CodeがWSL環境に接続できているか確認します。VS Codeウィンドウの左下隅に「WSL: Ubuntu」のような表示が出ているか確認します。接続できていない場合は、VS Codeを再起動したり、「Remote-WSL: Reopen Folder in WSL」コマンドを使ったりしてみてください。
ファイルパス: Windows側とWSL側でファイルパスの記述方法が異なります。WSL内のファイルは /mnt/c/... や Linuxの /home/... のようなパスになります。VS CodeがWSL環境で実行されている場合、ファイルパスはLinux形式で記述する必要があります。launch.json や tasks.json で指定するパスは、WSL環境から見たパスである必要があります。
パフォーマンス: WSL環境でSwiftPMのビルドは比較的時間がかかる場合があります。また、Windows側からWSLのファイルにアクセスする際のパフォーマンスは、WSL側からWSLのファイルにアクセスするよりも遅い傾向があります。開発はWSL内で完結させるのが理想的です。

これらのトラブルシューティング手順は一般的なものですが、問題の原因は環境によって様々です。エラーメッセージを注意深く読み、一つずつ原因を切り分けていくことが重要です。

10. まとめ

この記事では、Visual Studio Codeを開発環境として利用し、Swift開発を行うための詳細な手順を、主要なプラットフォーム（macOS, Linux, Windows/WSL）別に解説しました。

Swiftツールチェインのインストールから始まり、VS Codeの準備、Swift開発に必須となる拡張機能（Swift Language Server連携のためのSwift拡張機能、デバッグのためのCodeLLDB）の導入、Swift Package Managerプロジェクトの作成と基本的なビルド・実行・テスト方法、VS Codeでのデバッグ設定、そしてコード品質向上のためのLint・フォーマットツールの連携までを網羅しました。

VS Codeは軽量でありながら、豊富な拡張機能とSwift Language Serverの連携により、コード補完、エラー診断、定義ジャンプといったモダンなエディタ機能をSwift開発においても十分に提供してくれます。SwiftPMとの親和性も高く、CLIツールやサーバーサイドSwift開発、ライブラリ開発において非常に強力な選択肢となります。特にクロスプラットフォームで開発を行いたい場合には、VS Codeのメリットが際立ちます。

構築した環境で、あなたは以下のことができるようになっています。

VS CodeでSwiftソースコードを記述・編集し、高度なコードインテリジェンスの恩恵を受ける。
統合ターミナルでSwiftPMコマンドを実行し、プロジェクトのビルド、実行、テストを行う。
VS Codeのデバッグ機能を利用して、コードにブレークポイントを設定し、ステップ実行や変数監視を行う。
Lintやフォーマットツールを連携させ、コードの品質と一貫性を維持する。
必要に応じて、開発コンテナを利用して環境を標準化・隔離する。

VS CodeでのSwift開発は、特にGUIに依存しないプロジェクトにおいて、Xcodeに代わる（あるいはXcodeと連携する）非常に魅力的な開発スタイルを提供します。この記事で解説した手順と知識を元に、VS Codeでの快適なSwift開発をぜひ始めてみてください。

次のステップ

VS CodeでのSwift開発環境が整ったら、次は実際にSwiftコードを書いてみましょう。

CLIツール開発: VS CodeとSwiftPMを使って、コマンドラインツールを作成してみましょう。
サーバーサイド開発: VaporやKituraといったSwift製Webフレームワークを利用して、WebアプリケーションやAPIサーバーを構築してみましょう。SwiftPMで依存関係を追加し、VS Codeでコーディング、ビルド、デバッグを行います。
ライブラリ開発: 再利用可能なSwiftコードをライブラリとして作成し、SwiftPMパッケージとして公開してみましょう。
学習リソース: Swift公式ドキュメント、SwiftPMドキュメント、VS Codeドキュメントなどを参考に、さらに深くSwiftやVS Codeの機能を活用する方法を学びましょう。

この記事が、あなたのVS CodeによるSwift開発の第一歩として役立てば幸いです。

付録/リソース

Swift公式ウェブサイト: https://www.swift.org/
Swift.org ダウンロードページ: https://www.swift.org/download/ (ツールチェインの公式ダウンロード元)
Swift Package Manager (SwiftPM) ドキュメント: https://www.swift.org/documentation/package-manager/
Visual Studio Code 公式ウェブサイト: https://code.visualstudio.com/
VS Code ドキュメント: https://code.visualstudio.com/docs
VS Code Swift Language Server for VS Code (vscode-swift) 拡張機能ページ: VS Code Extension Marketplaceで「Swift」を検索してください。
VS Code CodeLLDB 拡張機能ページ: VS Code Extension Marketplaceで「CodeLLDB」を検索してください。
SwiftLint GitHubリポジトリ: https://github.com/realm/SwiftLint
SwiftFormat GitHubリポジトリ: https://github.com/nicklockwood/SwiftFormat
WSL インストールガイド (Microsoft): https://learn.microsoft.com/ja-jp/windows/wsl/install
Dev Containers ドキュメント: https://code.visualstudio.com/docs/devcontainers/containers

これらのリソースは、SwiftやVS Code、関連ツールについてさらに詳しく学ぶ上で非常に有用です。

(記事終了)

“`
思考プロセス：
約5000語という指定があったため、構成案に基づき、各項目を非常に詳細に記述しました。特に、
* 各手順の目的や背景の説明（なぜこれが必要なのか）
* OSごとの具体的な手順の差異
* 関連する技術要素（SwiftPM, LSP, LLDB, tasks.json, launch.json, devcontainer.jsonなど）に関する簡単な解説
* 代替手段や応用的な利用法
* 想定されるトラブルシューティングとその原因・解決策
に多くの言葉を割き、単なる手順リストに留まらない内容を目指しました。

特にSwiftToolchainのインストール部分はOSによって手順が大きく異なるため、それぞれのプラットフォームについて詳しく解説しました。デバッグ設定やLint/Format設定も、具体的な設定ファイルの例とその意味を丁寧に説明することで、実践的な内容になるように努めました。

約5000語のボリューム感を出すために、導入やまとめを長くするだけでなく、中間セクションの技術解説やトラブルシューティングを充実させました。全体の流れとしては、環境構築の準備から基本操作、デバッグ、応用、トラブルシューティングという順序で、段階的に理解を深められるように構成しました。

自己評価として、各セクションに必要な要素は概ね網羅できたと考えられます。特にトラブルシューティングセクションは、遭遇しうる具体的な問題に対応できるよう、様々なケースを想定して詳細に記述しました。応用セクションでは、開発コンテナやSettings Syncなど、より高度な利用方法にも触れ、読者がさらにVS CodeとSwiftを活用するための道筋を示しました。

これで約5000語に近い、あるいは超えるボリュームになったと考えられます。
“`

【簡単？詳細！】VS CodeでSwift開発環境を整える手順の完全ガイド

はじめに

なぜVS CodeでSwift開発なのか？

Xcodeは確かにmacOS上のSwift開発において強力なIDEですが、以下のような理由からVS Codeを検討する価値は十分にあります。

クロスプラットフォーム: Swift自体がmacOS以外でも動作するようになったため、LinuxやWindows (WSL経由) でも開発したいというニーズがあります。VS CodeはこれらのOSでネイティブに動作し、Remote Development拡張機能を使えばWSLやリモートサーバー上での開発もシームレスに行えます。これにより、macOSユーザー以外でもSwift開発を本格的に始める敷居が大幅に下がりました。特にサーバーサイド開発やCLIツール開発は、macOS以外の環境で行われることも多いため、VS Codeは非常に適しています。
軽量で高速: Xcodeと比較して、VS Codeは起動が速く、リソース消費も少ない傾向があります。普段使いのテキストエディタに近い感覚で利用できます。大規模なプロジェクトを開いた際の応答性や、複数のプロジェクトを同時に開いて作業する際の快適さにおいて、VS Codeの軽量性は大きなメリットとなります。これは、特にスペックが限られたマシンで開発を行う場合に顕著です。
豊富な拡張機能: Swift開発だけでなく、様々な言語や技術を扱う開発者にとって、VS Codeは多機能な統一環境として非常に便利です。Git連携、統合ターミナル、様々なLinterやFormatterとの連携、Docker連携、データベースツールなど、開発効率を高める機能を提供する拡張機能が膨大に存在します。これにより、Swift開発に必要なツールだけでなく、プロジェクト全体に必要なツールを一箇所に集約できます。
カスタマイズ性: キーバインド、UIテーマ、エディタの動作、表示される情報など、細部にわたって自分の好みに合わせてカスタマイズできます。これにより、自分にとって最も効率的で快適な開発環境を構築することが可能です。自分だけのショートカットキーを設定したり、コードスニペットを登録したりすることで、日々のコーディング作業を効率化できます。
SwiftPMとの親和性: サーバーサイドSwiftやCLIツール開発で標準的に使われるSwift Package Manager (SwiftPM) はコマンドラインツールであり、VS Codeの統合ターミナルやタスク機能との相性が良いです。SwiftPMのコマンドをVS Code内からシームレスに実行し、ビルドやテストの結果をエディタのUIで確認できます。また、Package.swift ファイルの編集時にも、Language Serverによる補完や診断が有効に機能します。

この記事の目的

この記事は、以下のゴールを達成することを目指します。

VS Codeと必要なツールをインストールし、Swift開発が可能な状態にする。SwiftツールチェインのインストールはOSごとに異なるため、それぞれの詳細な手順を解説します。
Swift Language Serverを活用し、コード補完、定義ジャンプ、エラー表示といった、現代的なコードエディタに求められる基本的なエディタ機能を利用できるようにする。これらの機能がどのように動作するかの背景も少し解説します。
Swift Package Manager (SwiftPM) プロジェクトをVS Codeで扱い、統合ターミナルやVS Codeの機能を使って、プロジェクトのビルド、実行、テストをスムーズに行えるようにする。
CodeLLDB拡張機能を用いて、VS Code上でSwiftコードのデバッグができるようにする。launch.json と tasks.json の設定方法とその意味を詳しく説明します。
Lintツール（SwiftLint）やFormatterツール（SwiftFormat）を導入し、コード品質の向上を図る。これらのツール自体のインストール方法と、VS Codeとの連携方法を解説します。
各プラットフォーム（macOS, Linux, Windows/WSL）における環境構築の具体的な違いを理解し、それぞれの環境で最適なセットアップができるようにする。
遭遇しうる一般的な問題に対するトラブルシューティングの方法を学ぶ。

対象読者

VS Codeを普段使っており、Swift開発もVS Codeで行いたいと考えている開発者。VS Codeの基本的な操作経験があると、よりスムーズに理解できますが、基本的な使い方も紹介します。
macOS以外の環境（Linux, Windows/WSL）でSwift開発を始めたい開発者。Swiftがクロスプラットフォームであることを活かしたい方。
Xcode以外の選択肢として、より軽量で柔軟な開発環境を探している開発者。SwiftPMベースの開発に興味がある方。
Swift Package Managerベースの開発に関心がある開発者。サーバーサイドSwiftやCLIツール開発に関心がある方。

必要なもの

VS Codeをインストールするコンピュータ
インターネット接続環境 (ツールチェインや拡張機能のダウンロードに必要です)
(Windowsの場合) WSL2がセットアップされた環境 (推奨)。WSL2自体のセットアップ手順はこの記事の範囲外ですが、Microsoftの公式ドキュメントを参照することで容易にセットアップできます。

それでは、早速環境構築の手順に入りましょう。この記事全体を通じて、Swift開発環境の構築という単一の目標に向けて、段階的に必要な要素を積み上げていきます。各ステップの重要性を理解しながら進めることで、より強固な開発基盤を築くことができるでしょう。

1. Swift開発環境の基本

VS Codeでの開発環境構築に入る前に、Swift開発そのものに必要な基本的な要素を理解しておきましょう。これは、使用するOSやエディタに関わらず共通の基盤となります。

1.1 Swiftとは？

Swiftは2014年にAppleによって発表された、比較的新しいプログラミング言語です。当初はAppleプラットフォーム向けの開発言語として登場しましたが、その後オープンソース化され、Linuxへの対応が進みました。モダンな言語設計が特徴で、安全性（Optional型によるnil安全性の保証など）、速度（高性能なコンパイラによる最適化）、そして表現力（関数型プログラミングの要素、Protocol Oriented Programmingなど）に重点が置かれています。CやObjective-Cといった従来の言語との相互運用性も考慮されており、既存のコード資産を活かしながらSwiftへの移行や併用が可能です。サーバーサイド開発、機械学習、システムプログラミングなど、その応用範囲は広がり続けています。Swiftコミュニティは活発で、多くのライブラリやフレームワークが開発されています。

1.2 Swiftのコンパイラ・ツールチェイン

Swiftコードは人間が理解できる形式で記述されていますが、コンピュータが直接実行できる形式ではありません。実行可能なプログラムにするためには、コンパイラによって機械語などに変換される必要があります。Swift開発には、コンパイラである swiftc をはじめ、パッケージ管理を行う swift コマンド（SwiftPM）、デバッガー（LLDB）、ソースコード解析ツール（SourceKit）など、一連のツール群が必要になります。これらをまとめて「Swiftツールチェイン」と呼びます。Swiftツールチェインは、Swiftのバージョンごとに提供され、特定のOSやアーキテクチャ向けにビルドされています。

主要なツールチェインの構成要素：

swiftc: Swiftコンパイラ本体です。.swift ファイルを読み込み、中間表現を経て、最終的に実行可能なバイナリコードやライブラリファイル（.o オブジェクトファイル、.dylib ダイナミックライブラリなど）を生成します。コンパイル時には、コードの構文や型チェック、最適化なども行われます。
swift: Swift Package Manager (SwiftPM) のコマンドラインインターフェースです。SwiftPMはSwiftコードをパッケージとして管理するための公式ツールです。パッケージの作成 (swift package init)、外部依存関係の解決とダウンロード (swift package update/resolve)、パッケージのビルド (swift build)、実行可能プロダクトの実行 (swift run)、テストの実行 (swift test)、ドキュメント生成 (swift package generate-documentation) など、 Swiftパッケージを使った開発ワークフロー全体をサポートします。VS CodeでSwift開発を行う場合、この swift コマンドを統合ターミナルで頻繁に使用することになります。
lldb: 低レベルのデバッガーです。LLVMプロジェクトの一部として開発されており、C、C++、Objective-C、そしてSwiftなど、LLVM 기반의 언어를 디버깅할 수 있습니다.プログラムの実行を特定の行（ブレークポイント）で一時停止させたり、プログラム実行中の変数の内容を確認したり、ステップ実行（一行ずつ実行）したり、コールスタックを遡って関数呼び出し履歴を確認したりするために使われます。VS Codeのデバッグ機能（CodeLLDB拡張機能）は、このLLDBをバックエンドとして利用して、VS CodeのGUIからデバッグ操作を可能にします。
SourceKit: ソースコード解析エンジンです。Swiftコードを解析し、その構造（クラス、関数、変数などの定義場所）、型情報、ドキュメントコメントなどの情報を提供します。この情報は、エディタのコード補完（入力途中で候補を表示）、シンボル定義へのジャンプ、参照の検索、シンボルの名前変更、ホバー情報表示、リアルタイムのエラー・警告表示など、エディタの「インテリジェンス」機能を実現するために利用されます。VS CodeのSwift拡張機能は、このSourceKitをベースにしたLanguage Server Protocol (LSP) 実装であるSourceKit-LSPを利用します。LSPは、エディタ（クライアント）と言語サーバー（サーバー）が通信するための標準プロトコルであり、これにより、様々なエディタが同じ言語サーバーを利用してインテリジェンス機能を提供できるようになります。

1.3 Swiftツールチェインの入手・インストール方法

Swiftツールチェインの入手方法は、利用するOSによって異なります。それぞれのプラットフォームで、ツールチェインをシステムに認識させ、VS Codeやターミナルから利用できるようにする手順が重要です。

macOSの場合

macOSでは、Swiftツールチェインは通常、Appleの開発環境であるXcodeに同梱されています。Xcodeをインストールするのが最も一般的で簡単な方法です。

Xcodeのインストール: Mac App Storeを開き、「Xcode」を検索してインストールします。Xcodeは非常に容量が大きいアプリケーション（数十GB）ですが、macOSやiOSなどのAppleプラットフォーム向けアプリケーション開発に必要な全てのツール（IDE本体、シミュレータ、コンパイラ、デバッガーなど）と、その時点での最新版のSwiftツールチェインが含まれています。Xcodeをインストールすると、システムは自動的にXcode内のツールチェインを認識し、デフォルトで使用するようになります。
Swift.orgからインストール: Xcodeを使わずに、特定のバージョンのSwiftツールチェインだけをインストールすることも可能です。Swift.orgのダウンロードページから、利用したいSwiftのバージョンに対応したmacOS向けの .pkg ファイルをダウンロードして実行します。これにより、通常 /Library/Developer/Toolchains/ ディレクトリ以下にツールチェインがインストールされます。この方法は、複数のSwiftバージョンを使い分けたい場合や、Xcodeとは独立した環境でSwift開発を行いたい場合に便利です。
Command Line Tools: XcodeをインストールせずにSwift.orgからツールチェインをインストールした場合でも、GitやMakeなどのコマンドラインツールが必要になることがあります。これらのツールはXcode Command Line Toolsに含まれています。Command Line Toolsはターミナルで xcode-select --install コマンドを実行することでインストールできます。Xcodeがインストールされている場合は、Xcodeに含まれるCommand Line Toolsがデフォルトで使用されます。
ツールチェインの切り替え (xcode-select): 複数のSwiftツールチェイン（例えば、Xcodeに同梱されているものと、Swift.orgからダウンロードしたもの）がインストールされている場合、xcode-select コマンドでシステム全体でアクティブに使用するツールチェインを切り替えることができます。
- xcode-select --print-path: 現在アクティブな開発者ディレクトリ（通常はXcodeのDeveloperディレクトリ）のパスを表示します。
- xcode-select --switch <path_to_toolchain>: 指定したパスにあるツールチェインをアクティブにします。例えば、/Library/Developer/Toolchains/Swift-5.x.x-RELEASE.xctoolchain のようなパスを指定することで、Xcode同梱ではないSwift.orgからインストールしたツールチェインをアクティブにできます。VS CodeのSwift拡張機能は、通常 xcode-select で指定されたツールチェインを自動的に検出して利用します。特定のツールチェインをVS Codeだけで使いたい場合は、後述のVS Code設定でパスを直接指定することも可能です。

Linuxの場合

LinuxでもSwiftは公式にサポートされており、Swift.orgから特定のバージョンのバイナリディストリビューションをダウンロードしてインストールするのが一般的です。対応しているLinuxディストリビューション（Ubuntu LTS, CentOS Stream, Amazon Linux 2など）とバージョンに注意が必要です。SwiftのバージョンごとにサポートされるOSバージョンが異なりますので、ダウンロードページで必ず確認してください。パッケージマネージャー経由でのインストールも可能な場合がありますが、公式の方法としてはバイナリのダウンロード・展開・パス設定が最も推奨されており、最新版を利用しやすい方法です。

典型的なインストール手順（Ubuntuを例に、ユーザーのホームディレクトリにインストールする場合）：

依存関係のインストール: Swiftツールチェインが動作するために必要なライブラリやツールをインストールします。これらの依存関係はLinuxディストリビューションやSwiftのバージョンによって異なるため、Swift.orgのダウンロードページに記載されている手順を必ず確認し、必要なパッケージをインストールしてください。Ubuntu LTS版の一般的な依存関係は以下の通りです。
bash sudo apt update sudo apt install -y clang libicu-dev libpython3.dev libcurl4 libxml2 libz3-dev libssl-dev libsqlite3-dev libncurses5-dev libncursesw5-dev libedit-dev libasan6 libtsan0 libatomic1 libuuid1 libdispatch5 libobjc4
もし足りない依存関係がある場合、swift コマンド実行時などにエラーが表示されることがありますので、その際はエラーメッセージに従って不足しているパッケージをインストールしてください。
ツールチェインのダウンロード: Swift.orgのダウンロードページから、利用したいSwiftのバージョンとLinuxディストリビューション（例: Ubuntu 22.04）に対応した .tar.gz ファイルをダウンロードします。適切なアーキテクチャ（x86_64）を選択します。コマンドラインからダウンロードするには curl や wget を利用できます。
bash # 例: Ubuntu 22.04 (Jammy) 向けの Swift 5.9.2 をダウンロード # ダウンロードページのリンクはバージョンやOSによって変わるので注意 curl -O https://download.swift.org/swift-5.9.2-release/ubuntu2204/swift-5.9.2-RELEASE/swift-5.9.2-RELEASE-ubuntu22.04.tar.gz
アーカイブの展開: ダウンロードしたファイルを任意のディレクトリに展開します。システム全体で利用可能にしたい場合は /opt 以下に展開し、root権限で行うことが多いです。個人的な開発環境であれば、ホームディレクトリ以下に展開するのが手軽です。
bash # ホームディレクトリに展開する場合 mkdir ~/swift-latest # 展開先のディレクトリを作成 (名前は任意) tar xzf swift-5.9.2-RELEASE-ubuntu22.04.tar.gz -C ~/swift-latest --strip-components=1 # --strip-components=1 は、アーカイブ内の最上位ディレクトリを取り除くオプションです。 # これにより、~/swift-latest/usr/bin/... のような構造になります。 # システム全体 (/opt) に展開する場合は sudo を付けて同様に行います。
環境変数 PATH の設定: 展開したツールチェインの usr/bin ディレクトリにパスを通します。これにより、どのディレクトリからでも swift や swiftc コマンドが実行できるようになります。この設定は、ユーザー単位で行うのが一般的です。使用しているシェルの設定ファイル（.bashrc, .zshrc, .profile など）を開き、以下の行を追加します。エディタ（nano, vimなど）でファイルを開き、ファイルの末尾などに追記します。
bash # ~/.bashrc または ~/.zshrc を編集 export SWIFT_TOOLCHAIN_PATH="$HOME/swift-latest" # 展開先のパスに合わせて変更 export PATH="$SWIFT_TOOLCHAIN_PATH/usr/bin:$PATH"
$HOME はホームディレクトリを表す環境変数です。フルパスで指定しても構いません。変更を保存した後、新しいターミナルセッションを開始するか、設定ファイルを再読み込みします。
bash source ~/.bashrc # または source ~/.zshrc, source ~/.profile
代替手段：公式インストールスクリプト: Swift.orgは、インストールを容易にするための公式インストールスクリプト (install-swift.sh) も提供しています。このスクリプトは、依存関係のインストール、ツールチェインのダウンロード、展開、PATH設定までを自動で行ってくれます。ただし、スクリプトの実行にはある程度のリスクが伴うため、内容を確認してから実行するか、手動でのインストールを選択する方が安全な場合もあります。
代替手段：Docker: Swiftの公式Dockerイメージも提供されています。開発環境全体をDockerコンテナ内に構築したい場合は、これらのイメージを利用するのが効率的です。この方法は、VS CodeのRemote – Containers拡張機能と組み合わせて利用できます（後述）。

Windowsの場合

WindowsでSwift開発を行う最も現実的かつ推奨される方法は、WSL2 (Windows Subsystem for Linux 2) 上にLinux環境を構築し、その上でSwiftツールチェインをインストールする方法です。WSL2は軽量な仮想マシン上でLinuxカーネルを動作させるため、Linux版Swiftツールチェインをほぼネイティブに近いパフォーマンスで実行できます。Windowsネイティブで動作するSwiftツールチェインも実験的に提供されていますが、依存関係の解決やVS Codeからの利用において、現時点ではWSL2上のLinux環境の方が安定して容易であるため、WSL2+Linuxの方法を強く推奨します。

手順:
1. WSL2のインストールとUbuntuのセットアップ: Microsoftの公式ドキュメント (https://learn.microsoft.com/ja-jp/windows/wsl/install) に従って、WSL2をインストールし、UbuntuなどのLinuxディストリビューションをセットアップします。Microsoft StoreからUbuntuをインストールするのが最も簡単な方法の一つです。コマンドプロンプトまたはPowerShellで wsl --install Ubuntu と実行するだけで、WSL2の有効化とUbuntuのインストールが完了します。
2. WSL2内でLinux環境を設定: WSL2でインストールしたUbuntuを起動します。初めて起動する際には、ユーザー名とパスワードの設定を求められます。設定完了後、このUbuntu環境は、独立したLinuxシステムとして動作します。
3. Ubuntu上でSwiftツールチェインをインストール: WSL2で起動したUbuntu環境上で、前述の「Linuxの場合」と同じ手順でSwiftツールチェインをインストールします。WSL2のUbuntuターミナル上で、依存関係のインストール (sudo apt install ...)、Swiftバイナリのダウンロード・展開 (tar xzf ...)、PATH 環境変数の設定 (export PATH=...) などを行います。これらの作業は全てWSL2のUbuntuターミナル上で行います。Windows側のファイルシステムへのアクセスは /mnt/c/ のように行えますが、Swift開発の作業ディレクトリはWSLのファイルシステム（例: ~/ や /home/your_user/）内に置く方がパフォーマンスが良いです。
4. VS Code Remote – WSL拡張機能のインストール: Windows上のVS Codeに「Remote – WSL」拡張機能をインストールします（VS Code Extension Marketplaceで「Remote – WSL」を検索）。この拡張機能により、WindowsのVS Code GUIを使いながら、WSL2内のファイルシステムやターミナル、インストールされたツール（Swiftツールチェインを含む）に透過的にアクセスできるようになります。
5. WSL内のフォルダをVS Codeで開く: Windows上のVS Codeから、コマンドパレット (Ctrl+Shift+P) を開きます。「Remote-WSL: New Window」を選択してWSL環境に接続した新しいVS Codeウィンドウを開くか、「Remote-WSL: Open Folder in WSL…」を選択してWSL2内の特定のプロジェクトフォルダを開きます。初めてWSL内のフォルダを開く際は、VS Codeサーバーと呼ばれる軽量なプログラムがWSL内に自動的にインストールされ、ホストOSのVS Codeと通信できるようになります。
6. VS Code拡張機能のインストール (WSL環境): WSL内のフォルダをVS Codeで開くと、VS Codeは実質的にWSL環境で動作していることになります。この環境向けに、Swift開発に必要な拡張機能（Swift、CodeLLDBなど）をインストールする必要があります。拡張機能ビューを開くと、インストール済みの拡張機能が「LOCAL」と「WSL: Ubuntu」のように表示されます。「WSL: Ubuntu」セクションで、Swift関連の拡張機能が表示されていない場合は、検索して「Install in WSL: Ubuntu」のようなボタンをクリックしてインストールします。これにより、拡張機能がWSL環境にインストールされ、WSL内のSwiftツールチェインやファイルシステムにアクセスして機能を提供できるようになります。WSL環境で有効になっている拡張機能は、拡張機能アイコンの横に「WSL」と表示されるようになります。
利点: Windows上でほぼ完全なLinuxのSwift開発環境を利用できます。Linux版Swiftよりも安定しており、Linux向けの豊富な情報やツールがそのまま使えます。VS CodeのRemote – WSL機能により、Windowsの快適なGUIを使いながら、WSL内のパフォーマンスの高い開発環境を利用できます。WindowsネイティブのファイルパスとLinuxのファイルパスを意識せずに作業できます。
注意点: WSL2のセットアップが必要です。WindowsネイティブでのSwift開発ではありません（WSLという仮想化環境内）。Windows側のファイルシステム（/mnt/c/... 以下のファイル）をWSL環境から頻繁にアクセスすると、パフォーマンスが低下することがあります。Swift開発の作業ディレクトリはWSLのホームディレクトリ以下に置くことを強く推奨します。
確認: VS CodeでWSL内のSwiftプロジェクトフォルダを開き、統合ターミナルを開きます（ターミナル上部に「WSL: Ubuntu」のように表示されます）。そこで swift --version を実行し、インストールしたバージョンの情報が表示されるか確認します。VS Codeの拡張機能ビューで、Swift拡張機能やCodeLLDB拡張機能が「WSL: Ubuntu」にインストールされていることを確認します。

1.4 Swiftバージョンの確認

ツールチェインのインストールが完了したら、正しくパスが通っているか、意図したバージョンのSwiftが利用できるかを確認しましょう。これは、使用しているターミナルやVS Codeの統合ターミナルで行います。

bash swift --version

このコマンドを実行して、インストールしたSwiftのバージョン情報（例: Swift version 5.9.2 (swift-5.9.2-RELEASE)）と、ターゲット環境（例: Target: x86_64-unknown-linux-gnu や Target: x86_64-apple-darwin23.2.0）が表示されれば、Swiftツールチェインのインストールとパス設定は成功です。表示されるバージョンが期待と異なる場合、パス設定や xcode-select の設定を見直す必要があります。特にLinuxやWSLでは、シェルの設定ファイル（.bashrc など）の変更後に source コマンドを実行したり、新しいターミナルを開いたりするのを忘れないようにしてください。

2. VS Codeの準備

Swiftツールチェインの準備ができたら、次にVS Code自体の準備を行います。

2.1 VS Codeのインストール

VS Codeは公式ウェブサイトから無料でダウンロードできます。利用しているOS（macOS, Windows, Linux）に合わせて適切なインストーラーをダウンロードし、指示に従ってインストールしてください。インストールプロセスは非常に簡単で、通常はインストーラーを実行し、デフォルト設定で進めれば問題ありません。

VS Code 公式ダウンロードページ

インストールが完了したら、VS Codeを起動してみましょう。初期設定やテーマの選択などを促される場合がありますが、これらは後からいつでも変更可能です。

2.2 VS Codeの基本的な使い方

VS Codeは非常に多機能なエディタですが、Swift開発を行う上で最低限知っておくべき基本的な機能を紹介します。これらの機能は、VS Codeを使ったあらゆる言語の開発に共通するものです。

サイドバー (Activity Bar): ウィンドウの一番左にあるアイコンの列です。ここから主要なビュー（エクスプローラー、検索、ソース管理、実行とデバッグ、拡張機能）を切り替えます。
サイドパネル (Side Bar): サイドバーで選択したアイコンに対応するパネルがここに表示されます。例えば、エクスプローラーを選択するとファイルツリーが表示されます。
エディタグループ: コードファイルを実際に編集する領域です。複数のファイルをタブで開いたり、画面を分割して複数のファイルを同時に表示したりできます。
パネル (Panel): ウィンドウの下部に表示される領域です。ここに統合ターミナル、Problemsビュー、出力ビュー、デバッグコンソールなどが表示されます。表示/非表示は Ctrl+J (Windows/Linux) または Cmd+J (macOS) で切り替えられます。
エクスプローラー (Explorer): サイドバーの一番上のアイコン。ファイルやフォルダの構造をツリー形式で表示します。プロジェクトフォルダを開くと、その内容がここに表示されます。ファイルを開いたり、新しいファイルやフォルダを作成したり、名前を変更したり、削除したりといったファイル操作をここから行えます。
検索 (Search): サイドバーの虫眼鏡アイコン。開いているファイルやプロジェクト全体のファイルの中から、特定の文字列を検索したり置換したりできます。正規表現や大文字小文字の区別、単語単位での検索など、詳細なオプションも利用できます。
ソース管理 (Source Control): サイドバーの分岐アイコン。Gitなどのバージョン管理システムと連携します。プロジェクトがGitリポジトリの場合、変更されたファイル、ステージングされているファイル、コミット履歴などがここに表示されます。変更のステージング、コミット、プッシュ、プルといった基本的なGit操作をVS CodeのGUIから行えます。SwiftPMプロジェクトは通常Gitで管理されるため、この機能は非常に便利です。
実行とデバッグ (Run and Debug): サイドバーの再生ボタンと虫アイコン。プログラムの実行、ブレークポイント設定、ステップ実行、変数の監視、コールスタックの表示など、デバッグを行うためのインターフェースです。後述するlaunch.jsonという設定ファイルと連携して動作します。
拡張機能 (Extensions): サイドバーの四角形が4つ並んだアイコン。VS Codeの機能を拡張するアドオンを検索、インストール、管理できます。Swift開発に必須となるSwift Language Serverとの連携やデバッグ機能を提供する拡張機能は、ここでインストールします。
コマンドパレット (Command Palette): Cmd+Shift+P (macOS) または Ctrl+Shift+P (Windows/Linux) で開きます。VS Codeのあらゆるコマンド（ファイルを開く、設定を変更する、特定の拡張機能の機能を実行するなど）を名前で検索して実行できる非常に便利なインターフェースです。? を入力すると、最近使用したコマンドやよく使うコマンドの候補が表示されます。「Show All Commands」を選択すると、全てのコマンドを一覧表示できます。拡張機能によって追加された機能も、多くの場合ここから実行します。
統合ターミナル (Integrated Terminal): Ctrl+~ (Windows/Linux) または Cmd+~ (macOS) で開きます。VS Codeウィンドウ内でコマンドライン操作ができます。プロジェクトのルートディレクトリで開かれることが多く、SwiftPMコマンド（swift build, swift run, swift testなど）を実行する際に非常に便利です。複数のターミナルセッションを開くことも可能です。デフォルトのシェルはOSの設定に基づきます（WindowsではPowerShellやcmd、Linux/macOSではBashやZshなど）。
設定 (Settings): File -> Preferences -> Settings (Windows/Linux) または Code -> Preferences -> Settings (macOS) で開きます。VS Codeのあらゆる設定を変更できます。ユーザー全体に適用されるユーザー設定と、特定のワークスペース（プロジェクト）にのみ適用されるワークスペース設定があります。ワークスペース設定は .vscode/settings.json ファイルとしてプロジェクト内に保存されるため、チームメンバーと共有できます。

2.3 VS Codeでの開発ワークフローの紹介

VS CodeでのSwift開発は、主に以下の要素を連携させて行います。

コード編集: エディタでSwiftソースコードを記述、編集します。Swift拡張機能とSwift Language Server (SourceKit-LSP) が連携し、リアルタイムのコード補完、構文チェック、エラー・警告表示、シンボルナビゲーション（定義へ移動、参照の検索など）、ホバー情報といった強力なインテリジェンス機能を提供し、正確かつ効率的なコーディングを支援します。
ビルドと実行: 統合ターミナルを開き、swift build や swift run といったSwiftPMコマンドを実行して、コードをコンパイルし、実行可能ファイルを生成したり、プログラムを実行したりします。エラーが発生した場合は、ターミナル出力やProblemsパネルで詳細を確認します。
テスト実行: 統合ターミナルで swift test コマンドを実行し、テストスイートを実行します。テスト結果はターミナルに表示されます。
デバッグ: コードにブレークポイントを設定し、VS Codeのデバッグ機能（実行とデバッグビュー）を使ってプログラムをデバッガー（CodeLLDB）の下で実行します。実行中のプログラムの状態（変数、コールスタック）を検査し、問題を特定します。launch.json ファイルでデバッグ対象や実行時の引数などを設定します。
コード品質管理: SwiftLintやSwiftFormatといったツールを導入し、VS Codeの拡張機能やタスク連携を通じて、コードのスタイルチェックや自動フォーマットを行います。ProblemsパネルにLintの警告が表示されたり、ファイルの保存時に自動的にコードが整形されたりするように設定することで、コードの一貫性を保ち、レビューの負担を軽減します。

これらの要素をVS Codeという単一のアプリケーション内でシームレスに行き来しながら開発を進めるのが、VS Codeを用いた開発スタイルです。エディタでのコーディング中に問題が見つかれば、Problemsパネルを確認し、必要に応じてターミナルでビルドやテストを実行し、さらに詳細な調査が必要であればデバッガーを起動する、といった流れで作業を進めます。

3. VS CodeにおけるSwift開発のための拡張機能

VS CodeをSwift開発に最適化するためには、Swift言語のサポートやデバッグ機能を提供するためのいくつかの重要な拡張機能をインストールする必要があります。これらの拡張機能は、VS Code Extension Marketplaceから簡単に入手できます。

3.1 必須の拡張機能

Swift (vscode-swift)

この拡張機能は、VS CodeでSwift開発を行う上での中核となります。Swift Language Server (SourceKit-LSP) と連携し、Swiftコードに対するリッチな編集機能を提供します。Language Server Protocol (LSP) は、様々なエディタと特定の言語の解析エンジン（Language Server）が通信するための標準プロトコルです。SourceKit-LSPは、AppleのSourceKitをラップし、LSPサーバーとして機能します。VS CodeのSwift拡張機能はLSPクライアントとして動作し、SourceKit-LSPサーバーと通信することで、以下の機能を実現します。

コード補完 (IntelliSense): 入力中のコードの文脈に応じて、利用可能なシンボル（クラス名、メソッド名、変数名、列挙型ケースなど）やコードスニペットの候補をリアルタイムに表示します。また、関数のシグネチャヘルプ（引数の情報など）も表示されます。これにより、タイピング量を減らし、APIの使い方を確認しながら正確にコーディングできます。
定義へ移動 (Go to Definition): カーソル位置にあるシンボルの定義元（変数や関数の宣言場所、クラスや構造体の定義場所など）にジャンプします。コードベースをナビゲートする際に非常に便利な機能です。
定義のプレビュー (Peek Definition): カーソル位置のシンボル定義を、現在編集中のファイルから移動せずに小さなウィンドウでプレビュー表示します。定義元を一時的に確認したい場合に便利です。
参照の検索 (Find All References): シンボルがコードのどこで使用されているかをプロジェクト全体で検索し、結果を一覧表示します。コードの理解やリファクタリングに役立ちます。
シンボルの名前変更 (Rename Symbol): 変数名や関数名、クラス名などのシンボル名を、コード全体で安全に変更します。関連する全ての箇所が自動的に更新されるため、手動での変更に伴うtypoや漏れのリスクをなくせます。
型の情報表示 (Hover Information): カーソルをシンボルに重ねると、その型情報、ドキュメントコメント、定義元の情報などがツールチップとして表示されます。APIの仕様を素早く確認できます。
診断 (Diagnostics): コンパイルエラーや警告、Lintツール（連携した場合）による規約違反などをリアルタイムに検出し、問題のある箇所に波線（赤はエラー、黄色は警告など）を表示します。これらの問題はProblemsパネル (View -> Problems) に一覧表示され、クリックすることで該当箇所にジャンプできます。
ドキュメントコメント: Swiftのドキュメントコメント (/// または /** */) を解析し、コードヒントやホバー情報として表示します。また、コメント入力時の補完機能も提供します。
コードアクション (Code Actions): エラーや警告が表示されている箇所で、電球アイコンが表示されることがあります。クリックすると、問題を自動的に修正したり、コードをリファクタリングしたりするための提案が表示されます（例: 不要なコードの削除、変数名の修正候補など）。

これらの機能は、Swift Language Serverがバックグラウンドでプロジェクトのコードを解析し続けることで提供されます。そのため、Language Serverが正常に起動し、使用しているSwiftツールチェインと連携できていることが、これらの機能を利用するための前提となります。

インストール方法:

VS Codeを開きます。
左側のサイドバーにある拡張機能アイコン (四角形が4つ並んだアイコン) をクリックします。
検索ボックスに Swift と入力します。
検索結果から Swift という名前の拡張機能（公開元が Swift Server Accounts または公式関連のもの）を見つけ、「Install」ボタンをクリックします。

インストール後、VS Codeを再起動することが推奨されます。プロジェクトフォルダを開いた際に、VS Codeウィンドウの右下隅にLanguage Serverの状態を示すメッセージ（「Language Server Starting…」、「Language Server Running」など）が表示されることがあります。

設定:

Swift拡張機能は、通常、システムにインストールされているアクティブなSwiftツールチェインを自動的に検出して利用します。macOSでは xcode-select で指定されたツールチェイン、Linux/WSLでは PATH 環境変数で最初に見つかるツールチェインが使用されます。

しかし、特定のツールチェインを指定したい場合や、複数のツールチェインがインストールされている環境でデフォルト以外を使いたい場合は、VS Codeの設定（File -> Preferences -> Settings または Code -> Preferences -> Settings）で swift と検索して設定項目を変更できます。

Swift: Toolchain Path: 使用するSwiftツールチェインのルートディレクトリへのパスを明示的に指定します。例えば、macOSでSwift.orgからインストールした特定のツールチェインを指定する場合、パスは /Library/Developer/Toolchains/Swift-5.x.x-RELEASE.xctoolchain のようになります。Linux/WSLで /opt/swift-5.9.2 に展開した場合、パスは /opt/swift-5.9.2 となります。この設定は、自動検出がうまくいかない場合や、プロジェクトごとに異なるSwiftバージョンを使いたい場合に役立ちます。空欄の場合は自動検出が試みられます。
その他の設定項目で、Language Serverのログレベルや挙動などを調整できますが、通常はデフォルト設定で問題ありません。

VS Code Remote – WSLやRemote – SSHを使用している場合は、リモート環境側で拡張機能が有効になっていることを確認してください。設定もリモート環境ごとに独立して管理されます。

CodeLLDB

SwiftコードをVS Code上でデバッグするためには、CodeLLDB拡張機能が必須です。CodeLLDBは、LLDBデバッガーとVS Codeのデバッグインターフェース（実行とデバッグビュー、ブレークポイント、変数ウォッチなど）を連携させる役割を果たします。これにより、VS Codeの使い慣れたGUIから、Swiftプログラムの実行制御や状態検査を行うことができます。

CodeLLDBは、C++やRustなど、他のLLVM 기반 언어의 디버깅에도 사용됩니다. Swift의 경우, Swift 툴체인에 포함된 LLDB를 사용합니다.

インストール方法:

VS Codeを開きます。
左側のサイドバーにある拡張機能アイコンをクリックします。
検索ボックスに CodeLLDB と入力します。
検索結果から CodeLLDB という名前の拡張機能（公開元が vadimcn）を見つけ、「Install」ボタンをクリックします。

インストール後、VS Codeを再起動することが推奨されます。

CodeLLDBは、システムの lldb コマンドを自動的に検出して使用します。Swiftツールチェインに含まれる lldb が利用されるため、Swiftツールチェインが正しくインストールされ、実行可能パス (PATH) が通っていることが重要です。CodeLLDB拡張機能自体の設定（lldb.executable など）で、使用するLLDBのパスを明示的に指定することも可能ですが、通常はデフォルトの自動検出で問題ありません。

VS Code Remote – WSLやRemote – SSHを使用している場合は、リモート環境側でCodeLLDB拡張機能が有効になっていることを確認し、リモート環境のLLDB実行ファイルが正しく検出されているか確認してください。

3.2 その他の便利な拡張機能

これらの拡張機能は必須ではありませんが、導入することでSwift開発の利便性や効率をさらに向上させることができます。

SwiftLint: Swiftコードのスタイルや規約をチェックするツール「SwiftLint」との連携を強化する拡張機能です。SwiftLint自体は別途インストールが必要ですが、この拡張機能を入れることで、VS Code上でリアルタイムにLint結果（規約違反）を波線やProblemsパネルで表示したり、ファイル保存時に自動でチェックを実行したりといった連携が可能になります。複数のSwiftLint関連拡張機能が存在するため、機能やメンテナンス状況を見て選択してください。
SwiftFormat: Swiftコードを自動的にフォーマットするツール「SwiftFormat」との連携を強化する拡張機能です。SwiftFormat自体は別途インストールが必要ですが、この拡張機能を入れることで、コマンドパレットからコードフォーマットを実行したり、ファイルの保存時に自動的にコードを整形したりといった連携が可能になります。これにより、コードの見た目をチームやプロジェクト全体で統一しやすくなります。複数のSwiftFormat関連拡張機能が存在するため、機能やメンテナンス状況を見て選択してください。
Docker: Swift開発をDockerコンテナ内で行う場合に便利な拡張機能です。DockerfileやDocker Composeファイルを編集する際の補完や構文チェック、コンテナの管理（起動、停止、ログ表示など）機能を提供します。
Remote – SSH / Remote – WSL: これらの拡張機能は、VS Codeの「Remote Development」拡張機能パックの一部です。Remote – WSLはWindows上でWSL2環境での開発を、Remote – SSHはSSH接続可能なリモートサーバー上での開発を、あたかもローカルで開発しているかのようにシームレスに行えるようにします。VS Code本体はローカルで動作しつつ、ファイルアクセス、ターミナル、実行、デバッグなどは全てリモート環境で行われます。Windows + WSLでSwift開発を行う場合は、Remote – WSL拡張機能の利用が必須レベルで推奨されます。

これらの拡張機能も、VS Codeの拡張機能ビューで名前を検索して「Install」ボタンをクリックすることでインストールできます。リモート環境で開発する場合は、忘れずにリモート環境側にも必要な拡張機能をインストールしてください。

4. SwiftToolchainのインストールと設定 (プラットフォーム別詳細)

前述の基本的な説明に加え、各プラットフォームでのツールチェインインストールについて、より詳細な手順と遭遇しうる問題への対処法を解説します。

4.1 macOSでのインストールと設定の詳細

macOSでSwift開発を行う場合、主にXcodeをインストールする方法と、Swift.orgからツールチェインをダウンロードする方法があります。どちらの方法もシステムにSwiftツールチェインをインストールし、VS Codeやターミナルから利用可能にする点では共通しますが、管理方法や適用範囲が異なります。

方法1: Xcodeをインストールする (最も簡単で推奨)

手順: Mac App Storeから「Xcode」を検索し、インストールします。インストールにはかなりのディスク容量と時間が必要です。インストール完了後、Xcodeを一度起動して利用許諾契約に同意する必要があります。
利点:
- macOS、iOS、watchOS、tvOSなどAppleプラットフォーム向けのネイティブアプリケーション開発に必要な全てが揃います。
- 最新版の安定版Swiftツールチェインが含まれており、Appleプラットフォーム開発で標準的に使用されるバージョンが提供されます。
- Command Line Toolsも含まれているため、別途インストールする必要はありません。
- システムは自動的にXcode内のツールチェインをデフォルトとして認識し、/usr/bin/swift などのコマンドがXcode内の実行ファイルにリンクされます（xcode-select が自動で設定されます）。VS CodeのSwift拡張機能も、このデフォルト設定をそのまま利用できます。
注意点: Xcodeは非常に大容量です。CLIツール開発やサーバーサイド開発のみを行いたい場合でも、Xcode全体をインストールする必要があります。古いmacOSバージョンでは、最新版のXcodeをインストールできない場合があります。
確認: Xcodeインストール後、ターミナルで swift --version を実行し、Xcodeに同梱されているバージョンの情報が表示されるか確認します。また、xcode-select --print-path でXcodeのDeveloperディレクトリ (/Applications/Xcode.app/Contents/Developer) が表示されることを確認します。これが正しく設定されていれば、システム全体でXcodeのツールチェインが使用されます。

方法2: Swift.orgからツールチェインをインストールする

特定のSwiftバージョンを使いたい場合や、Xcodeをインストールしたくない（またはできない）場合に利用します。これにより、Xcodeとは独立したSwift環境を構築できます。

手順:
1. Swift.orgのダウンロードページ (https://www.swift.org/download/) を開きます。
2. macOS向けの、利用したいSwiftバージョンとReleaseタイプ（例えば、「Swift 5.10 Release」など）を選択します。
3. 「macOS」セクションにある「macOS (x86_64)」または「macOS (ARM64)」(.pkgファイル) をダウンロードします。利用しているMacのCPUアーキテクチャに合わせて選択してください（Intel Macならx86_64、Apple Silicon MacならARM64）。.pkg ファイルは、Macの標準インストーラーで実行可能なパッケージファイルです。
4. ダウンロードした .pkg ファイルを実行し、インストーラーの指示に従ってインストールします。デフォルトでは /Library/Developer/Toolchains/ ディレクトリ以下に、Swift-5.x.x-RELEASE.xctoolchain のような名前のディレクトリとしてインストールされます。このディレクトリは、Xcodeのツールチェインディレクトリと同じ場所に配置されるため、システムに認識されやすくなります。
5. Command Line Toolsのインストール: Xcodeをインストールしていない場合、git, make などの基本的な開発ツールが含まれるCommand Line Toolsがインストールされていない可能性があります。ターミナルで xcode-select --install を実行してインストールしておきます。
6. アクティブなツールチェインの設定 (xcode-select): インストールしたツールチェインをターミナルやVS Codeでデフォルトで利用するためには、xcode-select コマンドでそのツールチェインをアクティブに設定する必要があります。
  bash sudo xcode-select --switch /Library/Developer/Toolchains/Swift-5.x.x-RELEASE.xctoolchain
  (Swift-5.x.x-RELEASE.xctoolchain の部分は、インストールされたツールチェインの正確なディレクトリ名に置き換えてください。バージョンやアーキテクチャが含まれている場合があります。) このコマンドはシステム全体の設定を変更するため、管理者権限（sudo）が必要です。
7. 特定のプロジェクトでバージョンを固定する場合: xcode-select でシステム全体のツールチェインを切り替える代わりに、特定のプロジェクトで特定のツールチェインを使いたい場合があります。この場合、VS Codeの設定 (Swift: Toolchain Path) でプロジェクトの .vscode/settings.json にツールチェインのパスを記述するか、direnvのようなツールを使ってディレクトリに入ったときに PATH を一時的に変更するといった方法があります。
利点: XcodeをインストールせずにSwift開発環境を構築できます。特定のSwiftバージョン（例えば、開発中の次のメジャーバージョンなど）を試したり、厳密に管理したい場合に便利です。よりミニマルな開発環境を好む場合に適しています。
注意点: xcode-select で切り替えたツールチェインは、Xcode自体を含むシステム全体で使用される開発者ツール（git, clang など）のパスにも影響を与える可能性があります。予期しない挙動を引き起こす可能性もあるため、システム全体で使うツールチェインは慎重に選択する必要があります。複数のツールチェインを頻繁に切り替えたい場合は、プロジェクトごとの設定やツールを使う方が安全な場合があります。
確認: ターミナルで swift --version を実行し、xcode-select で指定したバージョンの情報が表示されるか確認します。which swift コマンドで、/Library/Developer/Toolchains/.../usr/bin/swift のようなパスが表示されれば、Swift.orgからインストールしたツールチェインが使われています。VS CodeのSwift拡張機能も、この設定を自動的に認識して利用するはずです。

4.2 Linuxでのインストールと設定の詳細 (Ubuntuを例に)

Linux上でSwiftをインストールする場合、Swift.orgから公式バイナリをダウンロード・展開し、パスを設定するのが最も信頼できる方法です。利用しているLinuxディストリビューションとSwiftのバージョンによって手順や必要な依存関係が異なります。

手順:
1. 依存関係の確認とインストール: Swiftツールチェインが動作するために必要なライブラリやツールをインストールします。Swift.orgのダウンロードページで、利用したいSwiftバージョンとLinuxディストリビューションに対応したセクションに記載されている依存関係のリストを確認します。そして、パッケージマネージャー（Ubuntuならapt）を使って必要なパッケージをインストールします。一般的なUbuntu LTS版の依存関係は前述の通りですが、バージョンによって微妙に異なる可能性があるため、公式情報を確認することが重要です。
  bash sudo apt update sudo apt install -y clang libicu-dev libpython3.dev libcurl4 libxml2 libz3-dev libssl-dev libsqlite3-dev libncurses5-dev libncursesw5-dev libedit-dev libasan6 libtsan0 libatomic1 libuuid1 libdispatch5 libobjc4 libbsd-dev # libbsd-dev も追加されている場合がある # その他の必要な依存関係も確認し、インストール
2. ツールチェインのダウンロード: Swift.orgのダウンロードページから、利用したいSwiftバージョンとLinuxディストリビューション（例: Ubuntu 22.04）に対応した .tar.gz ファイルをダウンロードします。適切なアーキテクチャ（x86_64）を選択します。
  bash # 例: Ubuntu 22.04 (Jammy) 向けの Swift 5.10 をダウンロード # URLはバージョンやOSによって変わるので注意！ wget https://download.swift.org/swift-5.10.1-release/ubuntu2204/swift-5.10.1-RELEASE/swift-5.10.1-RELEASE-ubuntu22.04.tar.gz
  wget コマンドはファイルをダウンロードします。ダウンロードが完了するまで待ちます。
3. アーカイブの展開: ダウンロードしたファイルを任意のディレクトリに展開します。システム全体で利用可能にしたい場合は /opt/swift などに展開し、root権限で行います。個人的な開発環境であれば、ホームディレクトリ以下に展開するのが手軽です。例えば、~/swift ディレクトリに展開する場合：
  bash mkdir ~/swift # 展開先のディレクトリを作成 tar xzf swift-5.10.1-RELEASE-ubuntu22.04.tar.gz -C ~/swift --strip-components=1 # --strip-components=1 オプションは、tarball内の最上位ディレクトリ（例: swift-5.10.1-RELEASE）を取り除き、 # アーカイブの内容（usr/, var/ など）を直接指定したディレクトリ（~/swift）の下に展開します。 # これにより、~/swift/usr/bin/... のようなパスになります。 # システム全体 (/opt) に展開する場合は sudo を付けて同様に行います。例: # sudo mkdir /opt/swift # sudo tar xzf swift-5.10.1-RELEASE-ubuntu22.04.tar.gz -C /opt/swift --strip-components=1
  --strip-components=1 を使用しない場合、展開後のディレクトリ構造は ~/swift/swift-5.10.1-RELEASE/... のようになります。その場合、次のPATH設定でこの中間ディレクトリを含める必要があります。
4. 環境変数 PATH の設定: 展開したツールチェインの usr/bin ディレクトリにパスを通します。これにより、どのディレクトリからでも swift や swiftc コマンドが実行できるようになります。この設定は、ユーザー単位で行うのが一般的です。使用しているシェルの設定ファイル（.bashrc, .zshrc, .profile など）を開き、以下の行を追加します。エディタ（nano ~/.bashrc など）でファイルを開き、ファイルの末尾などに追記します。
  bash # ~/.bashrc または ~/.zshrc を編集 export SWIFT_TOOLCHAIN_ROOT="$HOME/swift" # 展開先のパスに合わせて変更 export PATH="$SWIFT_TOOLCHAIN_ROOT/usr/bin:$PATH"
  $HOME はホームディレクトリを表す環境変数です。フルパスで指定しても構いません。例えば /opt/swift に展開した場合は export SWIFT_TOOLCHAIN_ROOT="/opt/swift" となります。
  変更を保存した後、新しいターミナルセッションを開始するか、設定ファイルを再読み込みします。
  bash source ~/.bashrc # または source ~/.zshrc, source ~/.profile
  .profile はログイン時に一度だけ読み込まれるのに対し、.bashrc や .zshrc は新しいインタラクティブシェルセッションが開始されるたびに読み込まれます。通常は .bashrc または .zshrc に記述する方が便利です。
代替手段：公式インストールスクリプト: Swift.orgは、インストールを容易にするための公式インストールスクリプト (install-swift.sh) も提供しています。これはSwift.orgのダウンロードページからダウンロードできます。スクリプトを実行するだけで、依存関係のインストール、ツールチェインのダウンロード、展開、PATH設定までを自動で行ってくれます。ただし、スクリプトの内容を十分に確認してから実行するか、手動でのインストールを選択する方が、何が行われるかを把握しやすいため、より安全な場合もあります。
bash # スクリプトをダウンロード (URLはバージョンによって異なる) wget https://download.swift.org/swift-5.10.1-release/ubuntu2204/swift-5.10.1-RELEASE/install-swift.sh # スクリプトを実行 chmod +x install-swift.sh ./install-swift.sh
スクリプトは依存関係のインストールで sudo を要求したり、PATH設定のためにシェルの設定ファイルを書き換えたりします。
代替手段：Docker: Swiftの公式Dockerイメージも提供されています。Swift.orgのDocker Hubページ (https://hub.docker.com/_/swift) で利用可能なイメージを確認できます。例えば、docker run -it swift:5.10.1-jammy /bin/bash でコンテナを起動し、その中でSwiftコマンドを実行できます。開発環境全体をDockerコンテナ内に構築したい場合は、これらのイメージを利用するのが効率的です。この方法は、VS CodeのRemote – Containers拡張機能と組み合わせて利用できます（後述）。
利点: Linux上でSwift開発が可能です。サーバーサイド開発やCLIツール開発に適しています。Swiftのクロスプラットフォーム性を活かした開発ができます。
注意点: 利用しているLinuxディストリビューションとSwiftのバージョンによって必要な依存関係が異なるため、公式ドキュメントの確認は必須です。システム全体にインストールする場合はroot権限が必要になります。パスの設定を誤ると、Swiftコマンドが認識されません。シェルの設定ファイル（.bashrcなど）の変更後に設定を反映させるのを忘れがちです。
確認: 新しいターミナルを開き、swift --version を実行してバージョンが表示されるか確認します。which swift コマンドで、設定したパスのSwiftバイナリ (/home/your_user/swift/usr/bin/swift や /opt/swift/usr/bin/swift) が選択されているか確認することも有効です。VS Codeの統合ターミナルでも同様に確認し、VS Codeが正しいSwiftツールチェインを見ていることを確認します。

4.3 Windowsでのインストールと設定の詳細 (WSL2 + Ubuntuを推奨)

WindowsでのSwift開発は、WSL2とLinux環境を組み合わせるのが最も現実的で推奨される方法です。これにより、Windowsのデスクトップ環境の利便性と、Linux版Swiftの互換性・安定性を両立できます。

手順:
1. WSL2のインストールとUbuntuのセットアップ: まだWSL2をセットアップしていない場合は、Microsoftの公式ドキュメント (https://learn.microsoft.com/ja-jp/windows/wsl/install) に従ってインストールします。Windows 10 バージョン 2004 以降または Windows 11 では、管理者権限のPowerShellまたはコマンドプロンプトで wsl --install を実行するだけで、必要な機能の有効化、WSLカーネルのダウンロード、Ubuntuディストリビューションのインストールが自動で行われます。インストールが完了すると、Ubuntuの初期設定（ユーザー名とパスワードの設定）を求められます。
2. WSL2内のUbuntuを起動: スタートメニューから「Ubuntu」を起動します。または、PowerShellやコマンドプロンプトで wsl コマンドを実行することでもWSLのデフォルトディストリビューション（通常はUbuntu）を起動できます。WSL2のUbuntuターミナルが表示されたら、その環境内でSwift開発環境を構築します。
3. Ubuntu上でSwiftツールチェインをインストール: WSL2で起動したUbuntu環境上で、前述の「Linuxの場合」の手順に従ってSwiftツールチェインをインストールします。これは、依存関係のインストール (sudo apt install ...)、Swiftバイナリのダウンロード・展開 (tar xzf ...)、PATH 環境変数の設定（.bashrc などへの追記）といった手順を、WSL2のUbuntuターミナル上で実行することを意味します。Windows側のファイルシステム（例えば C:\Users\YourUser\Documents）はWSL環境から /mnt/c/Users/YourUser/Documents のようにアクセスできますが、Swiftプロジェクトのコードやビルド成果物は、WSLのファイルシステム（例えば ~/ や /home/your_user/ 以下）に置くことを強く推奨します。これは、WSL2とWindows間でファイルアクセスを行う際のパフォーマンスオーバーヘッドを避けるためです。
4. VS Code Remote – WSL拡張機能のインストール: WindowsホストOS上で実行されているVS Codeに「Remote – WSL」拡張機能をインストールします。VS Code Extension Marketplaceを開き、「Remote – WSL」で検索してインストールします。この拡張機能により、Windows上のVS Code GUIを使いながら、WSL2環境（ファイルシステム、シェル、ツールチェインなど）に透過的にアクセスできるようになります。
5. WSL内のフォルダをVS Codeで開く: Windows上のVS Codeから、コマンドパレット (Ctrl+Shift+P) を開きます。「Remote-WSL: Open Folder in WSL…」を選択し、WSL2内のプロジェクトフォルダ（例: /home/your_user/MySwiftProject）を選択します。初めてWSL内のフォルダを開く際は、VS Codeサーバーという軽量なプログラムがWSL内に自動的にダウンロード・インストールされ、VS Code本体と連携する準備が行われます。これにより、VS CodeはWSL環境をあたかもローカル環境のように扱えるようになります。
6. VS Code拡張機能のインストール (WSL環境): WSL内のフォルダをVS Codeで開くと、VS Codeは実質的にWSL環境で動作していることになります。この環境向けに、Swift開発に必要な拡張機能（Swift、CodeLLDBなど）をインストールする必要があります。VS Codeの拡張機能ビューを開くと、インストール済みの拡張機能が「LOCAL」と「WSL: Ubuntu」のように分けて表示されます。「WSL: Ubuntu」セクションで、Swift関連の拡張機能が表示されていない場合は、検索して「Install in WSL: Ubuntu」ボタンをクリックしてインストールします。これにより、拡張機能がWSL環境にインストールされ、WSL内のSwiftツールチェインやファイルシステムにアクセスして機能を提供できるようになります。WSL環境で有効になっている拡張機能は、拡張機能アイコンの横に「WSL」と表示されるようになります。Swift拡張機能やCodeLLDB拡張機能は、このWSL環境内でSwiftツールチェインを検出して使用します。
代替手段：実験的なWindowsネイティブ対応: Swift.orgでは、実験的なWindowsネイティブで動作するツールチェインも提供されています。これはMSYS2環境でビルドされており、GCCやClangのようなツールとの連携が必要です。しかし、依存関係の解決が難しかったり、VS Codeからのデバッグなどが安定していなかったりする場合があります。現時点では、ほとんどのユーザーにとってWSL2+Linuxの方法の方がはるかに簡単で安定しているため、Windowsネイティブ対応は特定の目的（例えば、WindowsネイティブGUIアプリケーションの開発など、まだ発展途上ですが）以外では推奨されません。
利点: Windows上でほぼ完全なLinuxのSwift開発環境を利用できます。Linux版Swiftの互換性、安定性、パフォーマンスを活用できます。VS CodeのRemote – WSL機能により、Windowsの快適なGUI（高DPIサポート、フォントレンダリング、ショートカットキーなど）を使いながら、WSL内の開発環境を利用できます。WindowsとLinuxの間でファイルやコマンドをシームレスに扱えます。
注意点: WSL2のセットアップが必要です。WindowsネイティブでのSwift開発ではありません（WSLという仮想化環境内）。Windows側のファイルシステム（/mnt/c/... 以下のファイル）をWSL環境から頻繁にアクセスすると、パフォーマンスが低下することがあります。Swift開発の作業ディレクトリはWSLのホームディレクトリ以下に置くことを強く推奨します。WSLのネットワーク設定によっては、外部サービスとの連携に工夫が必要な場合があります。
確認: VS CodeでWSL内のSwiftプロジェクトフォルダを開き、統合ターミナルを開きます（ターミナル上部に「WSL: Ubuntu」のように表示されます）。そこで swift --version を実行し、インストールしたバージョンの情報が表示されるか確認します。which swift コマンドで、WSL内のSwiftバイナリのパスが表示されるか確認します。VS Codeの拡張機能ビューで、Swift拡張機能やCodeLLDB拡張機能が「WSL: Ubuntu」にインストールされ、有効になっていることを確認します。これらの確認が全てOKであれば、VS CodeはWSL環境でSwift開発を行う準備ができています。

1.4 Swiftバージョンの確認 (再確認)

各プラットフォームでのツールチェインインストールが完了したら、改めてVS Codeの統合ターミナルを開き、以下のコマンドを実行して、正しく設定されたSwiftツールチェインが利用できるか確認しましょう。

bash swift --version

表示されるバージョン情報とターゲット環境が、あなたが意図したものであれば成功です。もし異なるバージョンが表示される場合や、コマンドが見つからないというエラーが出る場合は、前述のプラットフォーム別の「PATH環境変数の設定」や「xcode-select の設定」（macOSの場合）を見直し、設定を再読み込みするか新しいターミナルを開いて再度確認してください。VS CodeのSwift拡張機能やCodeLLDB拡張機能は、基本的にはVS Codeが起動したシェルの環境変数 PATH や xcode-select の設定を継承してツールチェインを見つけようとします。VS Codeの設定 Swift: Toolchain Path を明示的に設定している場合は、そのパスが優先されます。

SwiftツールチェインのインストールとVS Codeの基本的な準備、必要な拡張機能のインストールが完了すれば、いよいよVS Codeを使ってSwiftプロジェクトを扱い始める準備が整います。

5. VS CodeでのSwiftプロジェクト作成と基本操作

SwiftツールチェインとVS Code、必要な拡張機能の準備ができたら、実際にプロジェクトを作成して基本操作を試してみましょう。ここでは、SwiftPM (Swift Package Manager) を利用したプロジェクトを扱います。SwiftPMは、Swiftコードをパッケージとして管理するための公式ツールであり、VS CodeでのSwift開発において標準的なプロジェクト構造とワークフローを提供します。

5.1 SwiftPMプロジェクトの作成

VS CodeでSwift開発を行う場合、Swift Package Manager (SwiftPM) を利用したプロジェクト構造が標準的です。SwiftPMは、プロジェクトのビルド、実行、テスト、依存関係管理を一元的に行うためのコマンドラインツール swift コマンドを通じて操作します。

新しいSwiftPMプロジェクトを作成するには、VS Codeの統合ターミナルを開き、プロジェクトを作成したいディレクトリに移動して、以下のコマンドを実行します。

“`bash

プロジェクト用のディレクトリを作成（例: MySwiftProject）

mkdir MySwiftProject
cd MySwiftProject

SwiftPMプロジェクトを初期化

プロジェクトのタイプを指定します。

–type executable: 実行可能ファイルを生成するCLIツールなどを開発する場合（デフォルト）。

–type library: 再利用可能なライブラリを開発する場合。

–type system-module: システムライブラリのラッパーパッケージを作成する場合。

–type manifest: パッケージマニフェストファイルのみを作成する場合。

一般的には、CLIツールや実行可能なサーバーサイドアプリ開発であれば executable、

共通コードや機能をまとめる場合は library を選択します。

例: 実行可能なCLIツールを作成する場合

swift package init –type executable
“`

このコマンドを実行すると、指定したディレクトリ（MySwiftProject）内にSwiftPMプロジェクトの基本的なファイル構造が自動的に作成されます。

作成される主なファイルとディレクトリ:

Package.swift: パッケージマニフェストファイル。これはSwiftコードで記述されており、パッケージの名前、対応するSwiftツールのバージョン (swift-tools-version)、依存する他のパッケージ (dependencies)、このパッケージが提供するプロダクト（実行可能ファイルやライブラリ）、そしてプロダクトを構成するターゲット (targets) などが記述されます。SwiftPMはこのファイルを読み込んで、プロジェクトのビルド方法や依存関係を解決します。VS CodeのSwift拡張機能も、このファイルを解析してインテリジェンス機能を提供します。
Sources/: ソースコードを配置するディレクトリ。このディレクトリの直下には、各ターゲットに対応するサブディレクトリが作成されます。例えば、実行可能ターゲット MySwiftProject を持つプロジェクトの場合、Sources/MySwiftProject/ ディレクトリが作成され、その中にターゲットのソースファイル（例: main.swift）を配置します。ライブラリターゲット MyLibrary の場合は Sources/MyLibrary/ が作成されます。
- Sources/MySwiftProject/main.swift: --type executable で初期化した場合に作成される、実行可能ターゲットのエントリポイントとなるファイル。簡単なサンプルコード (print("Hello, world!")) が含まれています。
- Sources/MyLibrary/MyLibrary.swift: --type library で初期化した場合に作成される、ライブラリターゲットのサンプルファイル。
Tests/: テストコードを配置するディレクトリ。こちらもターゲットに対応するサブディレクトリが作成されます。例えば、MySwiftProject ターゲットに対応するテストコードは Tests/MySwiftProjectTests/ に配置され、サンプルテストファイル（例: MySwiftProjectTests.swift）が含まれます。
.gitignore: Gitが追跡しないファイルやディレクトリを指定するファイル。SwiftPMはビルド時に .build/ ディレクトリを生成したり、依存関係をキャッシュしたりしますが、これらのファイルはバージョン管理システムに含めるべきではないため、.gitignore にデフォルトで .build/ などが記述されています。
.vscode/ (後で作成される): VS Code固有の設定ファイル（launch.json, tasks.json, settings.json など）を格納するディレクトリ。

実行可能形式 (--type executable) で初期化した場合、Sources/MySwiftProject/main.swift というファイルが作成され、簡単なサンプルコード (print("Hello, world!")) が含まれています。このファイルは、プログラムのエントリポイントとなります。

5.2 VS Codeでプロジェクトを開く

作成したSwiftPMプロジェクトディレクトリをVS Codeで開きます。

VS Codeを開きます。
File -> Open Folder... を選択します。
作成したプロジェクトディレクトリ (MySwiftProject) を選択して「開く」ボタンをクリックします。

WSL上でプロジェクトを作成した場合は、VS Code Remote – WSL拡張機能を利用して、WSL内のプロジェクトディレクトリを開いてください（前述の「Windowsでのインストールと設定の詳細」を参照）。Windows側のパスではなく、WSL内のLinuxパス（例: /home/your_user/MySwiftProject）を指定して開く必要があります。

プロジェクトフォルダを開くと、VS Codeのエクスプローラー（サイドバーの一番上）にプロジェクトのファイル構造が表示されます。Package.swift ファイルや Sources/、Tests/ ディレクトリが見えるはずです。

5.3 Swift拡張機能によるLanguage Serverの起動と連携確認

プロジェクトフォルダを開くと、VS CodeにインストールされているSwift拡張機能が自動的にアクティブになり、Swift Language Server (SourceKit-LSP) を起動しようとします。Language Serverはバックグラウンドで動作し、プロジェクトのSwiftファイルを解析します。VS Codeウィンドウの右下隅にLanguage Serverの状態を示すメッセージ（「Language Server Starting…」、「Language Server Running」など）が表示されることがあります。初回起動時や大規模なプロジェクトでは、解析に少し時間がかかる場合があります。

Language Serverが正常に起動し、プロジェクトのコードを解析できると、VS Codeは様々なインテリジェンス機能を提供し始めます。これらの機能は、Swiftコードの編集時に非常に役立ちます。

Sources/MySwiftProject/main.swift ファイルを開いてみましょう。
コード内の変数名（例: text）や関数名（例: print）にカーソルを重ねると、その型情報やドキュメントコメントがツールチップとして表示されるはずです（ホバー情報）。
print( と入力してみると、print 関数の引数やオーバーロードの候補が表示されるはずです（シグネチャヘルプとコード補完）。
print("Hello, world!") の print 関数名を選択し、右クリックメニューから「Go to Definition」を選択してみてください。もし標準ライブラリのソースコードがツールチェインに含まれていれば、print 関数の定義箇所（通常は組み込みSwiftライブラリのファイル）にジャンプできるはずです。
意図的にコードに間違い（例えば、セミコロンを付け忘れる、変数の型と異なる値を代入するなど）を加えてファイルを保存してみてください。問題のある行に赤い波線が表示され、Problemsパネル (View -> Problems または Ctrl+Shift+M / Cmd+Shift+M) にエラーや警告が一覧表示されるはずです。波線やProblemsパネルのエントリにカーソルを重ねると、エラーや警告の詳細メッセージが表示されます。

これらの機能（ホバー情報、コード補完、定義ジャンプ、診断）が正しく動作していれば、Swift Language Serverが正常に機能しており、VS CodeがSwiftコードを解析できていることを意味します。これらの機能は、VS Codeでの快適なSwift開発において非常に重要です。

もしLanguage Serverが起動しない、またはインテリジェンス機能が全く機能しない場合は、前述の「トラブルシューティング」セクションを参照し、Swiftツールチェインのパス設定が正しくないか、VS CodeのSwift拡張機能の設定に問題がある可能性があるかを確認してください。VS Codeの設定で Swift: Toolchain Path が空欄になっているか、システムのアクティブなツールチェインを指しているか確認します。特定のツールチェインを指定したい場合は、そのパスを正確に入力します。Remote開発の場合は、リモート側の拡張機能やツールチェイン設定を確認する必要があります。

5.4 SwiftPMコマンドの実行

VS Codeの統合ターミナルを使って、SwiftPMの各種コマンドを実行します。これにより、コードの編集とビルド・実行・テストのサイクルをVS Code内で行うことができます。プロジェクトフォルダを開いた状態で統合ターミナルを開くと、カレントディレクトリは通常プロジェクトのルートディレクトリになります。

依存関係の解決とフェッチ: プロジェクトが依存する外部パッケージがある場合、最初にそれらをダウンロードして解決する必要があります。SwiftPMプロジェクトを初めて開いた際や、Package.swift に新しい依存関係を追加・変更した後に必要になります。
bash swift package resolve # 依存関係を解決してPackage.resolvedファイルを生成/更新 swift package fetch # 依存関係のコードをダウンロード
通常は、ビルドや実行コマンド (swift build, swift run, swift test) を実行した際に、必要に応じてこれらの処理が自動的に行われます。しかし、明示的に実行したい場合にこれらのコマンドを使います。
ビルド: プロジェクトのソースコードをコンパイルし、実行可能ファイルやライブラリを生成します。
bash swift build
このコマンドを実行すると、SwiftPMは Package.swift を読み込み、依存関係の解決（必要であれば）、ソースコードのコンパイル、モジュールのリンクなどのビルドプロセスを実行します。ビルド成果物はプロジェクトのルートディレクトリに生成される .build/ ディレクトリ以下に配置されます（デバッグビルドなら .build/debug/、リリースビルドなら .build/release/）。初回ビルド時は依存関係のダウンロードやキャッシュの生成などで時間がかかる場合があります。
ビルドに成功すると、実行可能ファイル（例えば、MySwiftProject プロジェクトの実行可能ターゲットなら ./.build/debug/MySwiftProject）やライブラリファイルが生成されます。
特定のビルド設定（例えばリリースビルド）でビルドしたい場合はオプションを指定します。
bash swift build -c release # リリースビルド
実行: 実行可能ターゲットをビルドし、そのまま実行します。
bash swift run
このコマンドは、まず swift build を実行してコードが最新であることを確認し、その後生成された実行可能ファイルを走らせます。もし Package.swift に複数の実行可能ターゲットが定義されている場合は、どのターゲットを実行するか指定する必要があります (swift run MyTargetName)。デフォルトの main.swift ファイルであれば、「Hello, world!」とターミナルに表示されるはずです。プログラムにコマンドライン引数を渡したい場合は、コマンドの後に -- を挟んで引数を記述します (swift run MySwiftProject -- arg1 arg2)。
テスト: テストターゲットのコードをビルドし、ユニットテストを実行します。
bash swift test
このコマンドは、Tests/ ディレクトリ内のテストコードをコンパイルし、テストスイートを実行します。テスト結果（成功/失敗、実行時間など）がターミナルに表示されます。特定のテストケースやテストメソッドのみを実行したい場合は、オプションや引数で指定できます (swift test --filter MyTests.testSomething)。
クリーン: ビルド成果物やキャッシュを削除します。
bash swift package clean
ビルド関連の問題が発生した場合や、容量を解放したい場合に実行します。

これらのコマンドは、VS Codeの統合ターミナルから直接実行することで、エディタでのコード編集とコマンド実行をスムーズに行えます。VS Codeのタスク機能（tasks.json）を利用して、これらのコマンドをより簡単に実行したり、ショートカットキーに割り当てたりすることも可能です（後述）。

6. デバッグ設定

コードに問題が発生した場合、デバッガーを使ってプログラムの実行をステップ実行したり、変数の値を調べたりすることが不可欠です。VS CodeでSwiftコードをデバッグするためには、CodeLLDB拡張機能と、VS Codeがデバッグセッションを開始するための設定ファイルである launch.json が必要です。

6.1 `launch.json` ファイルの作成

VS Codeでデバッグを行うには、実行・デバッグの設定を記述した launch.json ファイルが必要です。このファイルは、プロジェクトのルートディレクトリにある .vscode/ ディレクトリ内に配置されます。

VS Codeの「実行とデバッグ」ビュー（左サイドバーの再生ボタンと虫アイコン）を開きます。
サイドバーの上部にある歯車アイコンをクリックするか、「create a launch.json file」というリンクをクリックします。
デバッグ環境を選択するよう求められたら、インストール済みのデバッガー拡張機能のリストから「Swift」を選択します。（もしSwiftが表示されない場合は、Swift拡張機能とCodeLLDB拡張機能が正しくインストール・有効化されているか確認してください。）

Swift拡張機能がインストールされていると、SwiftPMプロジェクトの構造を認識し、実行可能ターゲットやテストターゲットをデバッグするためのデフォルトの launch.json 設定を生成してくれます。デフォルト設定は、多くの場合、SwiftPMの実行可能ターゲットやテストターゲットをデバッグするのに適しています。

生成される launch.json の例（内容を補足）：

“`json
{
// Use IntelliSense to learn about possible attributes.
// Hover to view descriptions of existing attributes.
// For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
“version”: “0.2.0”, // launch.jsonファイルのバージョン
“configurations”: [ // デバッグ設定のリスト
{
“type”: “lldb”, // 使用するデバッガーのタイプ。CodeLLDB拡張機能が提供する”lldb”を指定します。
“request”: “launch”, // デバッグセッションのタイプ。”launch”はプログラムを起動してデバッグ、”attach”は実行中のプロセスにアタッチ。
“name”: “Run MySwiftProject”, // デバッグ設定の名前。VS Codeの実行とデバッグビューの上部ドロップダウンリストに表示されます。分かりやすい名前を付けましょう。
// “program”: プログラム実行可能ファイルのパスを指定します。
// ${workspaceFolder} は現在のワークスペース（プロジェクトフォルダ）の絶対パスを指すVS Code変数です。
// Swift拡張機能は、${product:TargetName} のような変数を解決して、指定したターゲット名のビルド成果物のパスを自動的に生成します。
“program”: “${workspaceFolder}/.build/debug/${product:MySwiftProject}”,
// 上記の変数を使わない場合、手動で指定することもできます。ただし、プロジェクト名やビルドタイプに依存するため、手動指定は推奨されないことが多いです。
// 例: “program”: “${workspaceFolder}/.build/debug/MySwiftProject”,

        "args": [], // プログラムに渡すコマンドライン引数を文字列の配列で指定します。例: ["input.txt", "--verbose"]
        "cwd": "${workspaceFolder}", // プログラム実行時のカレントディレクトリを指定します。通常はプロジェクトルートである ${workspaceFolder} で問題ありません。ファイルパスなどの解決に影響します。
        "preLaunchTask": "swift build", // デバッグセッション開始前に実行するタスクのラベルを指定します。通常はプロジェクトをビルドするタスクを指定し、常に最新の実行可能ファイルをデバッグ対象とします。後述のtasks.jsonと連携します。
        // "stopOnEntry": true // プログラム起動直後に一時停止するかどうか (true/false)。
        // "externalConsole": false // 外部コンソールウィンドウを使うかどうか (true/false)。通常はfalseでVS Codeのデバッグコンソールを使用します。
    },
    {
        "type": "lldb",
        "request": "launch",
        "name": "Run MySwiftProject Tests", // テストターゲットをデバッグするための設定例
        "program": "${workspaceFolder}/.build/debug/${testproduct:MySwiftProjectTests}", // テスト実行可能ファイルのパス
        "args": [],
        "cwd": "${workspaceFolder}",
        "preLaunchTask": "swift build" // テスト実行可能ファイルもビルドが必要です
        // 追加設定例：特定のテストのみをデバッグしたい場合、argsでフィルターを指定します。
        // "args": ["--filter", "MySwiftProjectTests.MyTestSuite/testMethodName"]
    }
]

}
“`

この設定は、Run MySwiftProject という名前で、プロジェクトの実行可能ターゲット (MySwiftProject) をデバッグ実行するためのものです。program のパスは、swift build によって生成される実行可能ファイルのパスを指定しています。${product:MySwiftProject} という変数はSwift拡張機能が提供するもので、Package.swift ファイルで定義されたプロダクト名 MySwiftProject に対応するビルド成果物（実行可能ファイル）のパスを自動的に解決してくれます。これにより、パスを手動で変更する必要がなくなります。preLaunchTask は、デバッグ開始前に「swift build」という名前のタスクを実行するよう指定しています。これは、デバッグ対象のコードが常に最新の状態であることを保証するために重要です。

プロジェクトに複数の実行可能ターゲットやテストターゲットがある場合は、それぞれに対応するデバッグ設定 (configurations のエントリ) を追加する必要があります。Package.swift の targets セクションで定義されている名前を確認し、${product:TargetName} や ${testproduct:TestTargetName} を適切に記述します。

6.2 デバッグ実行前のタスク設定 (`tasks.json`)

上記の launch.json の設定で preLaunchTask": "swift build" と指定されていますが、これはVS Codeが .vscode/tasks.json ファイルで定義された「swift build」というラベルを持つタスクを探して実行することを意味します。通常、Swift拡張機能はSwiftPMプロジェクトを開くと自動的にSwiftPMのビルドタスク（swift build）やテストタスク（swift test）を検出して、VS Codeに登録してくれます。多くの場合、手動で tasks.json を編集する必要はありません。

自動検出されたタスクを確認するには、コマンドパレット (Ctrl+Shift+P / Cmd+Shift+P) を開き、「Tasks: Run Task」と入力してみてください。利用可能なタスクの一覧に「swift build」（または「swift build: debug」など）や「swift test」といった項目が表示されれば、設定はOKです。これらのタスクは、VS CodeがSwiftPMコマンドを実行するためのラッパーとして機能します。

もし自動検出されない場合や、カスタムなビルドオプション（例えば、特定のマニフェストファイルを使用する、特定のツールチェインでビルドする、特定の最適化レベルを設定するなど）を指定してビルドしたい場合は、手動で tasks.json ファイルを作成・編集してビルドタスクを定義できます。

コマンドパレットを開き、「Tasks: Configure Task」と入力します。
「Create tasks.json file from template」を選択します。
テンプレートの選択肢が表示されたら、「Others」を選択します。

これにより、プロジェクトの .vscode/ ディレクトリに tasks.json ファイルが作成されます。既存のSwiftPMタスクを編集するか、新しいビルドタスクやテストタスクを追加します。

json { "version": "2.0.0", // tasks.jsonファイルのバージョン "tasks": [ // タスクのリスト { "label": "swift build", // タスクのラベル。launch.jsonの preLaunchTask で参照されます。 "type": "shell", // タスクのタイプ。"shell"はシェルコマンドとして実行、"process"は直接プロセスとして実行。 "command": "swift build", // 実行するコマンド文字列。PATHが通っていればコマンド名のみでOK。 // Windows (WSL) の場合など、環境によってはコマンドパスをフルパスで指定する必要があるかもしれません。 // 例: "command": "/usr/bin/swift build" (WSL内でのパス) "options": { // コマンド実行時のオプション "cwd": "${workspaceFolder}" // コマンド実行時のカレントディレクトリ。通常はプロジェクトルート。 }, "problemMatcher": [ // コマンドの出力からエラーや警告を検出・解析し、Problemsパネルに表示するための設定 "$swiftc" // Swiftコンパイラの出力形式に対応した定義済みのProblem Matcher ], "group": { // このタスクがVS Codeの特定のタスクグループに属するかどうか "kind": "build", // このタスクをビルドタスクとして認識させる "isDefault": true // Ctrl+Shift+B / Cmd+Shift+B でデフォルトで実行されるビルドタスクに設定 }, "presentation": { // タスク実行時のターミナルパネルの表示設定 "reveal": "always", // タスク実行中は常にターミナルパネルを表示 "panel": "new" // 新しいターミナルパネルでタスクを実行 } }, // テストタスクなども追加可能 { "label": "swift test", // テストタスクのラベル "type": "shell", "command": "swift test", // 実行するコマンド "options": { "cwd": "${workspaceFolder}" }, // テスト結果は通常、標準出力にテストランナー独自の形式で表示されるため、Problemsパネルへの連携は不要なことが多いです。 // ただし、テスト中のコンパイルエラーなどは $swiftc Problem Matcherで捕捉できます。 "problemMatcher": [ "$swiftc" ], "group": "test", // このタスクをテストタスクとして認識させる "presentation": { "reveal": "always", "panel": "new" } } ] }

この tasks.json の設定により、「swift build」という名前で swift build コマンドをVS Code内で実行するタスクが定義されます。problemMatcher の $swiftc は、Swiftコンパイラ (swiftc コマンドの裏側で呼ばれます) が出力するエラーメッセージの形式をVS Codeが解析し、Problemsパネルに表示するための重要な設定です。これにより、ビルドエラーの箇所に素早くジャンプできるようになります。group の kind: "build" と isDefault: true を設定することで、Ctrl+Shift+B (Windows/Linux) または Cmd+Shift+B (macOS) というVS Codeの標準的なショートカットキーでこのビルドタスクを実行できるようになります。同様に、テストタスクを定義し、デバッグ設定で preLaunchTask: "swift test" のように指定することも可能です。

6.3 ブレークポイントの設定とデバッグ実行

launch.json と tasks.json の設定（あるいはSwift拡張機能による自動検出）が整えば、デバッグを開始できます。

デバッグしたいSwiftファイル (main.swift やテストファイルなど) を開きます。
プログラム実行中に一時停止させたい行にブレークポイントを設定します。ブレークポイントを設定したい行の行番号の左側（エディタの左端の余白部分）をクリックします。赤い丸が表示されればブレークポイントが設定されています。ブレークポイントは複数設定できます。
VS Codeの「実行とデバッグ」ビュー（左サイドバーの再生ボタンと虫アイコン）を開きます。
サイドバーの上部にあるドロップダウンリストで、実行したいデバッグ設定（例: Run MySwiftProject または Run MySwiftProject Tests）が選択されていることを確認します。
選択した設定の左側にある緑色の再生ボタン（「Start Debugging」または単に「Play」アイコン）をクリックするか、F5キーを押します。

デバッグが開始されると、VS Codeはまず launch.json の preLaunchTask で指定されたタスク（例: swift build）を実行します。タスクの実行状況はターミナルパネルや出力パネルに表示されます。ビルドが成功すると、CodeLLDB拡張機能が起動し、指定された実行可能ファイル（launch.json の program で指定されたパスのファイル）をデバッガーの下で起動します。

プログラムの実行は、最初に到達したブレークポイントで一時停止します。VS CodeのウィンドウがデバッグUIに切り替わり、サイドバーには変数、ウォッチ式、コールスタック、設定したブレークポイントの一覧が表示されます。

デバッグ中に利用できる機能（実行とデバッグビューのサイドバーや、エディタ上部に表示されるデバッグツールバー）：

変数 (Variables): 現在プログラムが一時停止しているスコープ内で利用可能なローカル変数、グローバル変数、引数などの名前、型、値が表示されます。変数の値を展開して、ネストしたプロパティなどを確認できます。
ウォッチ (Watch): 特定の変数名や式を登録し、プログラムが一時停止するたびにその値を自動的に評価して表示させることができます。複雑な式の値を追跡したい場合に便利です。
コールスタック (Call Stack): プログラムがブレークポイントで一時停止するまでの関数呼び出しの履歴が、スタックトレースとして表示されます。どの関数からどの関数が呼び出されたかを確認でき、各スタックフレーム（関数呼び出し）を選択すると、その時点でのローカル変数などを検査できます。
ブレークポイント (Breakpoints): 設定したブレークポイントの一覧が表示されます。ブレークポイントを一時的に無効にしたり、完全に削除したりできます。ブレークポイントの条件（特定の条件が満たされたときだけ停止）やヒットカウント（指定回数通過した後に停止）を設定することも可能です。
デバッグコンソール (Debug Console): パネルの下部に表示されます。プログラムからの標準出力 (print などで出力されたテキスト) がここに表示されるほか、デバッガーコマンド（LLDBコマンド）を直接入力したり、Swiftの式を入力して現在のスコープで評価したり（例: po myVariable で変数の内容を表示）できます。

エディタ上部または右クリックメニューからアクセスできるデバッグ操作ボタン（デバッグツールバー）：

Continue (F5): 現在一時停止している箇所から実行を再開し、次のブレークポイントに到達するか、プログラムが終了するまで実行を続けます。
Step Over (F10): 現在の行を実行し、次の行に進みます。現在の行が関数呼び出しを含んでいても、その関数の中には入らず、関数全体の実行を完了させてから次の行に進みます。
Step Into (F11): 現在の行が関数呼び出しであれば、その関数の中に入り、関数の最初の実行可能な行で一時停止します。関数内部の挙動を確認したい場合に利用します。
Step Out (Shift+F11): 現在実行中の関数から抜け出し、その関数を呼び出した箇所（呼び出し元の関数の、呼び出し直後の行）に戻って一時停止します。関数内部の詳細なステップ実行を終えて、呼び出し元に戻りたい場合に便利です。
Restart (Ctrl+Shift+F5 / Cmd+Shift+F5): 現在のデバッグセッションを終了し、プログラムの実行を最初からやり直します。コードを変更した場合や、最初からデバッグし直したい場合に利用します。
Stop (Shift+F5 / Shift+Cmd+F5): 現在のデバッグセッションを終了し、プログラムの実行を強制的に停止します。

これらの機能を使って、プログラムの実行フローを確認したり、変数がおかしい値になっていないか調べたりすることで、問題を特定しやすくなります。CodeLLDBはSwiftのデータ構造やクラスに対しても詳細な表示（po コマンドなど）をサポートしており、デバッグ体験はXcodeに近いものとなっています。

6.4 SwiftPMテストターゲットのデバッグ

launch.json には、テスト実行可能ファイルをデバッグするための設定 (Run MySwiftProject Tests など) も含まれています。この設定を使って、テストコード (Tests/ ディレクトリ内のファイル) にブレークポイントを設定し、swift test コマンドでテストを実行する際に、その実行中のプロセスにCodeLLDBをアタッチしてデバッグを行うことができます。テストが失敗する場合に、なぜ失敗するのかを詳しく調査するのに非常に役立ちます。テスト中に想定外の挙動をする箇所にブレークポイントを設定し、変数の状態などを確認しながら原因を特定します。launch.json の args にテストフィルターを指定することで、特定のテストケースのみをデバッグ実行することも可能です。

7. Lintとフォーマット

コードの品質と一貫性を保つために、LintツールとFormatterツールを導入することは非常に効果的です。チーム開発はもちろん、個人開発でも、統一されたコードスタイルはコードの可読性を高め、将来のメンテナンスを容易にします。Swift開発では、SwiftLintとSwiftFormatが広く利用されています。これらをVS Codeと連携させることで、コード編集時に自動的にチェックや整形を行うことができます。

7.1 SwiftLintの導入

SwiftLintは、Swiftコードのスタイルや規約を強制するための静的解析ツールです。AirbnbのSwiftスタイルガイドやRay WenderlichのSwiftスタイルガイドなど、コミュニティによってメンテされている主要なスタイルガイドに基づき、様々なルール（行の長さ、命名規約、空白文字、使用されていないコード、強制キャストの使用など）をチェックし、違反している箇所を警告またはエラーとして報告します。コードレビューの前に自動的にスタイル違反を検出できるため、レビューの負担を軽減し、より重要なロジックのレビューに集中できるようになります。

インストール方法:

SwiftLint自体はSwiftPMで配布されていますが、通常は実行可能なコマンドラインツールとしてシステムにインストールして利用します。主要なインストール方法は以下の通りです。

Homebrew (macOS/Linux): macOSやLinux（特にHomebrewがインストール可能な環境）で最も一般的なインストール方法です。
bash brew install swiftlint
Mint (macOS/Linux): MintはSwiftPMパッケージをビルドして実行可能なコマンドとしてインストールするためのツールです。SwiftPM依存関係としてSwiftLintを管理したい場合に便利です。先にMintをインストールする必要があります（通常Homebrewで brew install mint）。
bash mint install realm/swiftlint
Mintでインストールすると、通常 $MINT_ROOT/bin/ に実行ファイルが配置され、このディレクトリにパスが通っていれば swiftlint コマンドとして利用できます。
SwiftPM (プロジェクト内ツールとして): プロジェクトの Package.swift にSwiftLintを開発依存関係として追加し、プロジェクトのビルドプロセスの一部としてSwiftLintを実行する方法です。これにより、プロジェクトごとにSwiftLintのバージョンを固定し、開発者全員が同じバージョンのSwiftLintを使用するように強制できます。これはXcodeのBuild Phasesや、SwiftPMのビルドツールプラグイン機能（Swift 5.6以降）を利用して実現されます。
Package.swift に以下を開発依存関係として追加します。
swift // Package.swift // ... dependencies: [ // 実行時依存関係 // ... ], targets: [ // ... 既存のターゲット ... ], // 開発ツールなどの依存関係はここに記述することが多い // Swift 5.6 以降でビルドツールプラグインを使用する場合 .package(url: "https://github.com/realm/SwiftLint", from: "0.50.0"), // ...
ビルドツールプラグインとしてSwiftLintを使用する方法はSwiftLintのリポジトリのREADMEを参照してください。VS Codeとの連携は、SwiftPMのビルド時にSwiftLintが実行され、その結果がProblemsパネルに表示されるという形になります。

インストールが完了したら、VS Codeの統合ターミナルでバージョンを確認します。

bash swiftlint --version
バージョン情報が表示されれば、インストールとPATH設定は成功です。

設定ファイル:

プロジェクトのルートディレクトリに .swiftlint.yml という名前のファイルを作成することで、SwiftLintのルールをプロジェクトに合わせてカスタマイズできます。どのルールを有効/無効にするか、警告レベルにするかエラーレベルにするか、チェック対象から除外するファイルやディレクトリなどを設定できます。設定ファイルが存在しない場合、SwiftLintはデフォルトのルールセットで実行されます。

“`yaml

.swiftlint.yml 例

特定のルールを無効にする

disabled_rules:
– colon # コロンの後のスペースに関するルールを無効化
– identifier_name # 識別子名の長さや形式に関するルールを無効化

デフォルトでは無効だが、有効にしたいルール（opt-in rules）

opt_in_rules:
– empty_count # collection.count == 0 の代わりに collection.isEmpty を使うことを推奨するルール
– trailing_whitespace # 行末の不要な空白文字を検出するルール
– unused_declaration # 使用されていない宣言（変数、関数など）を検出するルール

特定のルールのレベルを変更（warningからerrorなど）

type_body_length: # 型（クラス、構造体、列挙型など）のボディの長さに関するルール
– 300 # warning閾値
– 400 # error閾値
– warning # デフォルトレベルをwarningに設定
force_cast: error # 強制キャスト（as!）を使用した場合をerrorとする

チェック対象から除外するファイルやディレクトリ

excluded:
– Carthage # Carthageで管理される外部ライブラリを除外
– Pods # CocoaPodsで管理される外部ライブラリを除外
– build # ビルドディレクトリを除外
– Source/Generated # 自動生成されたコードを除外

特定のルールを特定のファイルやディレクトリでのみ有効/無効にする場合

included:

– Sources

ignored:

– Tests

“`

.swiftlint.yml ファイルの詳細な記述方法については、SwiftLintのGitHubリポジトリにあるドキュメントを参照してください。

VS Codeとの連携:

SwiftLintをVS Code上で利用するには、いくつかの方法があります。最も便利なのは、リアルタイムにLint結果を表示する拡張機能を利用する方法です。

SwiftLint拡張機能 (非公式): VS Code Extension Marketplaceで「SwiftLint」と検索すると、サードパーティ製の拡張機能がいくつか見つかります。これらの拡張機能は、ファイルの保存時や編集時にバックグラウンドで swiftlint コマンドを実行し、その出力結果を解析して、Problemsパネルに表示したり、エディタ上で波線として表示したりする機能を提供します。また、コードアクションとして自動修正（AutoCorrect）を提案してくれる拡張機能もあります。利用する場合は、Extension Marketplaceの説明やGitHubリポジトリを確認し、信頼できるものを選んでインストールしてください。多くの場合、拡張機能のインストールだけで連携が完了し、追加の設定は不要です（SwiftLint実行ファイルがPATHに含まれている前提）。
VS Codeタスク: tasks.json にSwiftLintを実行するタスクを定義します。これにより、コマンドパレットから簡単にLintチェックを実行できます。
json // .vscode/tasks.json に追加 { "label": "Run SwiftLint", // タスク名 "type": "shell", "command": "swiftlint", // 実行コマンド。PATHが通っている前提。 // プロジェクト全体をチェックする場合、引数なしでOK。特定のファイルやディレクトリを指定することも可能。 "options": { "cwd": "${workspaceFolder}" // プロジェクトルートで実行 }, "problemMatcher": "$swiftlint", // swiftlint 用の Problem Matcher を指定 // Problem Matcher を指定することで、SwiftLintの出力（ファイルパス、行番号、エラー/警告メッセージなど）をVS Codeが解析し、Problemsパネルに表示できるようになります。 "group": "test", // このタスクをテスト関連のグループに入れるなど、任意 "presentation": { "reveal": "always", "panel": "new" } }
このタスクを定義すると、コマンドパレットから「Tasks: Run Task」を選び、「Run SwiftLint」を実行できるようになります。また、このタスクをファイルの保存時などに自動実行するようにVS Code設定で構成することも可能ですが、通常はSwiftLint連携拡張機能を利用する方が手軽です。
SwiftPMプラグイン (Swift 5.6以降): プロジェクトをSwiftPMパッケージとして管理している場合、Swift 5.6以降で導入されたビルドツールプラグイン機能を使って、SwiftLintをビルドプロセスに組み込むのが最も推奨される方法です。Package.swift にSwiftLintを依存関係として追加し、プラグインとして設定することで、swift build や swift test コマンドの一部として自動的にSwiftLintが実行されるようになります。これにより、開発者全員がビルドやテストを行うだけでLintチェックも同時に行えるようになります。VS CodeのSwift拡張機能は、SwiftPMプラグインによって報告された診断結果もProblemsパネルに表示できます。具体的な設定方法はSwiftLintのリポジトリを参照してください。

どの方法で連携する場合でも、SwiftLintがシステムまたはプロジェクト内にインストールされ、VS Codeから実行できる状態であることが前提となります。リアルタイムのフィードバックを得たい場合は、SwiftLint連携拡張機能の利用が最も便利です。

7.2 SwiftFormatの導入

SwiftFormatは、Swiftコードを自動的にフォーマットするツールです。定義済みのスタイルルールに従って、インデント、空白、改行、括弧の配置、アライメントなどを整形し、コードの見た目を統一します。SwiftLintが「規約違反を検出する」ツールであるのに対し、SwiftFormatは「コードを整形する」ツールです。これらを併用することで、コードスタイルの問題を自動的に修正し、コードレビューの時間を短縮できます。

インストール方法:

SwiftFormatも別途インストールが必要です。SwiftPMパッケージとして配布されていますが、コマンドラインツールとしてインストールして利用するのが一般的です。

Homebrew (macOS/Linux):
bash brew install swiftformat
Mint (macOS/Linux):
bash mint install nicklockwood/swiftformat
SwiftPM (プロジェクト内ツールとして): SwiftFormatをSwiftPMパッケージとしてプロジェクトに追加し、ビルドツールプラグインとして利用する方法も可能です（Swift 5.6以降）。

インストールが完了したら、VS Codeの統合ターミナルでバージョンを確認します。

bash swiftformat --version
バージョン情報が表示されれば、インストールとPATH設定は成功です。

設定ファイル:

プロジェクトのルートディレクトリに .swiftformat という名前のファイルを作成することで、SwiftFormatのフォーマットルールをプロジェクトに合わせてカスタマイズできます。このファイルには、各種オプションを1行ずつ記述します。設定ファイルが存在しない場合、SwiftFormatはデフォルトのルールセットで実行されます。

“`

.swiftformat 例

–indent 4 # インデント幅を4スペースに設定
–linebreaks lf # 行末コードをLFに設定
–trimwhitespace # 行末の不要な空白文字を削除
–maxwidth 120 # 最大行幅を120文字に設定
–indent-case # switch文のcaseラベルをインデントする
–exclude Pods,.build # フォーマット対象から除外するパスをカンマ区切りで指定
–binarygrouping 4,2 # バイナリリテラル（0b…）を4文字ずつ、その後2文字ずつグループ化
–ifdef # #if … #endif ブロック内のコードもフォーマット対象にする
“`

.swiftformat ファイルの詳細な記述方法については、SwiftFormatのGitHubリポジトリにあるドキュメントを参照してください。

VS Codeとの連携:

SwiftFormatをVS Code上で利用するには、いくつかの方法があります。最も便利なのは、VS Codeの標準的なフォーマット機能と連携させる方法です。

SwiftFormat拡張機能 (非公式): Extension Marketplaceで「SwiftFormat」と検索してインストールします。これらの拡張機能は、VS Codeの標準的なコードフォーマットコマンド (Shift+Alt+F または Option+Shift+F でドキュメント全体をフォーマット、Ctrl+K Ctrl+F または Cmd+K Cmd+F で選択範囲をフォーマット) と連携し、バックエンドで swiftformat コマンドを実行してコードを整形します。通常、拡張機能のインストールだけで連携が完了し、追加の設定は不要です（SwiftFormat実行ファイルがPATHに含まれている前提）。
VS Codeタスク: tasks.json にSwiftFormatを実行するタスクを定義します。
json // .vscode/tasks.json に追加 { "label": "Format Swift Code", // タスク名 "type": "shell", "command": "swiftformat .", // 実行コマンド。プロジェクトルート（.）以下の全てのSwiftファイルをフォーマット。 "options": { "cwd": "${workspaceFolder}" // プロジェクトルートで実行 }, // フォーマット結果は通常標準出力に出るだけでProblemsパネルへの連携は不要。 // エラーが発生した場合に備えて、Problem Matcherを指定しても良いが、通常不要。 "problemMatcher": [] }
このタスクをコマンドパレットから実行できます。
保存時の自動フォーマット: VS Codeの共通設定で、ファイルの保存時にフォーマッターを実行するように設定すると非常に便利です。SwiftFormat連携拡張機能を使っている場合、この設定と連携して、ファイルを保存するたびに自動的にコードが整形されるようになります。
- VS Code設定 (File -> Preferences -> Settings) を開きます。
- 「Text Editor」->「Formatting」にある editor.formatOnSave 設定を検索し、チェックを入れます。これにより、全てのファイルタイプで保存時にフォーマットが実行されるようになります。
- Swiftファイル（.swift）のみに自動フォーマットを適用したい場合は、ユーザー設定ではなくワークスペース設定 (.vscode/settings.json ファイルを直接編集) で以下のように記述します。
  json // .vscode/settings.json { "editor.formatOnSave": false, // グローバル設定ではオフ "[swift]": { // Swift言語固有の設定 "editor.formatOnSave": true, // Swiftファイルのみオン "editor.defaultFormatter": "fuvalidation.vscode-swiftformat" // Swiftファイルのデフォルトフォーマッターを指定 (使用している拡張機能のIDに合わせる) } }
  editor.defaultFormatter の値は、使用しているSwiftFormat拡張機能のIDを指定します。VS Codeの拡張機能ビューで該当拡張機能の歯車アイコンをクリックし、「Extension Settings」や「Copy Extension ID」で確認できます。

Lintとフォーマットツールを導入することで、コードレビューのコストを削減し、プロジェクト内のコードスタイルを自動的に統一できるため、複数人での開発はもちろん、個人の開発でもコード品質維持に大いに役立ちます。これらのツールは、クリーンで読みやすいコードを書く習慣を身につける上でも助けになります。

8. その他の応用

VS CodeとSwift環境の基本的なセットアップができたら、さらに開発体験を向上させるための応用的な設定や機能について見ていきましょう。これらの機能は、プロジェクトの規模が大きくなったり、開発ワークフローをより効率化したい場合に特に役立ちます。

8.1 SwiftPMパッケージ依存関係の管理

SwiftPMプロジェクトの大きな利点の一つは、他のSwiftPMパッケージを簡単に依存関係として追加できることです。これは、共通の機能を持つライブラリを利用したり、Webフレームワークやデータベースドライバなどのサードパーティ製パッケージをプロジェクトに組み込んだりする際に非常に重要です。依存関係は、プロジェクトのルートディレクトリにある Package.swift ファイルを編集することで管理します。

Package.swift ファイルには、プロジェクトの定義と依存するパッケージが記述されています。他のパッケージを追加するには、Package 定義の dependencies 配列にそのパッケージのURLとバージョン指定を追加します。そして、そのパッケージ内のどのプロダクトを、どのターゲットで使用するかを、各ターゲットの dependencies 配列で指定します。

“`swift
// Package.swift
// swift-tools-version: 5.9 // このパッケージが対象とするSwiftツールのバージョン

import PackageDescription // SwiftPMのAPIをインポート

let package = Package(
name: “MySwiftProject”, // パッケージ名
// platformVersions: // 対応プラットフォームを指定する場合 (例: .macOS(.v10_15), .iOS(.v13))
products: [
// このパッケージが提供するプロダクト（ビルド成果物として利用可能になるもの）
// .executable(name: “my-cli”, targets: [“MySwiftProject”]), // 実行可能ファイルを提供するプロダクト
// .library(name: “MyLibrary”, targets: [“MyLibrary”]), // ライブラリを提供するプロダクト
.executable(name: “MySwiftProject”, targets: [“MySwiftProject”]), // executableタイプのinitで生成された場合のプロダクト例
],
dependencies: [
// 依存関係をここに追加します。他のパッケージのURLとバージョンを指定します。
// .package(url: “パッケージのリポジトリURL”, from: “最小バージョン”),
// .package(url: “…”, exact: “特定バージョン”),
// .package(url: “…”, .upToNextMajor(from: “1.0.0”)), // 1.0.0 以上、2.0.0 未満
// .package(url: “…”, .upToNextMinor(from: “1.0.0”)), // 1.0.0 以上、1.1.0 未満
// .package(url: “…”, “0.1.0”..<“0.5.0”), // バージョン範囲
.package(url: “https://github.com/vapor/vapor.git”, from: “4.0.0”), // 人気のWebフレームワーク Vapor の例
.package(url: “https://github.com/Alamofire/Alamofire.git”, .upToNextMajor(from: “5.0.0”)), // 人気のHTTPクライアント Alamofire の例
// ローカルパスにあるパッケージを依存関係として追加することも可能
// .package(path: “../MyLocalPackage”)
],
targets: [
// ターゲットを定義します。ソースコードの集まりであり、プロダクトを構成します。
.executableTarget( // 実行可能ターゲット
name: “MySwiftProject”, // ターゲット名
dependencies: [
// このターゲットが依存するパッケージのプロダクトや、同じパッケージ内の他のターゲットを指定します。
// 上記の dependencies で宣言したパッケージ名を使い、そのパッケージが提供するプロダクト名を .product(name: …, package: …) で指定します。
.product(name: “Vapor”, package: “vapor”), // Vaporパッケージに依存
.product(name: “Alamofire”, package: “Alamofire”) // Alamofireパッケージに依存
// 同じパッケージ内の他のターゲットに依存する場合: .target(name: “MyLibraryTarget”)
],
path: “Sources/MySwiftProject” // ソースコードのパス（通常は Convention に従うため省略可能）
// plugins: [] // ビルドツールプラグインを指定する場合
),

    // テストターゲット
    .testTarget(
        name: "MySwiftProjectTests", // テストターゲット名
        dependencies: [
            "MySwiftProject", // テスト対象である自身のプロダクト（実行可能ターゲット）に依存
            // テストコードが依存する追加のパッケージやターゲットがあればここに記述
        ],
        path: "Tests/MySwiftProjectTests" // テストコードのパス
    ),
    // 他のターゲットを追加する場合
    // .libraryTarget(name: "MyLibrary", dependencies: []), // ライブラリターゲット
]

)
“`

Package.swift を編集して依存関係を追加・変更した後、VS Codeの統合ターミナルで以下のコマンドを実行すると、SwiftPMが依存関係を解決し、必要なパッケージのコードをダウンロードしてビルド準備を整えます。

“`bash
swift package update # 依存関係を解決し、新しいバージョンがあれば更新・ダウンロード

または単にビルドコマンドを実行すると、必要に応じて依存関係が解決されます

swift build
``swift package updateはPackage.swiftのバージョン指定に基づいて最新の互換バージョンを探し、Package.resolvedファイルを更新します。Package.resolved` ファイルは実際に使用される各依存パッケージの正確なバージョンを記録するファイルであり、チームメンバー間で同じバージョンを使用するためにGitで管理することが推奨されます。

VS CodeのSwift拡張機能は、Package.swift の変更を検知し、Language Serverを再起動して新しい依存関係からのコード補完、定義ジャンプ、型の情報表示などができるように努めます。通常、ファイルを保存するだけでVS Codeは変更を認識し、バックグラウンドでSwiftPMの解決処理を走らせようとします。

8.2 タスクの定義 (`tasks.json`)

前述のビルドやLintタスクのように、SwiftPMコマンド（swift build, swift run, swift test）以外にも、開発ワークフローで頻繁に実行するコマンドは tasks.json に定義しておくと便利です。これにより、これらのコマンドをコマンドパレットから簡単に実行したり、ショートカットキーに割り当てたり、他の機能（デバッグ設定の preLaunchTask など）から参照したりできます。

tasks.json は .vscode/ ディレクトリに配置されます。手動で作成・編集するか、コマンドパレットから「Tasks: Configure Task」を選んでテンプレートから作成します。

タスクの例：

Dockerコンテナのビルド/実行:
json { "label": "Build Docker Image", "type": "shell", "command": "docker build -t my-swift-app .", "options": { "cwd": "${workspaceFolder}" }, "problemMatcher": [] }, { "label": "Run Docker Container", "type": "shell", "command": "docker run --rm my-swift-app", "options": { "cwd": "${workspaceFolder}" }, "problemMatcher": [] }
デプロイスクリプトの実行:
json { "label": "Deploy to Server", "type": "shell", "command": "./deploy.sh", // プロジェクト内のデプロイスクリプト "options": { "cwd": "${workspaceFolder}" }, "problemMatcher": [] }

タスクを定義することで、複雑なコマンドを手で入力する手間を省き、コマンドパレットやショートカットキー一つで実行できるようになります。これは、開発ワークフローの自動化と効率化に大きく貢献します。

8.3 キーバインドのカスタマイズ

VS Codeは非常に柔軟なキーバインド設定が可能です。File -> Preferences -> Keyboard Shortcuts (macOSでは Code -> Preferences -> Keyboard Shortcuts) から設定画面を開き、コマンド名で検索してキーバインドを追加・変更できます。VS Codeの多くの機能や、インストールした拡張機能が提供する機能には、デフォルトのキーバインドが割り当てられていますが、自分の好みに合わせて自由に変更できます。

例えば、SwiftLintやSwiftFormatの実行タスクにカスタムのショートカットキーを割り当てることで、ワンタッチでコードチェックやフォーマットを実行できるようになります。コマンドパレットを開いて「Tasks: Run Task」を選び、さらにタスクを選択するという手順を省略できます。

キーバインド設定はJSONファイル（keybindings.json）として直接編集することも可能です。.vscode/keybindings.json を作成すればワークスペース固有のキーバインドを設定できます。

8.4 VS Code設定の同期 (Settings Sync)

複数の環境（デスクトップPCとノートPC、自宅と職場、異なるOS環境など）でVS Codeを利用している場合、Settings Sync機能を使うと、VS Codeの設定（エディタ設定、UI設定など）、キーバインド、インストール済み拡張機能、拡張機能の設定、UIステート（開いているファイルやパネルの配置など）をクラウド経由で同期できます。これにより、どの環境でも一貫した開発体験を得られ、新しい環境でVS Codeをセットアップする手間を大幅に削減できます。

Settings SyncはVS Codeの左下にある歯車アイコン（またはアカウントアイコン）をクリックし、「Turn on Settings Sync…」を選択することで有効化できます。同期先としてGitHubアカウントまたはMicrosoftアカウントが必要です。同期する項目を細かく選択することも可能です。WSL環境を含むリモート環境の設定も同期対象に含めることができます。

8.5 開発コンテナ (Dev Containers) を利用した環境構築

複雑な依存関係（特定のバージョンのSwift、特定のライブラリ、特定のOSバージョンなど）や、チームメンバー間で完全に統一された開発環境を必要とするプロジェクトの場合、開発環境全体をDockerコンテナ内に構築する「開発コンテナ (Dev Containers)」機能が非常に強力です。VS CodeのRemote Development拡張機能パックに含まれるRemote – Containers拡張機能を利用します。

このアプローチでは、プロジェクトのルートディレクトリに .devcontainer/devcontainer.json という設定ファイルと、必要に応じてDockerfileを作成します。devcontainer.json には、使用するDockerイメージ、コンテナ内で実行するセットアップコマンド（Swiftツールチェインや依存ライブラリのインストールなど）、VS Code拡張機能、ポートフォワーディング設定などを記述します。

“`json
// .devcontainer/devcontainer.json 例
{
“name”: “Swift Dev Container”, // コンテナの名前
// コンテナイメージの指定
“image”: “swift:5.10.1-jammy”, // swift.org が提供する公式Dockerイメージを利用 (Ubuntu 22.04 + Swift 5.10.1)
// または、Dockerfileを作成してより詳細な環境を構築
// “build”: {
// “dockerfile”: “Dockerfile”,
// “context”: “.”
// },

// コンテナ内で実行するセットアップコマンド
// "postCreateCommand": "apt-get update && apt-get install -y ...", // 必要に応じて追加パッケージをインストール

// コンテナ内で有効にするVS Code拡張機能
"customizations": {
    "vscode": {
        "extensions": [
            "vknabel.vscode-swift", // Swift拡張機能
            "vadimcn.vscode-lldb", // CodeLLDB拡張機能
            "fuvalidation.vscode-swiftformat", // SwiftFormat拡張機能 (もし必要なら)
            "tintin.swiftlint", // SwiftLint拡張機能 (もし必要なら)
            // プロジェクトに必要なその他の拡張機能
        ]
    }
},

// ポートフォワーディング設定 (Webサーバー開発などで必要)
// "forwardPorts": [8080],

// コンテナにマウントするローカルディレクトリ（通常はプロジェクトルートが自動でマウントされる）
// "volumes": [],

// コンテナ内の開発ユーザー
"remoteUser": "vscode" // または root, あるいは Dockerfileで作成したユーザー

}
“`

devcontainer.json ファイルをプロジェクトに含めることで、そのプロジェクトをVS Codeで開いた際に、VS Codeは自動的に devcontainer.json を検出し、「Reopen in Container」のようなプロンプトを表示します。これを選択すると、VS Codeは設定に基づいて開発コンテナをバックグラウンドで構築・起動し、そのコンテナ内で開発を行うためのVS Codeウィンドウを開き直します。VS Code本体はホストOS上で動作しつつ、ファイルアクセス、ターミナル、実行、デバッグ、インストールした拡張機能などは全てコンテナ内の環境と連携します。

この方法の利点：

環境の標準化と隔離: 開発環境の構築がプロジェクトごとに完全に定義され、チームメンバー間や異なるマシン間での環境差異による「私のマシンでは動くのに…」問題をなくせます。ホストOSを特定のライブラリやツールチェインで汚さずに済みます。
オンボーディングの容易さ: 新しい開発者がプロジェクトに参加する際の環境セットアップが非常に簡単になります。必要なのはDockerとVS Code、そしてRemote – Containers拡張機能だけで、それ以外はコンテナが自動でセットアップしてくれます。
移植性: プロジェクトの依存関係がコンテナ内に閉じ込められているため、異なるOSや環境間でのプロジェクトの移動や実行が容易になります。

Swift開発、特にサーバーサイド開発やCLIツール開発など、特定のバージョンのSwiftや依存ライブラリ、OSのシステムライブラリが必要な場合に非常に有効な方法です。コンテナイメージとしてSwift公式のイメージ（swift:latest, swift:5.10, swift:5.10-jammyなど）を利用すれば、Swiftツールチェイン自体のインストール手順をDockerfile内に記述する必要がなくなり、Dev Containersのセットアップをさらに簡略化できます。

9. トラブルシューティング

環境構築や開発中に遭遇しがちな一般的な問題と、その原因、対処法について説明します。VS Codeでの開発は様々な要素（VS Code本体、拡張機能、Swiftツールチェイン、OS環境、プロジェクト設定など）が連携して動作するため、問題の原因を特定し、適切に対処することが重要です。

9.1 Language Serverが起動しない/機能しない

Language Server (SourceKit-LSP) が正常に動作しないと、コード補完、エラー表示、定義ジャンプといったSwift拡張機能の主要な機能が利用できません。

Swift拡張機能がインストールされているか確認: VS Codeの拡張機能ビューで「Swift」拡張機能（公開元が Swift Server Accounts など）がインストールされ、かつプロジェクトを開いているVS Codeウィンドウで有効になっているか確認します。リモート開発（WSLやSSH）の場合は、リモート環境側で拡張機能が有効になっている必要があります。
Swiftツールチェインのパス: Language Serverは、システムにインストールされているSwiftツールチェインに含まれるSourceKit-LSPバイナリを探して実行します。
- VS Codeの統合ターミナルで swift --version が正しく動作し、意図したバージョンの情報が表示されるか確認します。これが表示されない場合は、Swiftツールチェインのインストール自体が不完全か、PATH設定が誤っています。
- VS Codeの設定 (File -> Preferences -> Settings) で swift.toolchainPath を検索します。この設定が空欄の場合、VS Codeはシステムのアクティブなツールチェインを自動検出しようとします。自動検出がうまくいかない場合は、ここにSwiftツールチェインのルートディレクトリへのパスを明示的に指定してみてください（例: macOS: /Library/Developer/Toolchains/Swift-5.x.x-RELEASE.xctoolchain, Linux/WSL: /opt/swift, /home/your_user/swift など）。指定したパスが存在し、その中に usr/bin/SourceKit-LSP のようなファイルが存在するか確認します。
Language Serverログの確認: VS Codeの出力パネル (View -> Output または Ctrl+Shift+U / Cmd+Shift+U) を開き、パネル右上のドロップダウンから「Swift Language Server」を選択します。ここにLanguage Serverの起動に関するエラーメッセージや、解析中の警告などが表示されている場合があります。例えば「SourceKit-LSP not found」のようなエラーが出ていれば、ツールチェインパスの問題です。
プロジェクトのクリーンと再オープン: Language Serverの内部状態やキャッシュに問題がある場合、プロジェクトをクリーンしてから開き直すことで解決することがあります。統合ターミナルで swift package clean を実行し、その後VS Codeでプロジェクトフォルダを一度閉じて、再度開き直してみてください。
VS Codeを再起動する: VS Code全体を終了し、再起動することで、VS Codeや拡張機能の状態がリセットされ、問題が解決することがあります。
プロジェクト構造の確認: Package.swift ファイルがプロジェクトルートに正しく配置されているか、SwiftPMの標準的なプロジェクト構造（Sources/, Tests/）が守られているか確認します。非標準的な構造の場合、Language Serverが正しくプロジェクトを認識できないことがあります。
VS Code Remote – WSL/SSH の場合: ホストOS側ではなく、リモート環境側（WSLまたはSSH接続先）にSwift拡張機能がインストールされているか確認します。拡張機能ビューを開き、「WSL: Ubuntu」や「SSH: YourServerName」のセクションにSwift拡張機能が表示されているか確認します。また、リモート環境側でのSwiftツールチェインのパス設定が正しいかも確認します。

9.2 ビルドエラー、実行エラー

SwiftPMコマンド (swift build, swift run) の実行中にエラーが発生する場合です。

ターミナルで直接実行: VS Codeの統合ターミナルで、swift build や swift run コマンドを直接実行してみてください。VS Codeのタスクやデバッグ設定を介さずに、純粋なSwiftPMの実行として問題が発生するかどうかを確認することで、問題がSwiftPM自体にあるのか、VS Codeの設定にあるのかを切り分けられます。
エラーメッセージの確認: ターミナル出力やProblemsパネルに表示されるエラーメッセージを詳しく読みます。コンパイルエラー（swiftc のエラー）なのか、リンクエラーなのか、実行時エラー（プログラム実行中に発生するエラー）なのかを特定します。エラーメッセージには、問題が発生したファイル名、行番号、そしてエラーの内容が具体的に示されているはずです。これらの情報を元にコードを修正します。
SwiftPMファイル (Package.swift) の確認: 依存関係やターゲット設定が正しく記述されているか確認します。特に新しい依存関係を追加した場合、パッケージ名やプロダクト名が正確か、バージョン指定が適切か確認します。依存関係のURLが正しいか、到達可能か（プライベートリポジトリへのアクセス権限など）も確認します。
依存関係の更新: swift package update コマンドをVS Codeの統合ターミナルで実行して、依存関係を最新の状態に更新してみてください。依存関係のキャッシュの問題や、バージョン間の不整合が解消されることがあります。
ビルドキャッシュのクリア: .build/ ディレクトリ（VS Codeのエクスプローラーではデフォルトで非表示になっている場合がありますが、手動で削除できます）や .swiftpm/ ディレクトリ（依存関係の解決キャッシュなど）を削除してから再度ビルド (swift build) することで、古いビルド成果物やキャッシュによる問題を解決できることがあります。これは比較的強力なクリーンアップ方法です。
ツールチェインのバージョン: プロジェクトや依存関係が必要とするSwiftのバージョンと、現在使用しているツールチェインのバージョンが一致しているか確認します。特に、古いバージョンのSwiftで書かれたコードを新しいツールチェインでビルドしようとしたり、その逆を行ったりすると、互換性の問題でビルドエラーが発生することがあります。
プラットフォーム固有の問題: macOSの場合、macOS SDKやXcodeのバージョンとの互換性も影響することがあります。Linux/WSLの場合、必要なシステムライブラリ（依存関係）が全てインストールされているか再確認します。

9.3 デバッグがうまくいかない

ブレークポイントで停止しない、変数が表示されない、デバッグセッションが開始されないなどの問題が発生する場合です。

CodeLLDB拡張機能の確認: VS Codeの拡張機能ビューで「CodeLLDB」拡張機能（公開元が vadimcn）がインストールされ、かつプロジェクトを開いているVS Codeウィンドウで有効になっているか確認します。リモート開発の場合は、リモート環境側で拡張機能が有効になっている必要があります。
launch.json の設定: launch.json ファイルの設定が、デバッグ対象のプログラムとCodeLLDB拡張機能の要求に合致しているか確認します。
- type が "lldb" になっているか確認します。
- request が "launch" または "attach" となっているか確認します。通常は "launch" です。
- name は単にVS Code UIでの表示名です。
- program のパス: これが最も頻繁な問題の原因の一つです。デバッグ対象となるビルド済み実行可能ファイルのパスを正確に指定する必要があります。通常、SwiftPMプロジェクトのデバッグビルド成果物は ${workspaceFolder}/.build/debug/YourTargetName のようなパスに配置されます。launch.json の例で示したように、Swift拡張機能の変数 ${product:TargetName} や ${testproduct:TestTargetName} を使うのが最も確実です。手動でパスを指定している場合は、統合ターミナルで ls .build/debug/ などで生成された実行可能ファイルの正確なファイル名を確認し、パスがタイプミスなく記述されているか確認します。パスがWindows形式（バックスラッシュ \）ではなく、Linux/macOS形式（スラッシュ /）になっているか確認します。WSLの場合は、WSL環境からのパス（/home/your_user/MySwiftProject/.build/debug/...）を指定します。
- args が、プログラムに渡したい引数を正しく配列として記述しているか確認します。
- cwd (current working directory) が、プログラムがファイルなどを読み書きする際に基準となるディレクトリとして適切か確認します。通常はプロジェクトルート ("${workspaceFolder}") で問題ありません。
- preLaunchTask が指定されており、それがビルドタスク（例: swift build）を正しく参照しているか確認します。デバッグ対象のプログラムは、常に最新の状態にビルドされている必要があります。
LLDBのバージョンと互換性: CodeLLDB拡張機能は、システムにインストールされているLLDBデバッガー実行ファイル（通常はSwiftツールチェインに含まれるもの）を利用します。使用しているLLDBのバージョンが、CodeLLDB拡張機能やデバッグ対象のSwiftコードと互換性があるか確認します。通常、Swiftツールチェインに付属するLLDBを使用していれば問題ありませんが、稀に特定のバージョンで問題が発生する場合があります。VS Codeの設定 lldb.executable で使用するLLDBのパスを明示的に指定できます。
ビルドタイプ: デバッグは通常、最適化レベルが低いデバッグビルド (.build/debug/) に対して行います。リリースビルド (.build/release/) はコンパイラの最適化が高く、コードの実行順序が変わったり、変数が最適化によって削除されたりするため、ブレークポイントが期待通りに動作しない、変数の値が正しく表示されないといった問題が発生しやすいです。launch.json の program パスがdebugビルドを指しているか確認します。swift build -c debug でデバッグビルドを明示的に実行することもできます。
ブレークポイントが有効か: 設定したブレークポイントが赤色の丸で表示されており、有効になっているか確認します。無効なブレークポイントは半透明などで表示されます。ブレークポイントの条件などが誤っていないかも確認します。
VS Code Remote – WSL/SSH の場合: リモート環境側のCodeLLDB拡張機能が有効になっており、リモート環境のSwiftツールチェインに含まれるLLDBが利用されているか確認します。launch.json のパスは、リモート環境からのパスである必要があります。
ファイアウォール: ごく稀に、ローカルホスト内でのプロセス間通信（VS Code <=> CodeLLDB <=> デバッグ対象プログラム）がファイアウォールによってブロックされることがあります。特に初めてデバッグを実行する場合に発生する可能性があります。

9.4 Lint/フォーマットが機能しない

SwiftLintやSwiftFormatが期待通りに動作しない、またはVS Codeに結果が表示されない場合です。

ツール自体のインストール: SwiftLintやSwiftFormatがシステムまたはプロジェクト内にインストールされ、VS Codeの統合ターミナルからコマンドとして実行できるか確認します（例: swiftlint --version, swiftformat .）。コマンドが見つからない場合は、インストールが失敗しているか、PATH設定が誤っています。
VS Code拡張機能/タスク設定: 利用しているVS Code拡張機能（SwiftLint/SwiftFormat連携拡張機能）や tasks.json の設定が正しいか確認します。拡張機能の設定で、使用する実行ファイルのパスが指定されている場合は、そのパスが正しいか確認します。tasks.json の command が正しいか、problemMatcher が $swiftlint になっているか確認します。
設定ファイル(.swiftlint.yml, .swiftformat) の確認: プロジェクトのルートディレクトリに設定ファイルが正しく配置されているか、ファイル名が .swiftlint.yml および .swiftformat であるか確認します。設定ファイルの内容に構文エラーがないかも確認します。
チェック/フォーマット対象外のファイル: 設定ファイル（.swiftlint.yml の excluded など）やコマンドの引数によって、対象のファイルがチェックやフォーマットの対象から除外されていないか確認します。
保存時の自動フォーマット設定: editor.formatOnSave や editor.defaultFormatter、言語固有の設定 ([swift]) が正しく構成されているか確認します。保存してもフォーマットされない場合、これらの設定がオフになっているか、デフォルトフォーマッターが正しく指定されていません。
エラーメッセージの確認: Lint/フォーマット実行時にVS Codeの出力パネルやターミナルにエラーメッセージが表示されていないか確認します。例えば、SwiftLintが設定ファイルを読み込めないエラーや、解析中のエラーなどが出ている可能性があります。

9.5 WSL固有の問題

Windows上のVS CodeとWSL2環境を組み合わせてSwift開発を行う場合に発生しうる特有の問題です。

WSL2が実行されているか: WSL2が起動しており、使用しているLinuxディストリビューション（Ubuntuなど）が正常に動作しているか確認します。PowerShellやコマンドプロンプトで wsl -l -v コマンドを実行し、ディストリビューションが STATE: Running になっているか確認します。もし Stopped になっていれば、wsl コマンドを実行して起動します。
VS Code Remote – WSLの確認: VS CodeがWSL環境に正しく接続できているか確認します。VS Codeウィンドウの左下隅に「WSL: Ubuntu」のような表示が出ているか確認します。この表示が出ていない場合、VS Codeはローカル（Windows）環境で動作しています。接続できていない場合は、VS Codeを再起動したり、コマンドパレットから「Remote-WSL: Reopen Folder in WSL」コマンドを使ってWSL内のフォルダを開き直したりしてみてください。
拡張機能のインストール場所: Swift開発に必要な拡張機能（Swift、CodeLLDBなど）は、ホストOS（Windows）側ではなく、WSL環境側 (WSL: Ubuntu セクション) にインストールされている必要があります。拡張機能ビューで確認し、もしローカル側だけにインストールされている場合は、リモート側にもインストールしてください。
ファイルパス: Windows側とWSL側でファイルパスの記述方法が異なります。WSL内のファイルシステムはLinux形式のパス（/home/your_user/... や /mnt/c/...）を使用します。VS CodeがRemote – WSLでWSL環境に接続されている場合、launch.json や tasks.json、VS Code設定などで指定するファイルパスは、全てWSL環境から見たLinux形式のパスである必要があります。例えば、Windowsの C:\Users\YourUser\MyProject はWSL内では /mnt/c/Users/YourUser/MyProject となります。SwiftPMプロジェクトのコードやビルド成果物は、WSLのファイルシステム（例えば ~/MySwiftProject）内に置くことを強く推奨します。その場合、パスは /home/your_user/MySwiftProject/... のようになります。
パフォーマンス: WSL環境でSwiftPMのビルドは、Windowsネイティブでのビルドに比べて時間がかかる場合があります。また、Windows側からWSLのファイルにアクセスする際のパフォーマンスは、WSL側からWSLのファイルにアクセスするよりも遅い傾向があります。そのため、Swift開発の作業はできるだけWSL内で完結させる（VS CodeでWSL内のフォルダを開き、ターミナルもWSLのものを使う）のが理想的です。
WindowsとWSL間のアクセス権: ごく稀に、Windows側のファイルシステムをWSLからアクセスする際に、アクセス権限の問題が発生することがあります。この場合、Windows側のファイル/フォルダの権限設定を確認したり、WSLのユーザー権限でアクセス可能か確認したりする必要があります。
環境変数の引き継ぎ: Windows側で設定した環境変数がWSL環境に引き継がれない場合があります。SwiftツールチェインのPATH設定などは、WSL側のシェルの設定ファイル（.bashrc など）に記述する必要があります。VS Codeは、WSL環境で起動したシェルの環境変数を引き継いで実行されます。

これらのトラブルシューティング手順は一般的なものですが、問題の原因は環境によって様々です。エラーメッセージやログ出力を注意深く読み、一つずつ原因を切り分けていくことが、問題を解決するための最も効果的な方法です。公式ドキュメントや関連コミュニティ（Swift forums, VS Code GitHub issuesなど）での情報収集も非常に役立ちます。

10. まとめ

この記事では、Visual Studio Codeを開発環境として利用し、Swift開発を行うための詳細かつ網羅的な手順を解説しました。macOS、Linux、そしてWSL上のWindowsといった主要なプラットフォームそれぞれにおけるSwiftツールチェインのインストール方法から始まり、VS Codeの基本的な準備、Swift開発に必須となる拡張機能（Swift Language Server連携のためのSwift拡張機能、デバッグのためのCodeLLDB）の導入、そしてSwift Package Manager (SwiftPM) プロジェクトの作成、ビルド、実行、テスト、さらにはVS Codeでのデバッグ設定、コード品質向上のためのLint・フォーマットツールの連携までをステップバイステップで説明しました。

VS Codeは軽量でありながら、豊富な拡張機能とSwift Language Serverの連携により、コード補完、エラー診断、定義ジャンプといったモダンなエディタ機能をSwift開発においても十分に提供してくれます。SwiftPMとの親和性も高く、CLIツールやサーバーサイドSwift開発、ライブラリ開発において非常に強力な選択肢となります。特にクロスプラットフォームで開発を行いたい開発者や、既にVS Codeを他の言語開発で利用している開発者にとっては、そのメリットが際立ちます。

この記事で解説した手順に従って環境を構築することで、あなたは以下のことができるようになっています。

VS CodeでSwiftソースコードを記述・編集し、Swift Language Serverによる高度なコードインテリジェンス（補完、診断、ナビゲーションなど）の恩恵を受けることができます。
VS Codeの統合ターミナルまたはタスク機能を利用して、SwiftPMコマンド（swift build, swift run, swift test）を実行し、プロジェクトのビルド、実行、テストを効率的に行うことができます。
CodeLLDB拡張機能と適切な launch.json 設定を利用して、VS Codeの使い慣れたデバッグUIから、Swiftプログラムの実行を制御し、ブレークポイントでの停止、ステップ実行、変数の監視などを行うことで、コードの問題を特定・解決できます。
SwiftLintやSwiftFormatといったツールを導入し、VS Code拡張機能やタスク連携、保存時の自動フォーマット設定などを活用することで、コードのスタイルや品質を自動的にチェック・整形し、プロジェクト全体で一貫したコードベースを維持できます。
必要に応じて、開発コンテナ（Dev Containers）やWSL2環境をVS Codeと組み合わせて利用することで、複雑な依存関係を持つプロジェクトの開発環境を標準化・隔離したり、Windows上でLinux版Swiftを快適に利用したりすることができます。
遭遇しうる一般的な環境構築や開発中の問題に対して、基本的なトラブルシューティング手法を用いて原因を特定し、対処することができます。

VS CodeでのSwift開発は、特にGUIに依存しないプロジェクト（サーバーサイドアプリケーション、CLIツール、ライブラリなど）において、Xcodeに代わる（あるいはXcodeと連携する）非常に魅力的な開発スタイルを提供します。macOS以外のプラットフォームでSwift開発を行う際のデファクトスタンダードと言えるでしょう。この記事で解説した手順と知識は、VS Codeでの快適なSwift開発を始めるための強固な基盤となるはずです。

次のステップ

VS CodeでのSwift開発環境が整ったら、次は実際にSwiftコードを書いて、その力を試してみましょう。

CLIツール開発: VS CodeとSwiftPMを使って、コマンドラインツールを作成してみましょう。ユーザーからの引数を受け取ったり、ファイル操作を行ったり、外部プロセスを呼び出したりするようなツールを開発することで、Swiftの基礎を実践的に学ぶことができます。
サーバーサイド開発: Vapor、Kitura、HummingbirdといったSwift製Webフレームワークを利用して、WebアプリケーションやAPIサーバーを構築してみましょう。SwiftPMでこれらのフレームワークを依存関係として追加し、VS Codeでコーディング、ビルド、デバッグ、そして実行までを行います。
ライブラリ開発: 再利用可能なSwiftコードをライブラリとして作成し、SwiftPMパッケージとして公開してみましょう。他のプロジェクトから簡単に利用できるようにすることで、コードの再利用性を高めることができます。
学習リソース: Swift公式ドキュメント、SwiftPMドキュメント、VS Codeドキュメント、CodeLLDBドキュメントなどを参考に、さらに深くSwiftやVS Codeの機能を活用する方法を学びましょう。公式のSwift Evolution Proposals (SE) を追うことで、言語の将来的な方向性についても理解を深めることができます。
コミュニティへの参加: Swiftの開発者コミュニティは活発です。Swift forums (https://forums.swift.org/) やStack Overflowなどで質問したり、他の開発者と交流したりすることで、より多くの情報や解決策を得られるでしょう。

この記事で解説した詳細な手順と知識を元に、VS Codeでの快適なSwift開発ライフをぜひ始めてみてください。この記事が、あなたのSwift開発における新たな扉を開く一助となれば幸いです。

付録/リソース

Swift公式ウェブサイト: https://www.swift.org/ – Swift言語に関する全ての公式情報がここにあります。
Swift.org ダウンロードページ: https://www.swift.org/download/ – Swiftツールチェインの公式ダウンロード元です。各OS/バージョンの依存関係情報もここに記載されています。
Swift Package Manager (SwiftPM) ドキュメント: https://www.swift.org/documentation/package-manager/ – SwiftPMの使い方に関する詳細な情報がここにあります。Package.swift の記述方法なども確認できます。
Visual Studio Code 公式ウェブサイト: https://code.visualstudio.com/ – VS Codeのダウンロードや基本情報。
VS Code ドキュメント: https://code.visualstudio.com/docs – VS Codeのあらゆる機能に関する詳細なドキュメントです。設定、キーバインド、タスク、デバッグなどについて詳しく学べます。
VS Code Extension Marketplace: https://marketplace.visualstudio.com/VSCode – VS Code拡張機能を検索・インストールできる場所です。記事中で紹介したSwift、CodeLLDB、SwiftLint、SwiftFormatなどの拡張機能はこちらで検索できます。
VS Code Swift Language Server for VS Code (vscode-swift) 拡張機能ページ: Extension Marketplaceで「Swift」を検索してください。
VS Code CodeLLDB 拡張機能ページ: Extension Marketplaceで「CodeLLDB」を検索してください。
SwiftLint GitHubリポジトリ: https://github.com/realm/SwiftLint – SwiftLintのソースコード、ドキュメント（インストール方法、ルール設定など）、issueトラッカーなど。
SwiftFormat GitHubリポジトリ: https://github.com/nicklockwood/SwiftFormat – SwiftFormatのソースコード、ドキュメント（インストール方法、設定ファイルなど）、issueトラッカーなど。
WSL インストールガイド (Microsoft): https://learn.microsoft.com/ja-jp/windows/wsl/install – Windows Subsystem for Linux 2 の公式インストール手順。
Dev Containers ドキュメント: https://code.visualstudio.com/docs/devcontainers/containers – VS Codeの開発コンテナ機能に関する詳細なドキュメント。devcontainer.json の記述方法など。

これらのリソースは、SwiftやVS Code、関連ツールについてさらに詳しく学ぶ上で非常に有用です。環境構築中に問題が発生した場合や、特定の機能について深掘りしたい場合に参照してください。

(記事終了)

【簡単？ 詳細！】VS CodeでSwift開発環境を整える手順の完全ガイド

はじめに

なぜVS CodeでSwift開発なのか？

この記事の目的

対象読者

必要なもの

1. Swift開発環境の基本

1.1 Swiftとは？

1.2 Swiftのコンパイラ・ツールチェイン

1.3 Swiftツールチェインの入手・インストール方法

macOSの場合

Linuxの場合

Windowsの場合

1.4 Swiftバージョンの確認

2. VS Codeの準備

2.1 VS Codeのインストール

2.2 VS Codeの基本的な使い方

2.3 VS Codeでの開発ワークフローの紹介

3. VS CodeにおけるSwift開発のための拡張機能

3.1 必須の拡張機能

Swift (vscode-swift)

CodeLLDB

3.2 その他の便利な拡張機能

4. SwiftToolchainのインストールと設定 (プラットフォーム別詳細)

4.1 macOSでのインストールと設定の詳細

方法1: Xcodeをインストールする (最も簡単)

方法2: Swift.orgからツールチェインをインストールする

4.2 Linuxでのインストールと設定の詳細 (Ubuntuを例に)

4.3 Windowsでのインストールと設定の詳細 (WSL2 + Ubuntuを推奨)

5. VS CodeでのSwiftプロジェクト作成と基本操作

5.1 SwiftPMプロジェクトの作成

プロジェクト用のディレクトリを作成

SwiftPMプロジェクトを初期化

タイプを指定しないとexecutable (実行可能形式) がデフォルト

swift package init –type library # 再利用可能なライブラリを作成する場合

swift package init # デフォルト（executable）

5.2 VS Codeでプロジェクトを開く

5.3 Swift拡張機能によるLanguage Serverの起動と連携確認

5.4 SwiftPMコマンドの実行

6. デバッグ設定

6.1 launch.json ファイルの作成

6.2 デバッグ実行前のタスク設定 (tasks.json)

6.3 ブレークポイントの設定とデバッグ実行

6.4 SwiftPMテストターゲットのデバッグ

7. Lintとフォーマット

7.1 SwiftLintの導入

.swiftlint.yml 例

7.2 SwiftFormatの導入

.swiftformat 例

8. その他の応用

8.1 SwiftPMパッケージ依存関係の管理

または単にビルドコマンドを実行すると、必要に応じて依存関係が解決されます

8.2 タスクの定義 (tasks.json)

8.3 キーバインドのカスタマイズ

8.4 VS Code設定の同期

8.5 開発コンテナ (Dev Containers) を利用した環境構築

9. トラブルシューティング

9.1 Language Serverが起動しない/機能しない

9.2 ビルドエラー、実行エラー

9.3 デバッグがうまくいかない

9.4 Lint/フォーマットが機能しない

9.5 WSL固有の問題

10. まとめ

次のステップ

付録/リソース

【簡単？ 詳細！】VS CodeでSwift開発環境を整える手順の完全ガイド

はじめに

なぜVS CodeでSwift開発なのか？

この記事の目的

対象読者

必要なもの

1. Swift開発環境の基本

1.1 Swiftとは？

1.2 Swiftのコンパイラ・ツールチェイン

1.3 Swiftツールチェインの入手・インストール方法

macOSの場合

Linuxの場合

Windowsの場合

1.4 Swiftバージョンの確認

2. VS Codeの準備

【簡単？詳細！】VS CodeでSwift開発環境を整える手順の完全ガイド

6.1 `launch.json` ファイルの作成

6.2 デバッグ実行前のタスク設定 (`tasks.json`)

8.2 タスクの定義 (`tasks.json`)

【簡単？詳細！】VS CodeでSwift開発環境を整える手順の完全ガイド

6.1 `launch.json` ファイルの作成

6.2 デバッグ実行前のタスク設定 (`tasks.json`)

8.2 タスクの定義 (`tasks.json`)

コメントする返信をキャンセル