xFormers はインストール済みなのに利用できない：ネイティブ拡張と演算子を確認する

症状と対象範囲

pip では xFormers がインストール済みと表示されても、C++/CUDA 拡張の読み込みに失敗したり、入力に対応するアテンション演算子がなかったりすることがあります。パッケージの存在と、使用可能な GPU カーネルは別々に確認します。

検索の手掛かりとなるエラーの断片です。ID、値、ファイル名は環境によって変わります。

xFormers can't load C++/CUDA extensions
No operator found

出典から確認できること

xFormers には情報表示コマンドと、プラットフォームや Torch のインストール要件があります。ComfyUI のトラブルシューティングでは、本体の実行とサードパーティー拡張機能を分けて扱っています。出典 1（英語） 出典 2（英語） 出典 3（英語） ComfyUI の起動オプション（英語）

区別すべき状況

1. ComfyUI の実行環境ではなく、システムの Python にインストールしている。

2. バイナリーが別の Python／Torch／CUDA の組み合わせを対象としている。または、デバイス、データ型、入力レイアウトに対応する演算子がない。

3. ComfyUI 本体は別のアテンション実装を使えるのに、ノードが xFormers を必要としている。

確認手順

以下は引用した資料に基づく編集上の手順です。あなたの環境で原因が確定したことを意味しません。

手順 1. 実際に使われている Python で情報表示の確認を実行し、pip の成功表示だけでなく、演算子の利用可否と読み込みエラーを保存します。

手順 2. xFormers の現在のインストール手順を Torch、計算バックエンド、ハードウェアと照合します。拡張機能のインストールで、動作中の Torch の依存関係が置き換わらないか確認します。

手順 3. 環境のコピーで、この ComfyUI の版の --help を使い、対応している xFormers を使わないアテンション処理経路を選んでから、同じネイティブワークフローを比較します。デフォルトの経路で xFormers が使われない、または一つのフラグがすべての版で使えるとは限りません。

手順 4. 対応状況と前提条件を確認できた場合に限り、ソースからビルドします。それ以外の場合は、互換性のある組み合わせか、拡張機能を必要としないワークフローを使います。

コマンドとリクエスト例

上記で確認した環境とシェルを使います。パスと変数は調整が必要な例です。これらのコマンドやスニペットは、お使いの環境では実行していません。Portable の例はパッケージのルートから実行します。仮想環境や管理されたランチャーでは、実行ファイルの配置が異なる場合があります。

.\python_embeded\python.exe -m xformers.info

完了の確認

該当する演算子が一覧にあり、ログで期待するバックエンドが選ばれた状態で、小規模な実際のリクエストが完了することを確認します。

制限と注意点

検証されていない修復用 wheel は、ローカルコードを実行するため避けてください。アテンション処理を変更すると、数値結果やパフォーマンスが変わる場合があります。

参照した原文資料

• xFormers README（英語）（原文資料の確認日：2026-09-21）
• PyTorch のローカル環境へのインストール（英語）（原文資料の確認日：2026-09-21）
• ComfyUI カスタムノードのトラブルシューティング（英語）（原文資料の確認日：2026-09-21）
• ComfyUI の起動オプションのソース（英語）（確認日：2026-09-25）

翻訳準備日：2026-09-22。上記の資料確認日は既存の記事から引き継いだもので、この翻訳ですべてを本日再確認したとは主張しません。GPU での実行、最小メモリの測定、実行時の保証は提供していません。

関連するトラブルシューティング記事とガイド

• SageAttention または Triton のインポート失敗：プラットフォームとビルドの組み合わせを確認する
• No kernel image is available：各バイナリーの GPU アーキテクチャ対応を確認する