サクラエディタ マクロの使い方：5分で分かる記録・保存・登録とJS化

先に結論：マクロは用途で3種類を使い分ける

サクラエディタ マクロは、録画のように操作を記録する方法と、マクロファイルを直接書く方法に分けると理解しやすくなります。毎回同じカーソル移動や挿入を行うなら記録型で十分です。一方、選択文字列を判定する、正規表現で置換する、外部コマンドを呼ぶ、といった処理はスクリプト型に分けたほうが保守しやすくなります。

キーマクロを記録・保存・実行する基本手順

キーマクロは、短い繰り返し作業を素早く自動化する入口です。いきなり本番ファイルで記録せず、数行だけのテスト文書を作り、カーソル位置、選択範囲、改行コードを決めてから始めます。記録中にマウス操作や環境依存の位置指定を多用すると、別の文書で再現しにくくなります。

記録した直後は、同じファイルで一度だけ実行し、次に少し違うサンプルで試します。例えば行末に文字を追加するマクロなら、空行、末尾空白ありの行、最終行に改行がないケースを入れて確認します。動作が安定してから保存し、登録済みマクロに追加するのが実務では安全です。

1. テスト用テキストを用意する本番データではなく、成功例と失敗しそうな行を混ぜた短いサンプルで始めます。
2. 記録を開始して最小手順だけ実行するカーソル移動、選択、検索、置換など、再現したい操作だけに絞ります。
3. 記録を終了してすぐ実行する同じ文書で確認した後、別サンプルでも同じ結果になるかを見ます。
4. 名前を付けて保存し登録するよく使う処理だけ共通設定のマクロ一覧に登録し、必要ならキー割り当てします。

検索・置換をマクロ化する前の考え方

検索や置換は、マクロ化すると便利な一方で、対象範囲を間違えると大量の行を一度に変えてしまいます。先に検索条件を通常の検索・置換画面やオンライン正規表現テストで確認し、対象件数、前方一致・後方一致、改行を含むかどうかを見てからマクロに入れるのが安全です。

特に「選択範囲だけ処理する」「一致しない行だけ残す」「改行コードをまたいで置換する」処理は、キーマクロよりスクリプト化したほうが読み直しやすくなります。マクロ本文には、入力例、期待結果、対象外にしたいケースをコメントとして残してください。

// Example idea only: test the pattern before running it on real files
var text = Editor.GetSelectedString(0);
if (text !== "") {
  // Keep the rule small and test it with sample text first.
  Editor.InsText(text.replace(/old/g, "new"));
}

動かないときの切り分け表

マクロが動かないときは、コードを大きく書き換える前に、登録、拡張子、文字コード、選択範囲、実行環境を一つずつ分けて確認します。公式ヘルプでは、通常のマクロファイルはSJISとして読み込み、UTF-8 BOM付きならUTF-8として読み込む説明があります。日本語文字列を扱うマクロでは、この差が原因になることがあります。

また、登録済みマクロは別のマクロから使えないなど、メニュー操作とスクリプト実行では使える範囲が違うことがあります。うまく動かない処理は、まず最小のテキスト挿入だけに戻し、そこから検索、選択範囲、置換、外部コマンドの順に足していくと原因を見つけやすくなります。