「CX_Freeze Python Error in Main Script」エラーの原因と解決方法を徹底解説

一部のWindowsユーザーから、システム起動のたびに「CX_Freeze Python Error in Main Script」という起動時エラーが表示されるとの報告が寄せられています。多くの場合、この問題はサードパーティ製アプリケーションをアンインストールした後に発生することが確認されています。また、この問題はOS固有のものではなく、Windows 7、Windows 8.1、Windows 10のいずれでも発生し得ます。

報告されているケースの大多数において、この問題の原因は品質の低いPythonアプリケーション（多くの場合RaptrまたはPlayTV）であると判明しています。該当する場合は、問題のあるアプリケーションをアンインストールすることで解決できます。従来どおり「プログラムと機能」から削除してもよいですし、強力なサードパーティ製アンインストーラーを利用しても構いません。

一方、Steamから起動したゲームでこのエラーが発生している場合は、AppDataフォルダー内の一時ファイルが引き起こす不具合の可能性があります。その場合は、AppDataフォルダーの内容を消去してゲームを再インストールすることで問題が解決するはずです。

ローカルでビルドしたPythonプロジェクトの実行時にエラーが表示される場合は、cx_freezeのインストールにパッチの欠落がある可能性が高いです。この場合、コマンドプロンプト（CMD）ウィンドウからcx_freezeパッケージ全体をアンインストールし、最新バージョンを再インストールすれば解決できます。

上記のいずれの方法でも解決しない場合、Windowsコンポーネントをすべてリセットせずに済む最後の手段として、システムファイルの破損を修復できるユーティリティ（DISMとSFC）を実行しましょう。

RaptrまたはPlayTVをアンインストールする

調査の結果、「CX_Freeze Python Error in Main Script」という起動時エラーを引き起こす最も一般的な要因は、Pythonで一貫性なく記述されたソフトウェアであることがわかっています。影響を受けたユーザーの多くは、原因がRaptrまたはPlayTVであったことを確認しています。

このシナリオに該当する場合、起動時エラーの原因と思われるプログラムを強制的にアンインストールすることで問題を解決できます。

アンインストールの方法としては、従来型の「プログラムと機能」画面を使う方法と、強力なサードパーティ製アンインストーラーを使う方法の2つがあります。まずは従来の方法を試し、うまくいかない場合のみ次の手順に進んでください。

「プログラムと機能」からアンインストールする

1. Windowsキー + Rを押して「ファイル名を指定して実行」ダイアログボックスを開きます。テキストボックスに「appwiz.cpl」と入力し、Enterキーを押して「プログラムと機能」メニューを開きます。
2. 「プログラムと機能」メニュー内で、インストール済みアプリケーションのリストを下にスクロールし、PlayTV、Raptr、または「CX_Freeze Python Error in Main Script」エラーの原因となっていると思われるプログラムを見つけます。
3. 問題のあるアプリケーションを見つけたら、右クリックして表示されたコンテキストメニューから「アンインストール」を選択します。
4. アンインストール画面の指示に従って操作を完了させ、その後パソコンを再起動して、次回のシステム起動時に問題が解決したかどうかを確認します。

同じ問題が依然として発生する場合は、下記のサードパーティ製アンインストーラーを使った方法に進みましょう。

アンインストーラーソフトを使用する

1. お使いのブラウザーを開き、Revo Uninstallerの最新無料版をダウンロードしてインストールします。ダウンロードページにアクセスしたら、「Download」ボタンをクリックして処理を開始してください。

   注意：ポータブル版のRevoはインストーラー版ほど効果的ではないため、避けてください。

2. インストール用実行ファイルのダウンロードが完了したら、ダブルクリックして画面の指示に従いインストールを完了させます。

   注意：UAC（ユーザーアカウント制御）ウィンドウが表示された場合は、「はい」をクリックして管理者権限を付与してください。

3. Revo Uninstallerアプリを開いたら、上部の縦型メニューから「Uninstaller」タブを選択し、インストール済みアプリケーションのリストを下にスクロールして、PlayTVまたはRaptrに関連するエントリーを探します。
4. PlayTVまたはRaptrのエントリーを右クリックし、表示されたコンテキストメニューから「アンインストール」を選択します。

   注意：両方のアプリケーションがインストールされている場合は、この手順以降を両方に対して実行してください。

5. 次のウィンドウで復元ポイントの作成が完了するまで待ち、スキャンモードから「Advanced」を選択して「Scan」をクリックし、残存ファイルを検出・削除します。
6. 画面の指示に従ってアンインストールを完了させます。自動的に再起動が促されない場合は、手動でパソコンを再起動してください。
7. 次回の起動シーケンスで起動時エラーに注意を払い、「CX_Freeze Python Error in Main Script」エラーが解決されたかどうかを確認します。

同じ問題が依然として発生する場合は、次の対処法に進んでください。

cx_Freezeスクリプトを再インストールする（該当する場合）

cx_freezeを使ってビルドしたPythonプロジェクトの実行可能ファイルを実行しようとした際に「CX_Freeze Python Error in Main Script」という起動時エラーが発生する場合、使用中のcx_freezeインストール環境にパッチの欠落があることが原因として考えられます。

このシナリオに該当する場合は、CMDウィンドウからcx_freezeパッケージ全体をアンインストールし、公式チャネル経由で最新バージョンを再インストールすることで問題を解決できます。

以下に、プロセス全体を順を追って説明するガイドを示します。

1. Windowsキー + Rを押して「ファイル名を指定して実行」ダイアログボックスを開きます。テキストボックスに「cmd」と入力し、Enterキーを押してコマンドプロンプトターミナルを開きます。
2. コマンドプロンプトターミナル内で以下のコマンドを入力し、Enterキーを押してcx_freezeパッケージ全体をアンインストールします：

   pip uninstall cx_freeze

3. パッケージのアンインストール準備が整うと、選択の確認を求められます。Yキーを押してから再度Enterキーを押すことで、cx_freezeパッケージのアンインストールが完了します。
4. 次に、デフォルトのブラウザーを開き、非公式のPython拡張パッケージ用Windowsバイナリ（Unofficial Windows Binaries for Python Extension Packages）の配布ページにアクセスします。
5. バイナリのリストを下にスクロールしてcx_Freezeを見つけ、使用中のPythonバージョンに対応するバージョンを探します。見つかったら互換性のあるバージョンをクリックし、ダウンロードが完了するまで待ちます。
6. ダウンロードが完了したら、ダウンロード先の場所に移動し、実行ファイルを右クリックして、表示されたコンテキストメニューから「管理者として実行」を選択します。
7. インストール画面で自分のPythonバージョンを選択し、画面の指示に従ってインストールを完了させます。
8. インストールが完了し、新しいバージョンのcx_freezeが導入されたら、Pythonプロジェクトを再度ビルドして、問題が解決したかどうかを確認します。

同じ問題が依然として発生する場合や、この方法が該当しない場合は、次の対処法に進んでください。

ゲームのAppDataフォルダーを削除する

Pythonで構築されたゲームを起動しようとした際に「CX_Freeze Python Error in Main Script」エラーが表示される場合は、AppDataフォルダー内に何らかの破損した一時データが存在している可能性があります。

同じ問題に直面していた複数のユーザーが、ゲームのAppDataフォルダーにアクセスして一時ファイルを消去し、その後ゲームを再インストールすることで、ようやくエラーを解消して正常にプレイできるようになったことを確認しています。

このシナリオに該当する場合は、以下の手順に従ってゲーム起動時の「CX_Freeze Python Error in Main Script」エラーを修正してください。

1. Windowsキー + Rを押して「ファイル名を指定して実行」ダイアログボックスを開きます。次に「%appdata%」と入力してEnterキーを押すと、（デフォルトでは非表示になっている）AppDataフォルダーが開きます。
2. AppDataフォルダーに入ったら、戻る矢印をクリックしてひとつ上の階層に移動し、Localフォルダーをクリックします。
   

   注意：デフォルトでは、%appdata%コマンドを実行するとAppData内のRoamingフォルダーが自動的に開かれます。

3. Localフォルダー内で、「CX_Freeze Python Error in Main Script」エラーが発生しているゲームに関する情報を保持するエントリーを探します。見つけたらそれを開き、内部のすべてを選択して右クリックし、コンテキストメニューから「削除」を選択します。
4. Windowsキー + Rを押して、再び「ファイル名を指定して実行」ダイアログボックスを開きます。次に「appwiz.cpl」と入力してEnterキーを押し、「プログラムと機能」画面を開きます。
5. 「プログラムと機能」メニュー内で、インストール済みプログラムのリストを下にスクロールし、問題が発生しているゲームに関連するエントリーを右クリックして、コンテキストメニューから「アンインストール」を選択します。
6. アンインストールが完了したら、パソコンを再起動し、通常の方法でゲームを再インストールして、問題が解決したかどうかを確認します。

「CX_Freeze Python Error in Main Script」エラーが依然として表示される場合や、この対処法が該当しない場合は、次の解決策に進んでください。

DISMおよびSFCスキャンを実行する

上記のいずれの修正方法でも問題を解決できなかった場合、パソコンには従来の方法では解決できない何らかのシステムファイル破損が発生している可能性があります。おそらく「CX_Freeze Python Error in Main Script」という起動時エラーは、正しくアンインストールされなかったプログラム（ユーザーが正規の手順に従った場合であっても）が原因で発生しています。

このシナリオに該当する場合は、組み込みユーティリティ（DISMとSFC）を使用して、この問題を引き起こしている破損したシステムファイルを特定・修復することで、問題を解決できるはずです。

SFC（システムファイルチェッカー）は完全にローカルで動作するツールで、ローカルに保存されたキャッシュを使用して、破損したファイルを正常なコピーに置き換えます。一方、DISM（展開イメージのサービスと管理）ツールは、Windows Updateのサブコンポーネントに依存して破損したファイルを置き換えるための正常なファイルを取得するため、安定したインターネット接続が必要です。

これら2つのツールは互いに補完し合う関係にあるため、両方のスキャンを続けて実行することで、「CX_Freeze Python Error in Main Script」問題の原因となっているシステムファイルの破損を解決できる可能性が最大化されます。

SFCスキャンを実行するには、こちらの手順に従ってください。操作が完了したらパソコンを再起動し、次回の起動シーケンスが完了したらDISMスキャンに進みます。

両方のスキャンを実行した後、最後にもう一度マシンを再起動し、起動時エラーが表示されなくなったかどうかを確認してください。