MATLAB コードファイルのデバッグ

R2021b 以降. 次を置き換え: Debug a MATLAB Program (R2021a).

MATLAB^® コードファイルの問題を診断するには、コードをエディターおよびライブエディターで対話的にデバッグするか、コマンドウィンドウでデバッグ関数を使用してプログラムによってデバッグします。

コードをデバッグする方法はいくつかあります。

セミコロンを削除して出力を表示する。
[ここまで実行] ボタンをクリックして、コードを特定の行まで実行して一時停止する。
[一時停止] ボタンをクリックして、長時間実行されているファイルを一時停止する。
[ステップイン] ボタンをクリックして、一時停止中に関数およびスクリプトにステップインする。
ファイルにブレークポイントを追加して、コードの実行時に特定の行で一時停止できるようにする。

デバッグを開始する前に、予期しない結果を避けるため、コードファイルを保存して、コードファイルとそれが呼び出すファイルがすべて検索パス上または現在のフォルダーに存在することを確認してください。MATLAB による未保存の変更の処理は、デバッグを行う場所によって異なります。

エディター — ファイルに未保存の変更が含まれている場合、MATLAB はファイルを保存してから実行します。
ライブエディター — MATLAB は、ファイル内のすべての変更を、保存されているかどうかに関係なく実行します。
コマンドウィンドウ — ファイルに未保存の変更が含まれている場合、MATLAB はそのファイルの保存されたバージョンを実行します。変更の結果は反映されません。

出力の表示

MATLAB コードファイルで問題が発生する箇所を特定する方法の 1 つとして、出力を表示します。行の出力を表示するには、その行の終わりからセミコロンを削除します。エディターでは、MATLAB はコマンドウィンドウに出力を表示します。ライブエディターでは、MATLAB は出力とその作成元のコード行を表示します。

たとえば、乱数データのベクトルをプロットし、プロット上に平均値を示す水平線を描画する plotRand.m というスクリプトがあるとします。

n = 50;
r = rand(n,1);
plot(r)

m = mean(r);
hold on
plot([0,n],[m,m])
hold off
title("Mean of Random Uniform Data")

2 行目の関数 rand の出力を表示するには、その行の終わりにあるセミコロンを削除します。MATLAB はコマンドウィンドウに r の値を表示します。

Command Window showing a call to the plotRand function followed by the resulting output, the value of r

ライブエディターでは、MATLAB は r の値と 2 行目を表示します。

plotRand live script with the semicolon removed from the end of line 2 and the resulting output, the value of r and the plot, displayed on the right

[ここまで実行] を使用したデバッグ

ワークスペース内のすべての変数の状態をコードの特定のポイントで確認するには、コードファイルを実行し、一時停止します。コードを指定の行まで実行してから一時停止するには、行の左側にある [ここまで実行] ボタンをクリックします。選択した行に到達できない場合、MATLAB はファイルの終わりかブレークポイントに達するまで実行を続けます。関数とクラスでは、指定された行までのみ実行でき、MATLAB が一時停止されると一時停止します。

R2021b より前: デバッグ時にカーソル位置まで実行してから一時停止するには、[エディター] タブに移動し、[カーソルまで実行] ボタンをクリックします。

たとえば、plotRand.m の 2 行目の左側にある [ここまで実行] ボタンをクリックします。MATLAB は plotRand.m を 1 行目から実行し、2 行目を実行する前に一時停止します。

plotRand script with the Run to Here button visible in the left margin, next to the line number for line 2

MATLAB が一時停止すると、複数の変化が発生します。

[デバッガー] パネルが開きます。 (R2025a 以降)
[エディター] タブまたは [ライブエディター] タブの [実行] ボタンが [続行] ボタンに変わります。
コマンドウィンドウのプロンプトが K>> に変わり、MATLAB がデバッグモードであり、キーボードで制御できることを示します。
MATLAB では、一時停止された行が緑色の矢印を使用して示され、緑色で強調表示されます。

ヒント

MATLAB の一時停止中にファイルを変更するのは避けることをお勧めします。MATLAB が一時停止している間に行った変更は、MATLAB がコードの実行を完了した後で再実行されるまで実行できません。

MATLAB で一時停止している行は、コードの実行を続行するまで実行されません。コードの実行を続行するには、 [続行] ボタンをクリックします。MATLAB は、ファイルの終わりかブレークポイントに達するまでファイルを実行し続けます。次に実行を一時停止するコード行の左側にある [ここまで続行] ボタンもクリックできます。

コードの実行を行単位で続行するには、[エディター] タブまたは [ライブエディター] タブの [ステップ] をクリックします。MATLAB は現在一時停止している行を実行し、次の行で一時停止します。

plotRand script with a green arrow and green highlighting on line 3, indicating that MATLAB is paused at line 3

デバッグ中の変数値の表示

MATLAB が一時停止している間に変数の値を表示するには、変数にカーソルを合わせます。変数の現在の値がデータヒントに表示されます。データヒントはカーソルを移動するまで表示されます。

plotRand script paused at line 2 with a data tip showing the size, data type, and value of the variable n

コマンドウィンドウに変数名を入力して変数の値を表示することもできます。たとえば、変数 n の値を表示するには、n と入力して Enter キーを押します。コマンドウィンドウに変数の名前とその値が表示されます。現在のワークスペースにあるすべての変数を表示するには、[ワークスペース] パネルを使用します。

詳細については、デバッグ中の値の検査を参照してください。

実行中のファイルの一時停止

実行時間の長いコードを実行中に一時停止して進行状況をチェックし、予期したとおりに実行されていることを確認できます。実行中のコードを一時停止するには、[エディター] タブまたは [ライブエディター] タブに移動して [一時停止] ボタンをクリックします。MATLAB は次の実行可能行で一時停止し、 [一時停止] ボタンが [続行] ボタンに変わります。コードの実行を続けるには、 [続行] ボタンをクリックします。

メモ

[一時停止] ボタンをクリックすると、自身のコードの外部から、MATLAB をファイル内で一時停止させることができることがあります。また、MATLAB が一時停止して [一時停止] ボタンが [続行] ボタンに変わるまでに大幅な遅延が発生する場合があります。場合によっては、MATLAB が一時停止しないこともあります。その理由は、一部の組み込みコードで MATLAB が一時停止できないためです。

関数へのステップイン

デバッグ時には、呼び出されたファイルにステップインして、値を調べたい点で一時停止することができます。ファイルにステップインするには、ステップインする関数またはスクリプトのすぐ左側にある [ステップイン] ボタンをクリックします。MATLAB では、別の関数またはスクリプトの呼び出しを含む行のみにこのボタンが表示されます。ステップインの後、ファイル先頭の [ステップアウト] ボタンをクリックして、呼び出された関数の残りを実行し、呼び出された関数を出てから一時停止します。

既定では、[ステップイン] ボタンはユーザー定義の関数とスクリプトについてのみ表示されます。すべての関数とスクリプトに対してボタンを表示するには、[ホーム] タブの [環境] セクションで [設定] をクリックします。その後、[MATLAB] 、 [エディター/デバッガー] を選択し、[デバッグ] セクションで [インラインの [ステップイン] ボタンを表示] オプションを [常に行う] に設定します。ボタンを表示しない場合は、[インラインの [ステップイン] ボタンを表示] オプションを [行わない] に設定します。

あるいは、[エディター] タブまたは [ライブエディター] タブの [ステップイン] ボタンまたは [ステップアウト] ボタンを使用して、デバッグ中に関数へのステップインとそこからのステップアウトを実行できます。これらのボタンは、[インラインの [ステップイン] ボタンを表示] の設定には従わず、常にユーザー定義の関数と MathWorks^® 関数でステップインとステップアウトを実行します。

関数呼び出しスタック

呼び出された関数またはファイルにステップインしたとき、現在の行で一時停止する前に実行した関数のリストが [デバッガー] パネルの [関数呼び出しスタック] セクションに表示されます。"関数呼び出しスタック" とも呼ばれるこのリストには、関数が順序付けられて表示されます。MATLAB が一時停止された現在のスクリプトまたは関数がリストの一番上に表示され、最初に呼び出されたスクリプトまたは関数がリストの一番下に表示されます。 (R2025a 以降)

[デバッガー] パネルが開いていない場合にこれを開くには、[エディター] タブまたは [ライブエディター] タブに移動し、[解析] セクションで [デバッガー] をクリックします。また、サイドバーの [パネルをさらに開く] ボタンを使用してパネルを開くこともできます。

Debugger panel with the Function call stack section showing that the debugger is paused at line 3 of plotRand.m

関数呼び出しスタック内の各関数には、対応するワークスペースがあります。ワークスペースは、MATLAB 内で作成した変数、またはデータファイルや他のプログラムからインポートした変数を格納します。コマンドウィンドウから代入される変数やスクリプトを使用して作成される変数は、ベースワークスペースに属します。関数内に作成される変数は、それ自身の関数ワークスペースに属します。現在のワークスペースの外にある変数の値を確認するには、[デバッガー] パネルの [関数呼び出しスタック] セクションで対応する関数を選択します。詳細については、デバッグ中の値の検査を参照してください。

R2025a より前: 関数呼び出しスタックはファイルの先頭に表示され、関数が順番に並んでいます。最初に呼び出されたスクリプトまたは関数が左に、MATLAB によって一時停止された現在のスクリプトまたは関数が右に表示されます。

ブレークポイントを追加してコードを実行

コード実行のたびに一時停止するコード行がファイルに含まれている場合、それらの行にブレークポイントを追加します。ブレークポイントは、エディターおよびライブエディター上で対話的に追加したり、コマンドウィンドウで関数を使ってプログラムによって追加したり、またはその両方の方法で追加したりできます。

ブレークポイントには、標準、条件付き、エラーの 3 種類があります。エディターまたはライブエディターで標準ブレークポイントを追加するには、ブレークポイントを設定する実行可能な行の左側にある行番号 (行番号が表示されていない場合は、グレーの領域) をクリックします。たとえば、plotRand.m の行番号 3 をクリックして、その行にブレークポイントを追加します。

plotRand script with a red breakpoint at line 3

ファイルを実行すると、MATLAB は、ブレークポイントによって示されたコード行で一時停止します。MATLAB で一時停止している行は、コードの実行を続行するまで実行されません。

たとえば、エディターで plotRand.m ファイルを開いた状態で、[エディター] タブの [実行] ボタンをクリックします。MATLAB は plotRand.m を 1 行目から実行し、3 行目を実行する前に一時停止します。

MATLAB が一時停止すると、複数の変化が発生します。

[デバッガー] パネルが開きます。[デバッガー] パネルを使用して、開いているすべての MATLAB コードファイル内のブレークポイントを管理できます。 (R2025a 以降)
[エディター] タブまたは [ライブエディター] タブの [実行] ボタンが [続行] ボタンに変わります。
コマンドウィンドウのプロンプトが K>> に変わり、MATLAB がデバッグモードであり、キーボードで制御できることを示します。
MATLAB では、一時停止された行が緑色の矢印を使用して示され、緑色で強調表示されます。

ヒント

コードの実行を続行するには、 [続行] ボタンをクリックします。MATLAB は、ファイルの終わりかブレークポイントに達するまでファイルを実行し続けます。コードの実行を行単位で続行するには、[エディター] タブまたは [ライブエディター] タブの [ステップ] をクリックします。MATLAB は現在一時停止している行を実行し、次の行で一時停止します。

さまざまなタイプのブレークポイントとその設定方法、クリア方法および無効化方法の詳細については、ブレークポイントを設定するを参照してください。

[デバッガー] パネルでのブレークポイントの管理

R2025a 以降

[デバッガー] パネルを使用して、ブレークポイントを管理できます。既定では、MATLAB がデバッグモードになると、[デバッガー] パネルが自動的に開きます。[デバッガー] パネルを手動で開くには、[エディター] タブまたは [ライブエディター] タブに移動し、[解析] セクションで [デバッガー] をクリックします。また、サイドバーの [パネルをさらに開く] ボタンを使用してパネルを開くこともできます。[デバッガー] パネルを非表示にするには、サイドバーの [デバッガー] アイコンをクリックします。

パネルの [ブレークポイント] セクションには、開いているすべての MATLAB コードファイルのブレークポイントがリストされます。このセクションの最初の 4 つのブレークポイント [エラーで一時停止]、[警告で一時停止]、[NaN または Inf で一時停止] および [抑制されていない出力で一時停止] はエラーブレークポイントです。これらのブレークポイントのいずれかを有効にすると、指定されたエラー条件が発生した場合に MATLAB は任意のファイルの任意の行で一時停止します。残りのブレークポイントはファイル別にグループ化されます。

リスト内のブレークポイントごとに、次のアクションを実行できます。

ブレークポイントを有効または無効にする。
ブレークポイントをクリアする。
ファイル内のブレークポイントに移動する。
ブレークポイント条件を設定または変更する。

[デバッガー] パネルが自動的に開かないようにするには、[デバッガー] パネルの左上にある [デバッガーの構成] ボタンをクリックし、[[デバッガー] パネルを自動で開く] オプションをクリアします。あるいは、[設定] ウィンドウの [MATLAB] 、 [エディター/デバッガー] ページでこのオプションを無効にすることもできます。

デバッグセッションの終了

問題を特定した後、デバッグセッションを終了するには、[エディター] タブまたは [ライブエディター] タブに移動し、 [停止] をクリックします。デバッグを終了すると、K>> プロンプトの代わりに通常のプロンプト >> がコマンドウィンドウに再表示されます。関数呼び出しスタックへはアクセスできなくなります。

混乱を避けるため、デバッグを完了したら、毎回必ずデバッグセッションを終了してください。デバッグ中にファイルに変更を加えて保存すると、MATLAB はデバッグセッションを終了します。MATLAB が一時停止しているときに応答しなくなる場合は、Ctrl + C キーを押してデバッグを終了します。

キーボードショートカットまたは関数を使用したデバッグ

ほとんどのデバッグ操作は、キーボードショートカットを使用するか、コマンドウィンドウで関数を使用して実行できます。次の表に、デバッグ操作と、それらを実行するために使用できる関連するキーボードショートカットおよび関数を示します。

アクション	説明	キーボードショートカット	関数
続行	ファイルの終わりか別のブレークポイントに達するまでファイルの実行を続けます。	F5	`dbcont`
ステップ	現在のコード行を実行します。	F10 (macOS システムでは Shift + Command + O)	`dbstep`
ステップイン	現在のコード行を実行し、実行した行に別の関数の呼び出しが含まれている場合は、その関数に入りステップ実行します。	F11 (macOS システムでは Shift + Command + I)	`dbstep in`
ステップアウト	ステップインの後、呼び出された関数の残りを実行し、呼び出された関数を出てから一時停止します。	Shift + F11 (macOS システムでは Shift + Command + U)	`dbstep out`
停止	デバッグセッションを終了します。	Shift + F5	`dbquit`
ブレークポイントの設定	ブレークポイントが存在しない場合、現在の行にブレークポイントを設定します。	F12	`dbstop`
ブレークポイントのクリア	現在の行のブレークポイントをクリアします。	F12	`dbclear`

参考

トピック

外部の Web サイト

Programming: Structuring Code (MathWorks Teaching Resources)

MATLAB コード ファイルのデバッグ