WebStorm 2026.3 Help

Svelte

WebStorm は、 Svelte フレームワークの基本的な機能として、構文ハイライト、 コード補完 (自動インポート付き)、リファクタリング、 ナビゲーション、 インテンション 、コードの折りたたみ、 ライブテンプレートサポート、 正しいフォーマットを提供します。

始める前に

  1. コンピューターに Node.js(英語) があることを確認してください。

  2. JetBrains Marketplace からプラグインをインストールするの説明に従って、 設定 | プラグイン ページで Svelte プラグインをインストールして有効にします。

Svelte アプリケーションを作成する

Svelte アプリケーションを作成する推奨方法は、Svelte チームの公式アプリケーションフレームワークである SvelteKit(英語) を使用することです。

  1. コマンドラインシェルまたは組み込み ターミナル (Alt+F12) を開き、 npx sv create <project_name> と入力します。

  2. 開始されるウィザードの質問に答えます。

    Svelte: プロジェクト生成ウィザード
  3. Svelte 固有の構造 (ファイル | オープン) で生成されたアプリケーションを開き、 npm install を実行して依存関係をインストールします。

    Svelte: アプリを開いて依存関係をインストールする

スベルト公式サイト(英語)の詳細を参照してください。

既存の Svelte アプリケーションから始める

既存の Svelte アプリケーションの開発を継続するには、WebStorm で開き、必要な依存関係をダウンロードしてください。

すでにマシン上にあるアプリケーションソースを開く

  • ようこそ 画面で 開く をクリックするか、メインメニューから ファイル | オープン を選択します。 開いたダイアログで、ソースが保存されているフォルダーを選択します。

バージョン管理からアプリケーションのソースをチェックアウト

  1. ようこそ 画面で リポジトリのクローン をクリックします。

    あるいは、メインメニューから ファイル|新規|バージョン管理からプロジェクト…、 Git|クローン…、 VCS | バージョン管理から取得​ を選択します。

    メインメニューの Git の代わりに、プロジェクトに関連付けられている他のバージョン管理システムが表示される場合があります。 例: Mercurial または Perforce。

  2. 表示されるダイアログで、リストからバージョン管理システムを選択し、アプリケーションソースをチェックアウトするリポジトリを指定します。 詳細については、 プロジェクトをチェックアウトする(クローン) を参照してください。

依存関係をダウンロードする

  • ポップアップで 'npm install' を実行 または 'yarn install' を実行 をクリックします。

    アプリケーションを開いて依存関係をダウンロードする
  • または、エディターの package.json のコンテキストメニュー、または プロジェクト ツールウィンドウ (Alt+1) で 'npm install' を実行 または 'yarn install' を実行 を選択します。

プロジェクトのセキュリティ

WebStorm の外部で作成されインポートしたプロジェクトを開くと、WebStorm は未知のソースコードをどう扱うか選択できるダイアログを表示します。

信頼できないプロジェクトの警告

次のいずれかのオプションを選択します:

  • セーフモードでプレビュー :この場合、WebStorm はプロジェクトをプレビューモードで開きます。 これは、プロジェクトのソースを参照することはできますが、タスクやスクリプトを実行したり、プロジェクトを実行 / デバッグしたりすることはできないことを意味します。

    WebStorm はエディター領域の上部に通知を表示し、 プロジェクトを信頼する… リンクをクリックしていつでもプロジェクトをロードできます。

  • プロジェクトを信頼 :この場合、WebStorm はプロジェクトを開いてロードします。 つまり、プロジェクトが初期化され、プロジェクトのプラグインが解決され、依存関係が追加され、すべての WebStorm 機能が利用可能になります。

  • 開かない :この場合、WebStorm はプロジェクトを開きません。

詳細は プロジェクトのセキュリティ をご覧ください。

Svelte コードでコーディング支援を構成する

Svelte 言語サーバー(英語)との統合により、Svelte コードで型チェックと補完を行うことができます。 または、WebStorm の内部インスペクションとコード補完のみを利用できます。

  1. 設定 ダイアログ(Ctrl+Alt+S )で 言語 & フレームワーク | TypeScript | Svelte に移動します。

  2. コーディングの支援を受ける場所を指定します。

    • Svelte Language Server を使用するには、 有効 を選択してください。

    • WebStorm 内部の WebStorm インスペクションとコード補完を使用するには、 無効 を選択してください。

メモリ処理を構成する

WebStorm は言語サービスとのスムーズな統合を目指していますが、WebStorm 自体でなく言語サービスによって引き起こされる out-of-memory エラーが発生する場合があります。

out-of-memory エラーを防止、またはシームレスに解決して言語サービスの安定した動作を確保するには、メモリ処理を設定する必要があります。 詳しくは 言語サービス を参照してください。

Svelte 言語サービスのメモリ処理設定は、常に TypeScript 言語サービスから継承されます。

TypeScript 言語サービスのメモリ処理を構成する

  1. Ctrl+Alt+S を押して設定を開き、 設定 | 言語 & フレームワーク | TypeScript に移動します。

  2. 言語サービスメモリ 領域で、メモリ処理モードを選択します。

    • 言語サービスメモリ エリアで 利用可能な場合はメモリを自動的に増加します を選択すると、メモリが増加し、言語サービスが自動的に再起動されます。

    • または、 メモリ制限を設定する を選択し、言語サービスで使用する最大メモリを指定します。

      指定されたメモリサイズが利用可能な RAM を超えた場合、WebStorm はツールチップで適切な値を提案します。

コードを記述して編集する

.svelte コンポーネントおよび関連ファイルでは、WebStorm は構文ハイライト、 コード補完 (自動インポート付き)、リファクタリング、 ナビゲーション、 インテンション 、コードの折りたたみ、 ライブテンプレートサポート、 正しいフォーマットを提供します。

Svelte コンポーネントの作成

  • プロジェクト ツールウィンドウ(Alt+1 )で、新しいコンポーネントの親フォルダーを選択し、リストから Svelte コンポーネント を選択します。

    Svelte コンポーネントの作成

コード補完

共通の補完に加え、WebStorm は Svelte 固有のシンボルの補完も提供します。

WebStorm は入力中に補完候補を表示します。 あるいは、完了するシンボルにキャレットを置き、 Ctrl+Space を押します。

Svelte: コード補完

自動インポート

WebStorm は、 .svelte や JavaScript ファイルでコードを入力または補完すると、その場でインポートステートメントを生成します。

Auto import on completion
Auto import on completion

インポートされていないシンボルには下線が付いています。 import ステートメントを挿入するには、下線付きのシンボルの上にマウスを置き、ポップアップ内の <シンボル名> のインポート リンクをクリックします。

Svelte:インポート不足時のクイックフィックスポップアップ
Svelte:インポート不足時のクイックフィックスポップアップ

あるいは、インポートするシンボルにキャレットを置き、 Alt+Enter を押して、リストから <シンボル名> のインポート を選択します。

Svelte: インポートクイックフィックスを挿入
Svelte: インポートクイックフィックスを挿入

詳細は 自動インポート をご覧ください。

コードのリファクタリング

Svelte: refactoring
  • リファクタリングするコードフラグメントを選択するか、その中にキャレットを配置し、 Ctrl+Alt+Shift+T を押して、リストから必要なリファクタリングを選択します。

詳細については、 コードリファクタリング、 JavaScript のリファクタリング、 TypeScript のリファクタリング を参照してください。

コンポーネントの使用箇所を移動する

インレイヒントを使用して、コンポーネントからその使用箇所に移動します。 コンポーネントが複数回使用される場合、WebStorm は検出された使用箇所のリストを表示します。 関連する使用箇所を選択して、そこに移動します。

Svelte: Navigate with Component Usages

コンポーネントの使用箇所を表示 ヒントはデフォルトで表示されます。 これをオフにするには、 Ctrl+Alt+S を押して設定を開き、 エディター|インレイヒント を選択します。 次に、 コードビジョン の コンポーネントの使用箇所 チェックボックスをオフにします。

または、エディターで コンポーネントの使用箇所を表示 ヒントを右クリックし、 Code Vision: コンポーネントの使用箇所のインレイヒントを非表示 を選択します。

エディターでコンポーネントの使用をオフにする

コメントを追加

行コメントと ブロックコメントに加えて、開始 HTML タグ内にコメントを挿入できます。 要素内に表示されるコンテンツを配置せずに、その要素に関連付けられた属性、ディレクティブ、または式にコメントを付けたい場合に便利です。

WebStorm は開始 HTML タグ内のコメントを認識し、エラーとして報告しません。

開始タグ内にコメントを入力し、 Ctrl+/ を押します。

    アプリケーションを実行する

    1. 実行アイコン を package.json 内の dev スクリプトの横にあるガターでクリックするか、 ターミナル Alt+F12 で npm run dev コマンドを実行するか、 npm ツールウィンドウ (表示 | ツールウィンドウ | npm) で dev タスクをダブルクリックします。

    2. アプリケーションのコンパイルと開発サーバーの準備が完了するまでお待ちください。

      実行 ツールウィンドウまたは ターミナル には、アプリケーションが実行されている URL が表示されます。 アプリケーションが SvelteKit で生成された場合、デフォルトの URL は http://localhost:8080/ です。 このリンクをクリックすると、アプリケーションが表示されます。

      Svelte アプリは開発モードで実行されています

    実行 / デバッグ構成を介して Svelte アプリケーションを実行する

    WebStorm 新規プロジェクト ウィザードで SvelteKit を使って作成したアプリケーションについては、 上記のように 、WebStorm はデフォルト名 dev で npm 構成を生成します。 この構成により、開発サーバーが起動し、アプリケーションが開発モードで起動します。

    それ以外の場合は、ホスト、ポートなどの実際の設定を手動で 実行 / デバッグ構成を作成するする必要があります。

    npm 実行 / デバッグ構成を作成する

    1. 実行 | 実行構成の編集 に進みます。 または、ツールバーの 実行 ウィジェットから 実行構成の編集 を選択します。

      構成の編集を開くダイアログ

      開いた 実行構成の編集 ダイアログで、ツールバーの 追加 ボタン (追加ボタン) をクリックし、リストから すでに npm を選択します。

    2. 開いた 実行 / デバッグ構成:npm ダイアログの 構成 タブで、 package.json の場所、Node.js ランタイム、および使用するパッケージマネージャーを指定します。

      コマンド フィールドで、リストから 実行 を選択し、次に スクリプト リストから実行するスクリプトを選択します。 ほとんどの場合、デフォルトの dev スクリプトになりますが、カスタムポートでアプリケーションを実行するなど、 package.json で別のスクリプトを構成することもできます。

      npm 実行 / デバッグ構成: 構成タブ
    3. オプション:

      ブラウザーでアプリケーションを開くには、構成を次のように更新します: ブラウザー / Live Edit タブで、 起動後 チェックボックスをオンにし、アプリケーションを開くブラウザーを選択して、アプリケーションが実行される URL アドレスを指定します。

      アプリケーションをデバッグする場合は、 Google Chrome(英語) または別の Chromium ベースのブラウザー(英語)を選択します。

      ブラウザー / ライブ編集タブ: ブラウザーを選択

    アプリケーションの実行

    1. ツールバーの 実行 ウィジェットのリストから、 すでに npm タイプの実行構成を選択します。 これは、自動生成された dev 構成、または 上記のように自分で作成したカスタム構成にすることができます。

      実行 / デバッグ構成を選択する
    2. アプリケーションのコンパイルと開発サーバーの準備が完了するまでお待ちください。

      実行 ツールウィンドウまたは ターミナル には、アプリケーションが実行されている URL が表示されます。 アプリケーションが SvelteKit で生成された場合、デフォルトの URL は http://localhost:8080/ です。 このリンクをクリックすると、アプリケーションが表示されます。

      Ымудеуアプリは開発モードで実行されています

      または、 上記のように、WebStorm で起動時にアプリケーションを開くよう有効にできます。

    アプリケーションをデバッグする

    デバッグセッションは、 実行 / デバッグ構成を起動するから開始することも、開発モードでアプリケーションが実行されている URL を表示する 実行ツールウィンドウから開始することもできます。

    実行 / デバッグ構成を介してデバッグを開始する

    Svelte アプリケーションをデバッグするには、2 つの実行/デバッグ構成が必要です:

    • 上記のように、開発モードでアプリケーションを起動するための すでに npm 構成。

    • 開発モードで実行されているアプリケーションにデバッガーを接続するための JavaScript Debug 構成。

    npm 実行 / デバッグ構成を使用して Vite アプリケーションを実行およびデバッグするに従って、 すでに npm 構成内に JavaScript Debug 構成を作成して、一度に起動することができます。

    または、 すでに npm と JavaScript Debug の実行/デバッグ構成を、 JavaScript デバッグ実行/デバッグ構成でデバッグを開始の説明に従い、個別に作成して起動します。

    単一の npm 実行 / デバッグ構成で Svelte アプリケーションを実行およびデバッグする

    1. コードに ブレークポイントを設定します。

    2. 上記の説明に従ってすでに npm 構成を作成します。

      SvelteKit でアプリケーションを作成した場合、WebStorm はデフォルト名 dev で すでに npm 構成をすでに生成しています。 構成は 実行 ウィジェットから利用できます。

      自動生成された npm 実行 / デバッグ構成
    3. 開いた 実行 / デバッグ構成:npm ダイアログの 構成 タブで、 package.json の場所、Node.js ランタイム、および使用するパッケージマネージャーを指定します。

      コマンド フィールドで、リストから 実行 を選択し、次に スクリプト リストから実行するスクリプトを選択します。 ほとんどの場合、デフォルトの dev スクリプトになりますが、カスタムポートでアプリケーションを実行するなど、 package.json で別のスクリプトを構成することもできます。

      npm 実行 / デバッグ構成: 構成タブ
    4. ブラウザー / Live Edit タブで、 起動後 チェックボックスを選択し、リストから Google Chrome(英語) または別の Chromium ベースのブラウザー(英語)を選択し、 JavaScript デバッガーを使用して チェックボックスを選択して、アプリケーションを実行する URL を指定します。

      ブラウザー / ライブ編集タブ: ブラウザーを選択
    5. 実行 をクリックしてください。

      構成を再実行するには、 実行 ウィジェットのリストから構成を選択し、その横にある 実行 をクリックします。

      WebStorm はアプリケーションを開発モードで実行し、同時にデバッグセッションを開始します。

      デバッグセッション
    6. 最初のブレークポイントに到達したら、 デバッグツールウィンドウ に切り替え、通常どおり続行します: プログラムをステップ実行し、 プログラムの実行を停止して再開し、 中断時にそれを調べ 、コールスタックと変数を調べ、ウォッチを設定し、変数を評価し、 実際のHTML DOMを表示します。

      ソースマップを無視して実際に実行されるコードをステップ実行するには、 ソースマップ無効化トグルボタン を デバッグ ツールウィンドウのツールバーで押してください。 詳細については、 ソースマップを無効化 を参照してください。

    JavaScript デバッグ実行 / デバッグ構成でデバッグを開始する

    1. コードに ブレークポイントを設定します。

    2. 上記のように開発モードでアプリケーションを起動し、アプリケーションがコンパイルされて開発サーバーの準備ができるまで待ちます。

      実行 ツールウィンドウまたは ターミナル には、アプリケーションが実行されている URL が表示されます。 この URL をコピーして、 後で JavaScript デバッグ構成で指定します。

      アプリケーションは開発モードで実行されています
    3. JavaScript Debug 構成を作成します。 これを行うには、メインメニューの 実行 | 実行構成の編集 に移動し、 追加アイコン をクリックして、リストから JavaScript デバッグ を選択します。

    4. 開いた 実行 / デバッグ構成:JavaScript デバッグ ダイアログで、構成の名前と、開発モードでアプリケーションが実行されている URL アドレスを指定します。 この URL は、 実行 ツールウィンドウまたは ターミナル で、 上記のようにコピーできます。

      JavaScript デバッグ構成を作成する: URL を指定する
    5. デバッグ をクリックしてください。

      構成を再実行するには、 実行 ウィジェットのリストから構成を選択し、その横にある デバッグ をクリックします。

      実行ウィジェットから JavaScript デバッグ構成を実行する
    6. 最初のブレークポイントに到達したら、 デバッグツールウィンドウに切り替え、通常どおり続行します: プログラムをステップ実行し、 プログラムの実行を停止して再開し、 中断時にそれを調べ 、コールスタックや変数を確認し、ウォッチを設定して変数を評価し、 実際の HTML DOM を表示するなど、操作できます。

      ソースマップを無視して実際に実行されるコードをステップ実行するには、 ソースマップ無効化トグルボタン を デバッグ ツールウィンドウのツールバーで押してください。 詳細については、 ソースマップを無効化 を参照してください。

    実行ツールウィンドウまたは組み込みのターミナルからデバッグを開始する

    アプリケーションが localhost の開発モードで実行されている場合、特に SvelteKit(英語) で生成された場合は、 > 実行 ツールウィンドウまたは組み込みの ターミナル から直接デバッグセッションを開始できます。

    1. コードに ブレークポイントを設定します。

    2. 上記のように開発モードでアプリケーションを起動し、アプリケーションがコンパイルされて開発サーバーの準備ができるまで待ちます。

    3. 実行 ツールウィンドウまたは ターミナル には、アプリケーションが実行されている URL が表示されます。 Ctrl+Shift を押したまま、この URL リンクをクリックします。 WebStorm は、自動生成された 構成(タイプ JavaScript デバッグ )でデバッグセッションを開始します。

    最初のブレークポイントに到達したら、 デバッグツールウィンドウに切り替え、通常どおり続行します: プログラムをステップ実行し、 プログラムの実行を停止して再開し、 中断時にそれを調べ 、コールスタックや変数を確認し、ウォッチを設定して変数を評価し、 実際の HTML DOM を表示するなど、操作できます。

    ソースマップを無視して実際に実行されるコードをステップ実行するには、 ソースマップ無効化トグルボタン を デバッグ ツールウィンドウのツールバーで押してください。 詳細については、 ソースマップを無効化 を参照してください。

    アプリケーションをテストする

    Test Svelte application

    WebStorm で Svelte アプリケーションをテストする推奨方法は、 Vitest フレームワークを使用することです。

    上記のように SvelteKit を使用してアプリケーションを作成する場合は、プロジェクト生成ウィザードを通過するときに 単体テスト用に Vitest を追加 オプションを選択します。

    Vitest サポートを追加

    プロジェクト内で複数のフレームワークを使用する

    場合によっては、1 つの Svelte プロジェクト内で他のフレームワークを使用する必要があることがあります。

    各ファイルでコンテキスト認識コーディング支援を受けるには、構成ファイル .ws-context を作成し、各ファイルまたはフォルダーで使用するフレームワークを指定します。 このファイルの設定は、デフォルトの構成を上書きします。

    1. プロジェクトルートで、コンテキストメニューから 新規 | ファイル を選択し、ファイル名として .ws-context を指定します。

    2. .ws-context では、次の 2 種類のプロパティを使用します。

      • コンテキスト値文字列を持つ <context-name>

      • コンテキスト詳細オブジェクト付き GLOB パターン

    3. 次のコンテキスト値を使用してください:

      • framework: vue、 angular、 react、 svelte、 astro

      • angular-template-syntax: V_2、 V_17

      • nextjs-project: nextjs

      • astro-project: astro

      • vue-store: vuex、 pinia

      • vue-class-component-library: vue-class-component、 vue -property-decorator、 vue-facing-decorator

      • jsdoc-dialect: jsdoc-typescript、 jsdoc-closure

    4. 簡単にするためにパスのネストを使用します。

      • GLOB パスの最後のセグメントはファイル名パターンであり、 * ワイルドカードのみがサポートされます。

      • 最後のセグメントが ** の場合、ネストされたすべてのディレクトリとファイルと一致します。

      • 最上位レベルのコンテキストプロパティには /** パターンが必要です。

    5. 複数のパターンが同じファイル名に一致する場合、曖昧さを解消するために次のルールが使用されます:

      • ** セグメントを除いて、パスセグメント数が最大となるパターンを選択します。

      • 純粋なファイル名パターン、つまり ** または / で終わらないものを選択してください。

      • 最初に定義されたパターンを選択します。

    サンプル

    さまざまなフォルダーで複数のフレームワークを使うプロジェクトがあるとします。

    異なるフレームワークを持つプロジェクト

    プロジェクト内の各ファイルに対してコンテキスト認識型の支援を受けるには、次のコードを .ws-context に追加します。

    { "framework": "vue", "angular-template-syntax": "V_2", "src/**/app/**": { "framework": null, "app.component.html" : { "framework": "angular", "angular-template-syntax": "V_17" } }, "src/**/p*-editor/*.html" : { "framework" : "angular" } }
    2026 年 11 月 6 日