【pycharm】connecting to console が終わらない

▶

編集

この記事の要点

症状: PyCharm の Python コンソールを開くと「Connecting to console...」のまま進まない
Anaconda 環境で多い原因は、Python が必要な DLL を見つけられず起動に失敗していること
対処 1: インタプリタを「Conda 環境」として登録し直し、PyCharm に conda 環境を有効化させる
対処 2: 環境変数 PATH に Anaconda3、Anaconda3\Scripts、Anaconda3\Library\bin を追加して PyCharm を再起動
その他: IPython の無効化、ファイアウォール・プロキシ設定、キャッシュの削除も確認する

エラー内容

PyCharm のバックグラウンドプロセスである「Connecting to console」が終わらず、Python Console に入力できない状態になります。エラーメッセージが出ないまま待ち続けることも多く、原因が分かりにくい症状です。

仕組み：コンソールは別プロセスとの通信で動いている

PyCharm の Python Console は、設定されたインタプリタで Python のプロセスを起動し、そのプロセスと PyCharm 本体がローカルの通信（localhost のソケット）でやり取りする仕組みです。そのため、次のどちらかで失敗すると「接続中」のまま止まります。

Python のプロセスが正常に起動しない（DLL が見つからない、インタプリタのパスが壊れている、IPython の不具合など）
起動したプロセスと PyCharm が通信できない（ファイアウォール、セキュリティソフト、プロキシ設定など）

原因 1：Anaconda のパスが通っていない（最も多い）

Anaconda の Python は、Library\bin フォルダにある DLL（SSL や数値計算ライブラリなど）を使います。conda 環境を「有効化（activate）」せずに python.exe だけを直接起動すると、これらの DLL が見つからず、コンソールの起動途中で失敗することがあります。

対処法 A：インタプリタを Conda 環境として登録する（おすすめ）

「File」→「Settings」（macOS は「PyCharm」→「Settings」）→「Project: プロジェクト名」→「Python Interpreter」を開く
「Add Interpreter」→「Add Local Interpreter」を選ぶ
種類で Conda（Conda Environment）を選び、conda の実行ファイルと使用する環境を指定する
OK で保存し、Python Console を開き直す

「Virtualenv」や「System Interpreter」として Anaconda の python.exe を登録していると、conda 環境が有効化されません。Conda として登録すると、PyCharm が環境を有効化した状態でプロセスを起動するため、PATH を変更しなくても DLL が見つかるようになります。画面の項目名は PyCharm のバージョンによって多少異なります。

対処法 B：環境変数 PATH に追加する

Anaconda3 を導入している場合は、以下のパスが環境変数「Path」に追加されているか確認してください。

C:\Users\tarou\Anaconda3
C:\Users\tarou\Anaconda3\Scripts
C:\Users\tarou\Anaconda3\Library\bin

※ C:\Users\tarou\ の部分はインストール先に応じて変更してください。最近のインストーラーでは、既定の場所が C:\Users\ユーザー名\anaconda3（小文字）や C:\ProgramData\anaconda3 になっていることがあります。

Windows の検索で「環境変数」と入力し、「環境変数を編集」を開く
ユーザー環境変数の「Path」を選んで「編集」
「新規」で上の 3 つのパスを追加して OK
PyCharm を完全に終了してから再起動する（起動中のアプリには新しい PATH が反映されない）

Anaconda は、他の Python と衝突する可能性があるため PATH への追加を既定では推奨していません。複数の Python を使い分けている場合は、対処法 A を優先してください。

原因 2：IPython との相性

環境に IPython が入っていると、PyCharm はコンソールで IPython を使おうとします。PyCharm と IPython のバージョンの組み合わせによっては、これが原因で起動しないことがあります。

「Settings」→「Build, Execution, Deployment」→「Console」の「Use IPython if available」のチェックを外して試す
改善する場合は、PyCharm を最新版に更新するか、IPython のバージョンを変えて相性を確認する

原因 3：通信がブロックされている

ファイアウォール・セキュリティソフト: PyCharm や python.exe のローカル通信がブロックされていないか確認し、必要に応じて許可する
プロキシの環境変数: HTTP_PROXY などが設定されている環境では、localhost への通信までプロキシに向かってしまうことがある。NO_PROXY に localhost,127.0.0.1 を追加する
VPN: 社内 VPN 接続中だけ発生する場合は、VPN ソフトのネットワーク設定が影響している可能性がある

原因 4：インタプリタや PyCharm の設定の破損

インタプリタの一覧に「invalid」と表示されていないか確認する。環境を削除・移動した場合は登録し直す
「File」→「Invalidate Caches...」でキャッシュを削除して再起動する
WSL やリモートのインタプリタを使っている場合は、そちらの Python が単体で起動するかを先に確認する

確認方法

原因を切り分けるには、PyCharm の外で同じインタプリタが正常に動くかを試すのが近道です。PyCharm に設定している python.exe のパスを使って、コマンドプロンプトで次を実行します。

C:\Users\tarou\Anaconda3\python.exe -c "import ssl, sqlite3; print('ok')"

エラー（DLL load failed など）が出る場合は原因 1。conda 環境の有効化か PATH の設定が必要
ok と表示されるのにコンソールが接続しない場合は、原因 2〜4 を確認する

詳しいエラー内容は、「Help」→「Show Log in Explorer」（macOS は「Show Log in Finder」）で開くログファイル idea.log にも記録されています。「console」「pydev」などで検索すると、起動に失敗した理由が見つかることがあります。

ページ一覧

その他