CLion 2020.2ヘルプ

クイック・スタート・ガイド

0. 始める前に

CLionはクロスプラットフォームのIDEですか?

はい、Windows、macOS、LinuxにCLionをインストールして実行できます。

どのコンパイラとデバッガを使用できますか?

CLion supports GCC(英語) , Clang(英語) , and Microsoft Visual C++(英語) compiler . You can also work with インテルC++コンパイラ(英語) , however, mind that it is not officially supported (see the corresponding issue(英語)).

CLionはGDB(英語)LLDB(英語)のデバッガをバンドルしており、カスタムGDBバイナリに切り替えることができます(詳細はデバッグの章を参照)。

どのビルドシステムがサポートされていますか?プロジェクトのフォーマットは何ですか?

CLionはCMake(英語)ビルドシステムと完全に統合されています:CMakeプロジェクトをシームレスに作成、オープン、ビルドそして実行/デバッグすることができます。CMake自体はCLionにバンドルされているため、カスタムバージョンを使用することにしない限り、別途インストールする必要はありません。

Apart from CMake, CLion supports compilation database, Gradle , and Makefile projects. Currently, you cannot create a new project of these types within CLion, but you can open and manage an existing one with full code insight available.

Refer to プロジェクト・フォーマット for more detail.

事前に何かインストールする必要がありますか?

C/C++プロジェクトの場合、CLionはGCC/G++、Clang、またはMSVCツールセットを使用します。

Windowsでは、Microsoft Visual C++コンパイラーを使用する予定の場合は、MinGW(英語) / MinGW-w64(英語)またはCygwin(英語)環境、WSL(英語)、またはVisual Studio(英語)のいずれかを選択できることを意味します。詳細はCLion Windows Tutorialを参照ください。

On macOS, the required tools might be already installed. If not, update command line developer tools as described in macOSでCLionを構成します

On Linux, compilers and make might also be pre-installed. Otherwise, in case of Debian/Ubuntu, install the build_essentials(英語) package and, if required, the llvm(英語) package to get Clang.

C++以外の他の言語もサポートされていますか?

はい、CLionはPythonObjective-C/C++、HTML(HTML5を含む)、CSS、JavaScript、およびXMLを完全にサポートしています。これらの言語のサポートは、デフォルトで有効になっているバンドルプラグインを介して実装されています。詳しくは異なる言語でのCLionの機能を参照してください。

他のプラグインをインストールして、CLionでより多くの言語をサポートすることができます(Rust(英語)Kotlin /ネイティブ(英語)Swift(英語)、またはMarkdown(英語)など)。貴重な言語プラグインを見て、設定/環境設定 Ctrl+Alt+Sプラグインページを探索してください。

1. プロジェクトを開く/作成する

ローカルプロジェクトを開く

CMakeプロジェクトの場合は、以下のいずれかのオプションを使用します。

  • ファイル | 開くを選択してプロジェクトディレクトリを見つけます。このディレクトリにはCMakeLists.txtファイルが含まれています。

  • ファイル | 開くを選択し、CLionを最上位のCMakeLists.txtファイルをポイントしてからプロジェクトとして開くを選択します。

  • ファイル | 開くを選択してCMakeCache.txtファイルを見つけ、プロジェクトとして開くを選択します。

compilation databaseプロジェクトを開くには、ファイル | 開くをクリックし、CLionをcompile_commands.jsonにポイントして、プロジェクトとして開くを選択します。

Gradleプロジェクトを開くには、ファイル | 開くをクリックし、CLionをbuild.gradleファイルにポイントして、プロジェクトとして開くを選択します。

リポジトリからチェックアウトする

  1. ようこそ画面でバージョン管理からチェックアウトをクリックするか、メインメニューからVCS | バージョン管理からチェックアウトを選択してバージョン管理システムを選択します。

  2. ストレージにアクセスするための資格情報を入力し、ソースへのパスを提供します。CLionは新しいCMakeプロジェクトにリポジトリをクローンします。

新しいCMakeプロジェクトを作成する

  1. メインメニューからファイル | 新規プロジェクトを選択するか、ようこそ画面で新規プロジェクトをクリックします。

  2. プロジェクトのタイプを設定します:CまたはC++、実行可能ファイルまたはライブラリ。

    STM32CubeMXCUDAもCMakeベースのプロジェクトタイプであることに注意してください。

  3. ルートフォルダーの場所を指定し、言語標準を選択します。

CLionは新しいCMakeプロジェクトを作成し、トップレベルのCMakeLists.txtを埋めます:

new cmake project

初期のCMakeLists.txtファイルには、すでにいくつかのコマンドが含まれています。私たちのチュートリアルで彼らの説明とCMakeを使った作業に関するより多くの情報を見つけてください。

2. 外観の確認

UI overview
  1. プロジェクト・ビューはあなたのプロジェクトファイルとディレクトリを表示します。ここから、プロジェクトフォルダーの管理(ソース、ライブラリ、または除外されたアイテムとしてのマーク付け)、新しいファイルの追加、プロジェクトの再読み込み再コンパイルなどの他のアクションの呼び出しを行うことができます。

  2. エディターはあなたのコードを表示、書き込み、編集するところです。エディターは各ファイルを別々のタブに表示します。同時に icons.actions.splitVertically.png または icons.actions.splitHorizontally.png を縦に分割して複数のタブを表示することもできます。

  3. ナビゲーションバーはファイルのタブを切り替えるのに役立ち、ツールバーは実行/デバッグおよびVSC関連のアクションへの素早いアクセスを提供します。

  4. 左ガター - エディターの左側にある縦縞 - ブレークポイントとクリック可能なアイコンが表示され、コード構造内を移動したりclion.icons.assocFile.pngの定義や宣言にジャンプしたり)、icons.actions.execute.png main() やテストを実行できます。

  5. 右ガターは、上部に全体的なファイル状況標識を付けてコード分析結果を表示します。

  6. ツール・ウィンドウは、TODO、CMake、ターミナル、ファイル構造などの特定のツールやタスクを表します。

  7. ステータス・バー shows various indicators for your project and the entire IDE: file encoding, line separator, memory usage, and others. Also, here you can find the resolve context switcher.

IDEアクションを見つける必要があるときはいつでも Ctrl+Shift+A を押すかヘルプ | アクションの検索にジャンプし、探しているコマンド、設定、さらにはUI要素の名前の入力を始めてください。

search for an ide action

3. 環境をカスタマイズする

IDEの外観を変更する

IDEの配色コードスタイルキーマップ表示モード、およびルックアンドフィール(UIテーマ)を切り替える最も簡単な方法は、切り替え...ポップアップです。起動するには、表示 | スキームのクイック切り替えをクリックするか Ctrl+`を押します。

switch pop-up

すべてのカスタマイズ可能なオプションを調べるには、設定/環境設定 Ctrl+Alt+Sの専用ページにアクセスしてください。

エディターを調整する

Pages under the エディター node of the 設定/環境設定 dialog help you adjust the editor’s behavior, from the most general settings (like Drag'n'Drop enabling and scroll configuration) to highlighting colors and code style options.

コードスタイルは、エディター | コード・スタイルノードのページで言語ごとに個別に設定できます。C/C++の場合は、事前定義されたコードスタイルの 1つを設定するか、独自のコードスタイルを提供し、ヘッダーガードテンプレートを含む希望の命名規則を構成できます。

Naming convention settings

キーマップを調整する

CLionでは、IDEで可能なほとんどすべてのアクションはキーボードショートカットにマッピングされています。デフォルトのマッピングを表示するには、ヘルプ | キーマップ・リファレンスを呼び出します。

設定/環境設定 | キーマップでショートカットをカスタマイズできます。事前定義済みのキーマップ(Visual Studio、Emacs、Eclipse、NetBeans、Xcodeなど)のいずれかを使用して必要に応じて調整するか、独自のキーマップを最初から作成します。

利用可能なキーマップのリストを拡張するプラグインもあります。例:VSコードキーマップ(英語)またはVim エミュレーション(英語)(これはVimのキーマップを含みます)。有用な非バンドル・プラグインでCLionエディター用のさらに便利なプラグインを見つけてください。

4. コード支援

自動補完

基本補完CLionの Ctrl+Space はタイプしているように働き、すべての利用可能な補完のリストを与えます。このリストをフィルタリングして予想されるタイプに一致する提案のみを表示するには、スマート補完 Ctrl+Shift+Spaceを使用します。

SmartType completion

コード生成

空のクラスや新しいC/C++ファイルでさえも、CLionが自動的に生成する定型コードを含んでいます。例:新しいクラスを追加すると、CLionは既に内部に配置されたスタブコードとヘッダーガードを持つヘッダーと、それを含む対応するソースファイルを作成します。

最も便利なコード生成機能の1つは、用途から作成することです。アイデアが浮かび上がってきてルーチンの面倒を見るときに、アイデアに集中できます。例:まだ実装されていない関数を呼び出すときは、流れを中断する必要はありません。Alt+Enter を押すと、後で戻ることができるスタブコードが生成されます。使用から作成は変数とクラスにも同様に働きます:

generate code from usage

コード内の任意の場所でコード生成オプションのリストを取得するには、Alt+Insert を押して生成メニューを呼び出します。

generate menu

これらのオプションは多くのコード作成をスキップできます。コンストラクター/デストラクタ、getter/setter、およびさまざまな演算子を生成することに加えて、関数をすばやくオーバーライドして実装することができます。

Implement functions

ライブ・テンプレートはコード構成全体を生成するためのツールです。設定/環境設定 | エディター | ライブ・テンプレートですぐに使えるテンプレートのリストを見つけてください。テンプレートをコードに貼り付けるには、コード | ライブ・テンプレートの挿入を呼び出すか Ctrl+Jを押します。

live template example

ループと if , while , for , #ifdefのような条件文でコードをすばやく囲むには、コード | 囲むを呼び出すか Ctrl+Alt+Tを押します。

surround with example

インテンションとクイックフィックス

コード内のシンボルの横に電球が表示されている場合は、CLionのコード分析によって潜在的な問題または行われる可能性のある変更が見つかったことを意味しています。

  • icons.actions.quickfixBulb.png はエラーを示し、それのための迅速な修正を選択することができます。

  • icons.actions.intentionBulb.png は、1つ以上のインテンションアクションが使用可能であることを示します。

電球アイコンをクリックして(または Alt+Enterキーを押して)最も適切なアクションを選択するかクイックフィックスを選択します。

Intention actions and quick-fixes in the editor

インスペクション

実行中のコード分析中に、CLionは疑わしいコードを強調表示し、右側のガターに色付きの縞を表示します。課題の説明を表示してクリックすると、対応する課題にジャンプすることができます。ガターの上部にある記号は、ファイル全体のステータスを示します。

Analysis results in the scrollbar

CLionはコンパイルエラーだけでなく、未使用の変数やデッドコードのようなコードの非効率性も検出します。また、Clang-tidyチェックのカスタマイズ可能なセットを統合しています。

インスペクションを有効または無効にするには、それらの重大度レベル(インスペクションがエラーを発生させるか、単に警告として表示するか)を設定し、スコープを設定して、設定/環境設定 | エディター | インスペクションに進みます。

プロジェクト全体またはカスタムスコープに対してインスペクションをオンデマンドで実行し、結果を別のウィンドウで表示することもできます。これを行うには、コード | コードのインスペクションを呼び出すか、特定のインスペクションに対してコード | 名前でインスペクションを実行 Ctrl+Alt+Shift+I を使用します。結果ウィンドウから、一度にいくつかの課題にクイックフィックスを適用することができます。課題を選択し、電球の icons.actions.intentionBulb.png ボタンをクリックして(または Alt+Enterを押して)適用する解像度を選択します。

Quick-fixes for several issues at a time

リファクタリング

リファクタリングは、新しい機能を追加することなくコードを改善し、よりクリーンで読みやすく、保守しやすくします。現在の場所で利用可能なリファクタリングのリストを取得するには、リファクタリングメニューを使用するか、リファクタリング... Ctrl+Alt+Shift+T を呼び出します。

retactor this popup

以下に例を示します。

  • 名前変更 Shift+F6 は、すべての参照のシンボルの名前を変更します。

  • シグネチャーの変更 Ctrl+F6 は、関数パラメーターを追加、削除、または並べ替え、戻り値の型を変更、または関数名を更新します(すべての使用箇所に影響します)。

  • インライン化 Ctrl+Alt+N / 抽出は、関数、typedef、変数、パラメーター、定義、または定数をインライン化または抽出します。

  • メンバーを上下にプルアップするリファクタリング | メンバーをプルアップする/メンバーを引き下げる)はクラスメンバーを安全に基本またはサブクラスに移動します。

5. コードを調べる

どこでも検索

CLionで何かを検索するには、それがあなたのコードベース、アクション、またはUI要素内のアイテムであれば、Shift を2回押して、どこでも検索ダイアログで探しているものをタイプし始めてください。検索条件を絞り込むには、フィルタ filter メニューを使用してください。

search everywhere popup

使用箇所の検索

コードシンボルの使用方法を見つけるには、使用箇所の検索Alt+F7 または編集 | 検索 | 使用箇所の検索)を呼び出します。結果をフィルタリングしてソースコードに戻ることができます。

find usages results

コード構造内を移動する

  • ヘッダファイルとソースファイルの切り替え Ctrl+Alt+Home

  • 宣言/定義に移動する

  • ファイル構造を表示

  • ビュー型階層構造 Ctrl+H

  • 呼び出し階層の表示 Ctrl+Alt+H

  • インポート階層の表示 Alt+Shift+H

コードのために、CLionはタイプ、呼び出し、インポートと機能の階層を構築します。表示するには、上記のショートカットまたはナビゲートメニューのコマンドを使用してください。例:型階層は、コードをナビゲートするだけでなく、コードベースにどのような型の関係が存在するかを発見するのにも役立ちます。

type hierarchy

現在開いているファイルの構造を調べるには、表示 | ツール・ウィンドウ | 構造を呼び出すか、または Alt+7を押します。

file structure

また、左のガターアイコンを使用して、宣言/定義clion.icons.assocFile.png にすばやくジャンプするか、クラス階層(the Implemented method icon / the Implementing method icon , the Overridden method icon / the Overriding method icon)をナビゲートします。

クイック・ドキュメントポップアップ(マウスホバーまたは Ctrl+Q ショートカットを介して利用可能)は、現在のコンテキストを移動せずに、キャレットにあるシンボルの詳細情報を取得できます。呼び出す要素に応じて、ポップアップに次のように表示されます。

  • 関数シグネチャーの詳細

  • コード文書 (通常のコメントまたはDoxygenコメント)

  • autoとして宣言された変数の推論型

    C++ inferred type in Quick Documentation popup

  • フォーマットされたマクロ展開

    Formatted macro expansion in Quick Documentation popup

そのうえ、即座にキャレットでシンボルの定義を見ることができます。 Ctrl+Shift+I を押してクイック定義ポップアップを呼び出します。

qucik definition

6. ビルドおよび実行

実行/デバッグ構成

CMakeまたはGradleプロジェクトの各ターゲットに対して、CLionは実行/デバッグ構成を作成します。これは、ターゲット、実行可能ファイル、プログラムに渡す引数、およびその他のオプションを含む、名前付きの実行/デバッグ構成です。

実行/デバッグ構成は、CMakeアプリケーションGoogleテストリモート GDBデバッグなどのテンプレートから生成されます。テンプレートはカスタマイズ可能です。テンプレートパラメータを編集すると、後でこのテンプレートから作成されるすべての設定のデフォルト設定を変更できます。

構成の編集ダイアログは実行メニューまたは設定スイッチャーからアクセスできます。ここでテンプレートを管理したり、設定を追加、削除、編集することができます。例:起動前を実行する手順をカスタマイズすることができます - 外部ツール(リモートを含む)を呼び出す、CMakeインストールを使用する、または別の設定を実行することさえできます。

run/debug configurations dialog

プログラムを起動するには、目的の設定を選択し、icons.actions.execute.png 実行メニューからコマンドを使用するか、または Shift+F10を押します。あるいは、Ctrl を2回押してなんでも実行ダイアログを呼び出し、構成名の入力を開始します。

run anything dialog
ヒント: Shift を押したままにするとなんでもデバッグに切り替わります。

ビルドアクション

ビルドは、デフォルトの起動前ステップとして、多くの実行/デバッグ構成テンプレートに含まれています。ただし、ビルドメニューから目的のアクションを呼び出すことで、個別に実行することもできます。

build menu

プロジェクト全体をビルドせずに選択したファイルをコンパイルする再コンパイルオプションに注目してください。

リモートと組み込み開発

CLionを使用すると、組み込みターゲットを含むリモートマシン上でビルドおよび実行/デバッグすることもできます。詳細はリモート開発STM32CubeMXプロジェクトを参照してください。

7. デバッグ

CLionは、すべてのプラットフォーム(Windowsでは、バンドルされたGDBはMinGW(英語)でのみ使用可能)のGDBバックエンドおよびmacOS / LinuxのLLDBと統合されます。すべてのプラットフォームでGDBのカスタムバージョンに切り替えることができます。また、CLionはWindows上のMSVCにLLDBベースのデバッガーを提供します。

現在、バンドルされているデバッガーのバージョンは次のとおりです。

  • macOS、Linux、およびWindows用のLLDB v 9.0.1 (MSVC)

  • macOS用GDB v 8.0.1

  • Windows用GDB v 8.3

  • Linux用GDB v 8.3

  • カスタムGDB v 7.8.x-8.3.x

To start a debug session, select the desired configuration and press Shift+F9 or click icons.actions.startDebugger.png . You can set breakpoints by clicking the gutter next to a code line. To follow through the execution process, use debugger's stepping actions stepping buttons .

デバッガツールウィンドウの変数タブでは、デバッグセッションを中断することなく、値を調べて変更することができます。式を評価するには、icons.debugger.evaluateExpression.png をクリックするか Alt+F8を押します。CLionは現在の変数の値をエディターに直接表示します。16 進表示を有効にした場合は、インライン表示されます。

clion debugger ui
便利なデバッガのショートカット
ブレークポイントの切り替えCtrl+F8
ブレークポイントの詳細/すべてのブレークポイントを表示するCtrl+Shift+F8
ステップ・オーバーF8
ステップ・インF7
停止Ctrl+F2
プログラムの再開F9
キャレット上のコードをデバッグ main()内のShift+F9

また、CLionデバッガを使用すると、逆アセンブルにステップインし、メモリービューを呼び出し、ローカルプロセスにアタッチし、 GDB / gdbserverを使用してリモートでデバッグすることができます。

8. 実行時に分析する

一部の脆弱性とバグは、プログラムの実行中にのみ明らかになる可能性があります:メモリリーク、初期化されていないアクセス、同時実行の課題、未定義の動作など。実行時の課題を把握するのに役立つように、CLionはValgrind MemcheckおよびGoogle Sanitizersを統合します。また、組み込みのCPUプロファイラを使用してアプリケーションのパフォーマンスを分析し、コードカバレッジを測定できます。これらのツールでは、CLionは視覚化された出力と、分析結果のインポート/エクスポートオプションなどの便利な機能を提供します。

Valgrind、Sanitizers、およびプロファイルの設定は、設定/環境設定 | ビルド、実行、デプロイ | 動的解析ツールにあります。

Valgrind Memcheck

CLionのValgrind Memcheckは、WSLを介してLinux、macOS、およびWindowsで動作します。Valgrindをインストールし(英語)、CLionをバイナリにポイントし、分析フラグを設定し、実行 | Valgrind Memcheckを実行するまたは icons.actions.startMemoryProfile.pngを使用してプログラムを実行する必要があります。

Google Sanitizers

Google Sanitizersは、特定のバージョンのClangおよびGCCについてLinuxでサポートされています。CLionでのSanitizersの使用に関する詳細なガイドを参照してください。

CPUプロファイラ

CLion’s profiler, available on Linux and macOS, collects performance data for both user and kernel code of your application. The profiler collects performance metrics and visualizes them in flame charts and statistic views. To run it, call 実行 | プロファイル or use the icons.toolwindows.toolWindowProfiler.png button in the navigation bar.

コード・カバレッジ

CLionでのコード・カバレッジの統合は、llvm-cov / gcovツールに基づいており、CMakeアプリケーションおよびテストに利用できます。カバレッジ結果は、起動中にカバーされたフォルダーごとのファイルのパーセンテージとファイルごとの行を示します。カバレッジ測定値を取得するには、必要なコンパイラフラグを設定してカバレッジで実行を呼び出すか、icons.general.runWithCoverage.pngをクリックします。

9. 単体テストを追加する

CLion supports Googleテスト , Boost.Test , and Catch(2) test frameworks with the built-in test runner and dedicated Run/Debug configurations. For CMake targets linked with gtest or gmock, CLion creates Google Test configurations automatically.

テストの実行は、通常の実行可能ファイルの実行と似ています。CLionは、指定されたテストクラスまたはメソッドをテストランナーに渡します。テストランナーは、進行中のテストの進行状況バー、出力ストリーム、およびツリービューを表示し、それらのステータスと期間を示します。

test runner

特定のテスト、すべてのテスト、または失敗したテスト icons.runConfigurations.rerunFailedTests.pngのみを再実行して、テスト結果をエクスポートし、履歴から以前の結果を開くことができます。

左のガターの中のアイコンはすぐにテストを実行/デバッグして、テストステータス、成功 icons.runConfigurations.testState.green2.png または失敗 icons.runConfigurations.testState.red2.pngをチェックできます:

gutter icons for running tests

10. バージョン管理下に置く

VCS

CLionは、いくつかのバージョン管理システム (Git(またはGitHub)、Mercurial、Perforce、およびSubversion)と統合します。特定のVCSの設定を管理するには、設定/環境設定 | バージョン管理に進みます。

バージョン管理コマンドを呼び出すには、VCS 操作のポップアップAlt+` またはVCS | VCS 操作のポップアップ)を使用してください。このポップアップ内のアクションのリストには、現在有効になっているVCSとローカル・ヒストリーの両方が含まれています。例:

VCSが有効になっていませんVCSを有効にする
cl vcs disabled png
cl vcs enabled png

メインメニューのVCSセクションに、利用可能なすべてのVCSコマンドがあります。また、ツールバーからいくつかの基本的なコマンドにアクセスできます。

vcs command in navigation bar

ローカル・ヒストリー

完全なバージョン管理に加えて、戻ってローカルヒストリーを拾い読みすることによって段階的に変更を検討することができます。ファイルやフォルダーを表示するには、VCS | ローカル・ヒストリー | ヒストリーの表示を呼び出します。ここで変更を元に戻してパッチを作成できます。

local history

11. さらに学習したい方に

CLionの基本事項のこの短い概要があなたに迅速なスタートを与えることを願っています。さらに深く掘り下げるために、webhelpの他の記事やセクションを参照してください。

ニュースと役立つヒントについては、twitter(英語)CLionブログ(英語)を確認してください。

コミュニティフォーラム(英語)で質問をしてください。CLion課題トラッカー(英語)で遠慮なく問題を報告してください。

最終更新日: 2020年8月04日

関連ページ:

CLionをインストールする

CLionは、Windows、macOS、およびLinuxで一貫したエクスペリエンスを提供するクロスプラットフォームIDEです(FreeBSDでのセットアップについては、この手順を参照してください)。システム要件:RAM2 GBの空きRAM8 GBの総システムRAMディスク容量2.5 GBおよびキャ...

CLionキーボードショートカット

CLionには、編集、ナビゲーション、リファクタリング、デバッグ、およびその他のタスクに関連するほとんどのコマンドのキーボードショートカットがあります。これらのホットキーを覚えておくと、キーボードから手を離すことなく生産性を維持できます。英語のレイアウトのキーボードを使用してください。CLionは他...

クイックCMakeチュートリアル

このチュートリアルは簡単なCMakeプロジェクトの作成と開発のプロセスを通してあなたを導きます。ステップバイステップで、ビルドシステムとしてのCMakeの基本と、CMakeプロジェクトのためのCLion設定およびアクションを学びます。以下で使用されるサンプルプロジェクトのソースコードは、GitHub...

Compilation Database

CMake、Gradle、またはMakefileに基づいていないプロジェクトで作業している場合でも、CLionが提供する高度なIDE機能を利用できます。1つの方法は、非CMakeプロジェクトをインポートし、CLionにそれを単純なCMake構造に変換させることです。別のオプションは、compilat...

Gradleサポート

GradleはC/C++ライブラリとアプリケーションを構築するためのプラグインを提供する構築自動化システムです。CLionでは、cpp-applicationおよびcpp-libraryプラグインをベースにしたGradleプロジェクトを操作できます(C/C++ Gradleプラグインの詳細については...

Makefile

CLionにMakefileプロジェクトをロードして、IDEが提供するすべてのスマート機能を利用できます。CLionでのMakefilesのサポートは初期段階であることに注意してください。CPP-494にリンクされたチケットを使用して、フィードバックを残し、目的の機能に投票してください。Makefi...