長い作品の検索で困るのは、見つからないことだけではありません。資料、旧稿、公開済み章まで一緒に見つかり、いま直すべき原稿の件数が分からなくなることもあります。そこで先に決めるのが「どの語を探すか」ではなく「どのフォルダを今回の母集団にするか」です。
この記事はテキストエディタ 検索を、置換の前工程ではなく独立した調査として扱います。ワークスペース全体と選択フォルダを同じ語で検索し、件数差とパスを記録するところで終了します。見つけた後に書き換える操作は扱いません。検索と変更を切り離すことで、除外した旧稿へ意図せず触れる危険も減らせます。
検索範囲を「作業対象一覧」として先に固定する
例ではワークスペース内に included と excluded を置きました。included には現在作業する三ファイル、excluded には参照用の archive.md があります。検索語は Old321 です。最初に記録する入力は、ワークスペースの絶対パス、選択フォルダの絶対パス、検索語の三点です。
重要なのは、選択フォルダ名だけで判断しないことです。同じ名前のフォルダが複数ある、シンボリックリンクや複製がある、昨日と場所が変わった、といった事故を避けるため、実際に渡すパスを記録します。公開資料では、ファイル、ワークスペース、選択したファイル・フォルダを検索範囲にでき、結果件数を表示し、結果をクリックして該当箇所へ移動できるとされています。これは画面機能の説明であり、以下のCLI件数とは別の根拠です。
全体検索を基準線にして混入を見つける
最初の実測は rune search find --workspace /private/tmp/rune-g2c3-studio-321-_7t6eafa --query Old321 --json です。範囲指定を付けない検索は、四ファイル、五件を返しました。その中には作業対象外の excluded/archive.md も含まれています。
この五件を「直すべき件数」と呼んではいけません。ここで得たのはワークスペース全体の基準線です。対象外の資料にも語が残っていること、選択フォルダ検索との差を検出できることが役割です。全体検索の合格条件は四ファイル五件を読み、アーカイブのパスを含むと確認できることです。
失敗は、全体件数だけを見て作業対象を五件と決めることです。復旧は、結果パスを一覧化し、対象フォルダと対象外フォルダへ分類してから、次の絞り込み検索を別実行することです。
選択フォルダ検索は別の実行として数える
次に同じコマンドへ --scope /private/tmp/rune-g2c3-studio-321-_7t6eafa/included を追加しました。結果は三ファイル、四件でした。excluded/archive.md は含まれていません。入力の違いは --scope の有無だけなので、四ファイル五件から三ファイル四件へ減った理由を説明できます。
絞り込み検索の合格条件は、三ファイル四件であることに加え、すべての結果パスが included の下にあり、アーカイブがゼロ件であることです。件数だけが四件でも、別フォルダのファイルが混ざっていれば不合格です。逆に、意図した三ファイルのうち一つが出なければ、検索語の表記、拡張子、選択パスを確認します。
ここでは置換コマンドを実行しません。検索結果は判断材料であり、変更許可ではないからです。語の意味や周辺文を読み、変更対象を決める工程は、別の記事や別の作業札で管理します。
0件と件数過多では復旧手順を変える
0件なら、まず検索語をコピーし直し、全角半角、空白、大文字小文字、前後の記号を確認します。次に --scope の絶対パスとフォルダ内のファイル一覧を照合します。いきなり全体検索へ戻して結果を採用せず、0件になった入力を保存して原因を特定します。
件数が多すぎる場合は、結果パスの先頭部分で分類します。対象外パスが混ざっていれば範囲指定の誤り、対象内だけで多ければ検索語が広すぎる可能性があります。語をより具体的にする場合も、元の検索結果を消さず、別の実行として残します。これにより「検索範囲を狭めた」のか「検索語を変えた」のかが追跡できます。
検索中に原稿を編集すると母集団が変わります。調査票を作る間は書き換えを止め、検索時刻と入力値を記録します。編集後に再検索するなら、それは検算として新しい行へ記録します。
三つの欄がそろえば調査を閉じられる
最後に、調査票へ「入力」「観測」「判定」を残します。入力はワークスペース、選択フォルダ、Old321。観測は全体四ファイル五件、選択フォルダ三ファイル四件。判定は対象外アーカイブ一件が全体検索にだけ存在し、絞り込みでは除外された、です。
この形なら、検索漏れと範囲混入を同時に見張れます。画面で検索する場合も、選択フォルダのパスと表示件数を保存し、結果をクリックして各パスを確かめます。担当者が交代しても、同じ入力から同じ母集団を再現できます。結果が正しいと確認しても、その場で一括変更へ進まず、検索調査はいったん完了させます。範囲を証明する仕事に集中することが、選択フォルダ検索の価値です。