Regex File Finder
VSCode でファイル名を正規表現パターンで検索できる拡張機能です。
機能
- 🔍 正規表現検索: コマンドパレットから正規表現パターンを入力してファイル名を検索
- 📋 フラットリスト表示: 検索結果をサイドバーのツリービューに見やすく表示
- 📂 ワンクリックでオープン: ファイルをクリックして該当ファイルを開く
- ⚙️ VSCode 設定を尊重:
files.exclude, search.excludeの設定を自動的に適用
- ✅ 入力検証: 正規表現の構文エラーをリアルタイムでチェック
- 📊 検索結果の件数表示: マッチしたファイル数を通知
インストール方法
VSIX ファイルからインストール（推奨）
- Releasesから最新の
.vsixファイルをダウンロード
- VSCode を開く
- 拡張機能ビュー（
Ctrl+Shift+X / Cmd+Shift+X）を開く
- 右上の
...メニューから「VSIX からのインストール...」を選択
- ダウンロードした
.vsixファイルを選択
またはコマンドラインから:
code --install-extension regex-file-finder-2.0.0.vsix
開発版をビルドしてインストール
- リポジトリをクローン
git clone https://github.com/ioEl0xFF/RegexFileFinder.git
cd RegexFileFinder
- 依存関係をインストール
npm install
- パッケージをビルド
npm run vsce:package
- 生成された
.vsixファイルをインストール
code --install-extension regex-file-finder-2.0.0.vsix
使い方
基本的な使い方
- コマンドパレットを開く（
Ctrl+Shift+P / Cmd+Shift+P）
- 「Regex File Finder: ファイル名を正規表現で検索」を選択
- 正規表現パターンを入力（例:
.*\.tsx$）
- Enter キーで検索実行
- エクスプローラーサイドバーの「正規表現検索結果」ビューに結果が表示される
- ファイル名をクリックすると該当ファイルが開く
検索結果の表示
検索結果はワークスペースルートからの相対パスでフラットリスト表示されます：
正規表現検索結果
├─ src/components/Button.tsx
├─ src/components/Header.tsx
├─ src/utils/helpers.tsx
└─ tests/Button.test.tsx
ファイルをクリックするとエディタで開きます。
正規表現パターンの例
| パターン |
説明 |
.*\.tsx$ |
TSX ファイルを検索 |
^test.*\.js$ |
test で始まる JS ファイル |
.*component.* |
"component"を含むファイル |
^[A-Z].*\.ts$ |
大文字で始まる TS ファイル |
.*\.(ts\|tsx\|js\|jsx)$ |
TypeScript/JavaScript ファイル |
^(?!.*test).*\.ts$ |
"test"を含まない TS ファイル（否定先読み） |
.*\.(json\|yaml\|yml)$ |
設定ファイル（JSON/YAML） |
よくある使用例
コンポーネントファイルのみ検索:
.*[Cc]omponent\.(tsx?|jsx?)$
テストファイルを除外して検索:
^(?!.*\.(test\|spec)\.).*\.ts$
特定のディレクトリ配下のファイル:
^src/utils/.*\.ts$
開発
必要な環境
- Node.js 18 以上
- VSCode 1.85.0 以上
開発コマンド
# 依存関係のインストール
npm install
# TypeScriptコンパイル（開発用）
npm run compile
# ファイル監視モード
npm run watch
# 本番用ビルド
npm run package
# .vsixパッケージ作成
npm run vsce:package
デバッグ
- VSCode で
F5キーを押す
- 新しい VSCode ウィンドウ（拡張機能開発ホスト）が起動
- コマンドパレットから拡張機能をテスト
- ブレークポイントでデバッグ可能
プロジェクト構造
RegexFileFinder/
├── src/
│ ├── extension.ts # エントリーポイント
│ ├── commands/
│ │ └── searchCommand.ts # 検索コマンド実装
│ ├── providers/
│ │ └── fileTreeProvider.ts # ツリービュープロバイダー
│ ├── services/
│ │ └── fileSearchService.ts # ファイル検索ロジック
│ └── types/
│ └── index.ts # 型定義
├── dist/ # ビルド出力（webpack）
├── package.json # 拡張機能マニフェスト
├── tsconfig.json # TypeScript設定
└── webpack.config.js # webpack設定
トラブルシューティング
検索結果が表示されない
- ワークスペースが正しく開かれているか確認してください
- VSCode の設定で除外されているファイルは検索対象外です（
files.exclude, search.exclude）
正規表現エラーが出る
- 入力した正規表現パターンが正しいか確認してください
- 特殊文字（
., *, +, ?, [, ], (, ), {, }, |, \）はエスケープが必要な場合があります
貢献
バグ報告や機能リクエストはIssuesからお願いします。
プルリクエストも歓迎します！
ライセンス
MIT License
Copyright (c) 2025 ioel0xff
詳細はLICENSEファイルをご覧ください。
リンク
