検索構文

SwiftList のクエリボックスは、単純な入力以上のことに対応しています。以下の演算子はすべて、同じクエリの中で通常のあいまい検索語と組み合わせて使えます。

あいまい検索 (既定)

名前の一部を入力すると、その文字がファイル/フォルダー名のどこかに順番どおりに出現する限り、SwiftList はそれを見つけます。連続した部分文字列を入力する必要はありません:

入力	一致する例
swlst	SwiftList.exe
report	Q3-report-final.docx

設定 → 一般 → システム → あいまい一致を有効化 でこの設定をオフにすると、演算子の付いていない通常の検索語は連続した部分文字列として現れる必要があります — abc は a-b-c に一致しなくなります。以下の表にある演算子はすべて、この設定の状態に関わらず同じように動作します。この設定が変えるのは通常の検索語に対する要件だけです。' 演算子はこの設定の状態に関わらず、その語 1 つだけ厳密さを反転させるため、あいまい一致の語を厳密なクエリの中に混ぜたり、逆にあいまいなクエリの中に厳密な語を混ぜたりするのに使えます。設定自体を変更する必要はありません。

複数の単語

単語をスペースで区切ります。各単語は検索結果をさらに絞り込みますが、入力した順序どおりに単語が並んでいる必要は ありません:

report final

は Q3-report-final.docx と同様に final-Q3-report.docx にも一致します。

大文字・小文字の区別

• すべて小文字 のクエリは大文字・小文字を区別しません: myfile は MyFile、MYFILE などに一致します。
• 大文字を含む クエリは、その語について大文字・小文字を区別するようになります: MyFile は MyFile にのみ一致し、myfile には一致しません。

演算子

接頭辞/接尾辞	例	効果
(なし)	report	名前のどこかにあいまい一致 (既定)。
!	!temp	名前に temp という完全な部分文字列を含む結果を 除外 します (これはあいまい一致ではありません)。
'	'report	この語 1 つだけ 厳密さを反転 させます — あいまい一致が有効(既定)なら完全な部分文字列一致に、設定であいまい一致を無効にしている場合はこの語だけあいまい一致に戻ります。
'...'	'final report'	単語境界にアンカーされた完全一致 (より大きな単語の内部には一致しません)。
^	^IMG	前方一致 — 名前が IMG で始まる必要があります。
$	.pdf$	後方一致 — 名前が .pdf で終わる必要があります。
^...$	^readme.md$	完全一致 — 名前が readme.md とまったく同一である必要があります。両方が同じ単語を挟んでいる場合のみです。別々の単語に付いている場合は、それぞれ独立した前方一致と後方一致のままです。
|	report | summary	OR — パイプのどちらか一方に一致します。

これらは自由に組み合わせられます。例えば ^IMG !.png$ 2024 は、IMG で始まり、2024 年のもので、かつ PNG では ない ファイルを見つけます。

OR クエリでは、ある検索結果に実際に一致したすべての語が、最初に一致した語だけでなく、その名前の中でハイライトされます。そのため report | summary は、両方の単語を含む検索結果ではその両方がハイライトされます。

複数行の貼り付け

複数行を含むテキスト (例えば、スプレッドシートやテキストファイルから 1 行ずつコピーしたファイル名) を貼り付けると、SwiftList はそれをそのまま貼り付けるのではなく、自動的に OR クエリに変換します:

123
456
678

は 123 | 456 | 678 として貼り付けられ、3 つのいずれかに一致します。空行はスキップされます。通常の 1 行のみの貼り付けには影響しません。

ドライブを指定する

クエリの先頭にドライブレターとコロンを付けると、そのドライブに検索結果を限定できます。その後は通常どおり検索語を続けて入力します:

d: report

は D: ドライブのみを検索します。

スペースは省略できます。d:report は d: report と同じ意味です。

パスモード

クエリにパス区切り文字 (\ または /) が含まれている場合、SwiftList はパスモードに切り替わり、名前だけでなくフルパスに対して一致を行います。既知のフォルダーへ直接ジャンプしたいときに便利です:

D:\Projects\SwiftList

末尾に区切り文字を付けた場合 (D:\Projects\) は、そのフォルダー自体の 中身 を検索します。

フォルダー名で絞り込む

クエリの末尾に ::<text> を付け加えると、その検索結果自身の名前、または祖先フォルダーのいずれかが <text> に一致することを追加の条件にできます (あいまい検索で、ピンインも含め他の場所と同じマッチング方式です):

1080 ::wallpapers

は、wallpapers に一致するフォルダーの配下のどこかにある、名前に 1080 を含むファイルを見つけます。正確なパスを知っていたり入力したりする必要はありません。複数のフィルターはカンマで組み合わせられます: report ::2024,:final。

語がファイルではなくフォルダーを表している場合

ファイル/フォルダー名だけでは結果が埋まらなかった場合、SwiftList は自動的にそれを補い、語が祖先フォルダーにも一致できるようにします——特別な構文は不要です:

d01j dcj

は、dcj がそのファイル自身の名前には一切現れなくても、d01j という名前のファイルが dcj という名前(またはそれにエイリアスされた名前)のフォルダーの中にあれば見つけます。これは、ファイル自身の名前でカバーされなかった部分を、そのファイルより上にあるフォルダーの名前で補うだけの仕組みです——少なくとも 1 つの語はファイル名自体に一致する必要があり、通常の名前だけの検索がページを埋めきらなかった場合にのみ発動します。見つかったものはそれらの結果に混ぜられるのではなく後ろに追加されるため、通常の検索がすでに見つけているはずの結果を押しのけたり順序を変えたりすることは決してありません。祖先フォルダーはファイル名とまったく同じ方法で照合されるため、ピンインもここで中国語のフォルダー名に届きます。

1 回の検索だけ除外ルールを無視する

クエリの先頭に * を付けると、設定を変更することなく、その検索に限り自分の除外ルール (ExcludedPaths、無視されるグロブパターン、無視される正規表現) を無視して検索します:

*node_modules

* 自体はマッチングの前に取り除かれるため、検索テキストの一部として扱われることはありません。これはすでにインデックス化済みの検索結果を表示するだけです。そもそも一度もインデックス化されなかったフォルダー (ネットワークドライブや WSL ドライブ上の除外フォルダーなど) は、それでも表示されません。隠しファイル/システムファイルはいずれの場合もフィルタリングされたままです — これが影響するのは、あくまで自分自身の除外ルール設定だけです。何も続けずに * だけを入力した時点では、まだ検索が実際に実行されていないため、「検索結果がありません」ではなく「入力を続けて検索してください」というプロンプトが表示されます。

検索結果種別トリガー

任意機能で、既定ではオフになっています — 文字は自分で割り当てます。設定 → 一般 → クイック検索ウィンドウ → 検索結果種別の優先度 で、ある検索結果種別にトリガー文字を割り当てている場合、クイックウィンドウでその文字を一番最初に入力すると、その種別の検索結果のみ — アプリケーション、設定、特定の 1 つのファイルフィルター、あるプラグイン独自の項目、あるいは単純なファイル — が表示され、他のすべての種別は非表示になります:

;vs

は、; がその種別に設定されたトリガーであれば、他の種別のテキストがどれだけよく一致していたとしても、アプリケーションの中からのみ「Visual Studio」を見つけます。トリガー文字だけを入力してその後に何も続けていない時点では、「検索結果がありません」の代わりに、その種別名を示すプロンプトが表示されます。履歴とお気に入りは、トリガーの有無に関わらず影響を受けず、常に最初に表示されます。既定ではトリガーは設定されていません。設定方法は一般設定を参照してください。

中国語ファイル名: ピンインエイリアス

中国語の文字を含むファイル名は、特別な設定なしに、自動的にピンインで検索可能になります:

• フルピンイン: chongqing と入力すると 重庆 というファイルに一致します。
• 頭文字: cq と入力しても 重庆 に一致します (各音節の最初の文字)。
• 多音字 (複数の正しい発音を持つ文字) は、よく使われる読み方それぞれに対してエイリアスを生成するため、どの発音を思い浮かべても一致しやすくなっています。

これは同梱のエイリアスプラグインによって処理されています — 有効になっているか確認したい場合は 設定 → プラグイン を参照してください。

お気に入り、カスタムエイリアスではない

SwiftList には、汎用的な「自分でエイリアス/マクロを定義する」仕組みはありません。それに最も近いのが お気に入り です。フォルダー・ファイル・URL を独自の表示名でピン留めすると、その名前で検索できるようになります (検索結果には ★ マーク付きで表示されます)。プログラムを起動する独自のキーワードが欲しい場合は、代わりにカスタムコマンドを参照してください。