llms.txt: machine-readable documentation index. Markdown version of this page is also available.

CLion 2026.3 Help

CoffeeScript

With CLion, you can use CoffeeScript that compiles into JavaScript. CLion recognizes *.coffee files and marks them with CoffeeScript アイコン. You can set breakpoints directly in your CoffeeScript code, and CLion recognizes them using source maps generated during compilation.

CLion helps you write CoffeeScript code by suggesting completion for keywords, labels, variables, parameters and functions. シンボルから宣言 Ctrl+B または実装 Ctrl+Alt+B に移動したり、名前 Ctrl+Alt+Shift+N のシンボルを検索したりできます。

CLion integrates with the coffeescript compiler that translates CoffeeScript code into JavaScript. The tool also creates source maps that set correspondence between lines in your CoffeeScript code and in the generated JavaScript code so that CLion debugger recognizes breakpoints in your CoffeeScript code and processes them correctly.

始める前に

  1. Node.js をダウンロードしてインストールします。

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

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

CoffeeScript を JavaScript にコンパイルする

コードを自動的にコンパイルするには、ファイルへの変更を追跡してコンパイラーを実行する CoffeeScript ファイルウォッチャーを構成する必要があります。

ファイルを開くと、CLion は現在のプロジェクトで適用可能な File Watcher が利用できるかどうかを確認します。 そのような File Watcher が構成されているが無効の場合、CLion は構成済みの File Watcher を通知し、有効化を提案するポップアップを表示します。

現在のプロジェクトで該当する File Watcher が構成され有効化されている場合、CLion は New Watcher dialogで指定されたイベントが発生すると自動的にコンパイラーを起動します。

  • 編集したファイルを自動保存してウォッチャーをトリガーする チェックボックスが選択されている場合、ソースウォッチに変更が加えられるとすぐに File Watcher が呼び出されます。

  • 編集したファイルを自動保存してウォッチャーをトリガーする チェックボックスがオフの場合、保存時(ファイル | すべて保存、 Ctrl+S )または CLion からフォーカスを移動したとき(フレームの非アクティブ化時)に File Watcher が起動します。

詳細については、 File Watchers を参照してください。

コンパイラーは生成された出力を別のファイルに保存します。 ファイル名はソースファイル CoffeeScript と同じで、コンパイラーの種類に応じて拡張子は .js または .js.map となります。 生成されたファイルの場所は、 リフレッシュする出力パス フィールド(新規ウォッチャーダイアログ )で定義されます。 Based on this setting, CLion detects the compiler output. ただし、 プロジェクト ツールウィンドウ (Alt+1) では、ソースファイル coffee に表示され、ソースファイルはノードとして表示されます。

CoffeeScript コンパイラーをインストールする

  1. コマンドライン シェルまたは埋め込み ターミナルエミュレータ (Alt+F12 )で、次のいずれかのコマンドを入力してください:

CoffeeScript ファイルウォッチャーを作成する

  1. Ctrl+Alt+S を押して設定を開き、 ツール | File Watchers を選択します。

  2. 追加ボタン をクリックするか、 Alt+Insert を押して、リストから CoffeeScript 定義済みテンプレートを選択します。 コードは JavaScript に翻訳され、生成された ソースマップ(英語)とともに提供されます。

コンパイラーの動作をカスタマイズする

With CLion, you can adjust the compiler by passing arguments to it just as if you were working in the command-line mode. 以下は、 CoffeeScript コンパイラーのデフォルトの出力場所をカスタマイズする例です。

次のフォルダー構造のプロジェクトがあるとします:

ファイルウォッチャーのフォルダー構造の例

デフォルトのファイルウォッチャーでは、生成されたファイルは元のファイルの子として表示されます。

デフォルトのファイル監視出力

このデフォルトの場所を変更して、生成されたファイルを別の JavaScript フォルダーに保存することができます。

生成されたすべてのファイルを出力 JavaScript フォルダーに保存する

  1. CoffeeScript ファイルウォッチャーを作成します。

    CoffeeScript ファイルウォッチャーを作成する
  2. 引数 フィールドに、次の内容を入力します:

    --map --compile -o $ProjectFileDir$/JavaScript $FileName$
  3. リフレッシュする出力パス フィールドに、次の内容を入力します:

    $ProjectFileDir$/JavaScript/$FileNameWithoutExtension$.js:$ProjectFileDir$/JavaScript/$FileNameWithoutExtension$.map:$FileNameWithoutExtension$.js.map

その結果、プロジェクトツリーは次のようになります:

カスタム出力、フラット構造

生成されたファイルを、 アプリ ノードの元の構造を繰り返すフォルダー構造に格納することもできます。

出力フォルダーに元のフォルダー構造を保持する

  1. CoffeeScript ファイルウォッチャーを作成します。

  2. 引数 フィールドに、次の内容を入力します:

    --map --compile -o $ProjectFileDir$/JavaScript/$FileDirRelativeToProjectRoot$ $FileName$
  3. リフレッシュする出力パス フィールドに、次の内容を入力します:

    $ProjectFileDir$/JavaScript/$FileDirRelativeToProjectRoot$/$FileNameWithoutExtension$.js:$ProjectFileDir$/JavaScript/$FileDirRelativeToProjectRoot$/$FileNameWithoutExtension$.map:$FileNameWithoutExtension$.js.map

その結果、プロジェクトツリーは次のようになります:

カスタム出力、フォルダー構造は保持

コンパイラーを実行せずにコンパイル結果をプレビューする

CLion は実際にコンパイラーを実行せずに CoffeeScript コードの静的解析を行い、予測されるコンパイル出力を専用の読み取り専用ビューアーに表示できます。

  1. エディターで目的の CoffeeScript ファイルを開き、エディターの背景を右クリックします。

  2. コンテキストメニューから コンパイル済み CoffeeScript ファイルのプレビュー を選択します。 プレビューは専用の読み取り専用ビューアーで開かれます: 左側のペインには元の CoffeeScript ソースコードが表示され、右側のペインにはコンパイラーの実行時に生成される JavaScript コードが表示されます。

CoffeeScript の実行

CLion で CoffeeScript を実行する方法は二通りあります:

  • CoffeeScript コードを手動でコンパイルし、出力された JavaScript コードを Node.js アプリケーションとして実行します。

  • 元の CoffeeScript コードを Node.js 実行構成で実行し、CLion にその場でコンパイルさせます。

CoffeeScript を手動でコンパイルし、生成された JavaScript コードを実行する

  1. CoffeeScript コードを Javascript にコンパイルします。

  2. Node.js の実行構成の作成を開始するを次の必須設定で使用します。

    1. 使用する Node.js エンジン。 デフォルトでは、このフィールドには Node.js 構成時に JavaScript ランタイムページで指定したランタイムへのパスが表示されます。

    2. 作業ディレクトリ フィールドには、起動する CoffeeScript ファイルから参照するファイルの場所を指定します(例: includes)。 このファイルが他のファイルを参照していない場合は、フィールドを空のままにしてください。

    3. ノードアプリ JS ファイルへのパス フィールドに、コンパイル中に元の CoffeeScript ファイルから生成された JavaScript ファイルへの絶対パスを指定します。

  3. 設定を保存し、ダイアログで 実行 をクリックします。

    あるいは、メインツールバーのリストから新しく作成した実行構成を選択し、 the Run button をクリックします。

  4. Node.js アプリケーションの実行の間に進みます。

実行中にオンザフライで CoffeeScript をコンパイルする

  1. このモードでは、 coffeescript パッケージの一部である register.js ファイルがプロジェクト内に配置されている必要があります。 したがって、 CoffeeScript コンパイラーをインストールするの説明に従って、 coffeescript パッケージがローカルにインストールされていることを確認してください。

  2. エディターで開始用の CoffeeScript ファイルを開くか、 プロジェクト ツールウィンドウ (Alt+1) でファイルを選択し、コンテキストメニューから <CoffeeScript_file_name> を実行します を選択します。 CLion runs the file with the automatically generated run/debug configuration.

    または、コンテキストメニューから <CoffeeScript_file_name> を作成 を選択し、開いた 実行/デバッグ構成: Node.js ダイアログで次の必須設定を確認します:

    1. 使用する Node.js ランタイム。 適切なランタイム構成を選択するか、新しい構成を作成してください。 デフォルトでは、このフィールドには Node.js 構成時に JavaScript ランタイムページで指定したランタイムへのパスが表示されます。

      Linux と macOS では、この設定は CoffeeScript コンパイラーの実行可能ファイルへのパスにある Node.js によってオーバーライドされます。

    2. ノードパラメーター フィールドに --require coffeescript/register と入力します。

    3. 作業ディレクトリ フィールドで、アプリケーションの 作業ディレクトリ(英語)を指定します。 デフォルトでは、フィールドに プロジェクトルートフォルダー が表示されます。

    4. ファイル フィールドで、実行する CoffeeScript ファイルへのフルパスを指定します。

  3. 設定を保存し、ツールバーの the Run button をクリックします。

    あるいは、メインツールバーのリストから新しく作成した実行構成を選択し、 the Run button をクリックします。

  4. Node.js アプリケーションの実行の間に進みます。

CoffeeScript のデバッグ

CLion で CoffeeScript をデバッグするには、JavaScript コードに加えて生成される ソースマップ が必要です。 ソースマップ は CoffeeScript コードと生成された JavaScript コードの行間の対応を設定し、対応がない場合、ブレークポイントは認識されず、正しく処理されません。 JavaScript とソースマップは、 CoffeeScript タイプのファイルウォッチャーを使用して CoffeeScript コードを手動でコンパイルすることで生成されます。 その後、出力された JavaScript コードを Node.js アプリケーションとしてデバッグできます。

CoffeeScript のデバッグは、 ローカルモードでのみサポートされています。 This means that CLion itself starts the Node.js engine and the target application according to a run configuration and gets full control over the session.

Node.js アプリケーションのデバッグの詳細については、「Node.js の実行とデバッグ 」を参照してください。

CoffeeScript コードをデバッグする

  1. 必要に応じて、CoffeeScript コードに ブレークポイント を設定します。

  2. タイプ CoffeeScript の File Watcher を使用する CoffeeScript コードを Javascript にコンパイルします。

  3. Node.js の実行構成の作成を開始するを次の必須設定で使用します。

    1. 使用する Node.js エンジン。 デフォルトでは、このフィールドには Node.js 構成時に JavaScript ランタイムページで指定したランタイムへのパスが表示されます。

    2. 作業ディレクトリ フィールドには、起動する CoffeeScript ファイルから参照するファイルの場所を指定します(例: includes)。 このファイルが他のファイルを参照していない場合は、フィールドを空のままにしてください。

    3. ノードアプリ JS ファイルへのパス フィールドに、コンパイル中に元の CoffeeScript ファイルから生成された JavaScript ファイルへの絶対パスを指定します。

  4. 設定を保存し、ツールバーの the Debug button をクリックします。

  5. Node.js アプリケーションと一緒にローカルでデバッガーを起動する場合に進みます。

CoffeeScript のリファクタリング

CoffeeScript コンテキストでは、CLion でファイルやフォルダーのコピー・名前変更・移動・安全な削除がサポートされています。詳細は リファクタリング をご参照ください。

  • ファイルまたはフォルダーをコピー、名前変更、移動、または安全に削除するには、 プロジェクト ツールウィンドウで選択し、コンテキストメニューから該当するアクションを選択します。

    CoffeeScript のリファクタリング - プロジェクトツールウィンドウからアクションを実行
  • ファイルを移動またはコピーするには、エディターで開き、コンテキストメニューから リファクタリング | ファイルのコピー または リファクタリング | ファイルのコピー を選択します。

    CoffeeScript のリファクタリング - エディターからアクションを実行

構文ハイライトの構成

環境設定や使用習慣に合わせて、CoffeeScript 対応の構文ハイライトを設定できます。

  1. 設定 ダイアログ(Ctrl+Alt+S )で エディター | カラースキーム | CoffeeScript に移動します。

  2. カラースキームを選択し、デフォルトから継承されたハイライト設定を受け入れるか、 色とフォント に記載されている手順に従ってカスタマイズしてください。

2026 年 11 月 6 日