ComfyUI の更新前にバックアップする：ソースのロールバックだけでは環境は元に戻らない

目的と対象範囲

古いコードに戻しても、Python パッケージ、フロントエンド、ノード、設定が自動的に復元されるわけではありません。関連する環境全体の復旧情報を用意します。

出典から確認できること

公式の更新ガイドでは、インストール方法と関連する要件を分けて説明しています。pip check で競合が見つかることはありますが、以前の成果物を復元したり、バイナリーの互換性を保証したりはできません。出典 1（英語） 出典 2（英語） 出典 3（英語）

始める前に

1. 保持が必要なユーザーワークフロー、設定、追加のモデルパス、出力をバックアップします。

2. ComfyUI 本体、フロントエンド、テンプレート、カスタムノード、Python／Torch、インストール方法を記録します。

3. 大容量の重みを不必要にコピーしないよう、再ダウンロードできるモデルと、固有のユーザーデータを区別します。

手順と確認

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

手順 1. 更新前に既知の小規模なワークフローを実行し、入力、結果、環境を基準として保存します。

手順 2. コピーまたは新しい環境での更新を優先し、リリースノートを読みます。多数の拡張機能を同時に追加しないでください。

手順 3. 起動、登録、モデルの読み込み、基準ワークフローの順で確認します。失敗した場合は、エラーが変わるまで更新し続けず、実際に加えた変更を比較します。

手順 4. コード、パッケージ、フロントエンド、ノードを一貫した状態に復元し、復元後のプロセスのパスを元の基準と照合します。

コマンドとリクエスト例

上記で確認した環境とシェルを使います。パスと変数は調整が必要な例です。これらのコマンドやスニペットは、お使いの環境では実行していません。freeze コマンドはローカルのスナップショットを書き込みます。共有する前に、プライベートリポジトリの URL が含まれていないか確認します。

python -m pip freeze > environment-before-update.txt
python -m pip check

完了の確認

変更内容、基準となる実行結果、復旧手順が明確になっていることを確認します。ページが再び表示されただけでは、ワークフローの互換性が保たれている証拠にはなりません。

制限と注意点

確認せずに破壊的な Git のリセットを実行したり、環境を削除したり、ユーザーディレクトリを上書きしたりしないでください。pip freeze はバージョンを記録しますが、同じ成果物を将来入手できる保証はありません。共有前に、スナップショットにプライベート URL やパスが含まれていないか確認します。

参照した原文資料

• ComfyUI の更新方法（英語）（原文資料の確認日：2026-09-21）
• ComfyUI カスタムノードのトラブルシューティング（英語）（原文資料の確認日：2026-09-21）
• pip check（英語）（原文資料の確認日：2026-09-21）

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

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

• ComfyUI 本体を更新してもノードやテンプレートが見つからない：各コンポーネントのバージョンを個別に確認する
• 更新後に名前をインポートできない：読み込み元のコードと依存関係を一緒に確認する
• NumPy の ABI エラー：_ARRAY_API と dtype size changed