CI/CD 2026年11月2日約18 分 Positron Python環境

Positron 2026.10.2-3でPythonインタープリターが見つからないときは？2026

PositronでPython環境が一覧に出ない、選択後にセッションが起動しないといった問題を、発見・選択・起動の段階に分けて調べます。uv、venv、condaの実行ファイルとプロジェクト設定を確認し、遠隔Macの利用時にはRemote SSHとの違いも整理します。

Pythonプロジェクトを開いたのに、Positronのインタープリター一覧に環境が出てきません。
最短の対処は、開いているプロジェクトの場所とPython実行ファイルの実在を先に照合し、発見設定、選択パス、セッション起動の順に調べることです。Positron 2026.10.2-3が原因と決めつけて、いきなり再インストールしたり環境を作り直したりする必要はありません。

この記事は、MacでPythonプロジェクトを扱う研究生・研究者のほか、研究室の環境を管理する技術担当者向けです。
uv、venv、conda環境が見えない、選んだ後にセッションが始まらない、遠隔Macで接続方式に迷う場合に、確認できる証拠から切り分けます。

最終更新：2026年11月2日。バージョンと機能の確認にはPositron公式リリースノート、Python環境の発見に関する公式説明、Remote SSHの公式要件を参照しています。公開前にも最新の記載をご確認ください。

まず「発見」「選択」「起動」を分けます

Positron 2026.10.2-3でPythonインタープリターが見つからないように見えても、一覧に出ない問題、別の環境が選ばれる問題、選択後にセッションが失敗する問題では、調べる対象が異なります。公式リリースノートには、このバージョンが掲載されていますが、特定バージョンに共通する不具合と決めつけず、まず手元の状態を記録します。

表示・症状	まず確認する証拠	低リスクの確認	優先度
環境一覧が空	Positronで開いたフォルダー、環境の実在場所、発見設定	プロジェクトの場所を確認して環境を再検索	高
一覧に出るが選ぶと違う環境になる	選択器とプロジェクト設定に表示される実行ファイルのパス	対象環境のPythonを直接指定して選び直す	高
選択できるがセッションが始まらない	セッション起動メッセージ、出力ログ、同じPythonでの端末実行	最小コマンドと空のプロジェクトで比較	中

一覧が空なら、Pythonパッケージの読み込みエラーを調べても原因には届きません。反対に、セッションは起動するのに特定のライブラリだけ読み込めない場合は、インタープリターの発見より依存関係を優先して調べます。

Positron Python環境の発見範囲を確認します

すでに作成した環境が見つからない場合は、Positronが意図したプロジェクトを開いているか、環境がどこにあるかを照合します。Python環境の検出対象や除外・上書き設定の名称と動作は、環境発見に関する公式ドキュメントで確認できます。

Positronで開いているプロジェクトのフォルダーを確認します。ファイルを単独で開いた状態や、プロジェクトの親・子フォルダーを誤って開いた状態では、相対パスや環境の探索範囲が想定と異なることがあります。
ターミナルで環境を有効化し、which pythonを実行して実際のPython実行ファイルを確認します。環境が有効でない場合は、環境の作成方法に応じた有効化を先に行います。
プロジェクト内の.venv/bin/pythonなど、実行ファイルが現在も存在するか確認します。これは配置例であり、環境の場所は作成方法や設定によって変わります。
Python環境の発見設定を確認します。include、exclude、overrideに相当する設定や、カスタム環境だけを表示する設定が、対象の場所を隠していないかを調べます。
コマンドパレットから環境の再検出を実行し、一覧がどう変わったかを記録します。公式の環境管理説明に沿って再検出した後も表示されない場合は、再検出前後の設定とパスを比較します。

注意：研究室で共有している環境を動かす前に、除外規則やプロジェクト設定を記録してください。設定を広く初期化すると、別プロジェクトの環境選択まで変わる可能性があります。

Positronの設定項目は、インタープリター管理の公式説明でも確認できます。defaultInterpreterPathは初期選択に関係する設定ですが、現在選択中の実行ファイルを常に強制する指定として扱わないでください。変更後は選択器に表示された完全なパスを見て、実際に使用する環境を確かめます。

環境があるのに別のPythonが選ばれる場合

uv、venv、condaのいずれでも、環境名だけでは選択先を判断できません。プロジェクト設定、ユーザー設定、インタープリター選択器の表示を照合し、実際に使うPython実行ファイルのパスが一致するかを確認します。

「Positronでuvやvenv環境が再起動後に見えなくなる」場合も、環境が消えたと断定する前に実行ファイルの所在を調べます。プロジェクトを移動した、仮想環境を作り直した、環境の保存先がプロジェクト外にあるなどの事情で、以前のパスが無効になっていることがあります。

環境が存在している場合は、ターミナルから取得したパスを使って選択し直します。選択後にPositronの選択器を再確認し、システムPythonや別の研究プロジェクトの環境に戻っていないことを確かめてください。

選択後にセッションが起動しないときの切り分け

Pythonを選べてもセッションが始まらない場合は、実行ファイルを起動できないのか、セッションに必要な要素の問題か、プロジェクト依存関係のエラーかを分けます。公式のトラブルシューティングとインタープリター起動の説明に沿って、起動メッセージや出力を確認します。

Positronのセッション開始時に表示されるメッセージと出力を保存します。機微情報が含まれる場合は、共有前にパスやデータ名を確認してください。
選択したものと同じPython実行ファイルをターミナルから呼び出し、python -c "print('ok')"のような最小コマンドを実行します。ここで失敗するなら、Positron固有の問題と結論づける前に実行ファイルや環境を調べます。
空のプロジェクトで同じ環境を選び、セッションを開始します。空のプロジェクトでは動き、対象プロジェクトでは失敗するなら、プロジェクト設定や起動時に読み込まれる依存関係が手掛かりです。
エラーが特定パッケージのimportに限られる場合は、その依存関係を環境内で確認します。import失敗の修正とPositronの再インストールは別の作業です。
元のプロジェクトに戻し、対象の研究作業に必要な読み込みや処理を再確認します。セッションが一度起動しただけでは、研究手順や結果の再現性が確かめられたことにはなりません。

「Pythonを選んだ後にセッションが始まらない」場合、再インストールを最初の手段にするのではなく、同じ実行ファイルを端末でも起動できるかを比較します。そこで得たエラーとPositronの起動メッセージが、次の確認箇所を絞る材料になります。

遠隔Macでは接続方式を混同しないようにします

遠隔Macのグラフィカルデスクトップに接続し、そのMac上でPositronを起動する方法と、手元のPositronからRemote SSHで別ホストへ接続する方法は異なります。Remote SSHの公式説明では、リモートホストの要件はLinuxとされています。したがって、ネイティブのmacOSホストへRemote SSHで接続する方法として案内するのは適切ではありません。

補足：Macの画面を遠隔操作して、その画面上のPositronを使う構成は、PositronのRemote SSH機能を使う構成と同じではありません。目的のソフトウェアがmacOSを必要とするのか、Linux上の計算環境で足りるのかを先に整理します。

判断は次の条件で分けられます。

研究ソフトウェアや検証対象がmacOSを必要とし、遠隔Macの画面上でPositronを使えるなら、グラフィカルデスクトップでの作業を候補にします。
リモート側がLinuxで、Remote SSHを使う要件を満たすなら、Remote SSHの公式要件を確認したうえで接続方式を選びます。
macOSが不要で、問題がPython環境のパスや依存関係に限られるなら、まず現在の端末やLinux環境で切り分けます。Macを用意しても、無効なパスや不足パッケージが自動で直るわけではありません。

プロジェクトの再確認で環境の去就を決めます

環境を修正した後は、機微データを含まないプロジェクトの複製を使い、実行ファイルのパス、主要依存関係の読み込み、代表的な研究操作を順に確かめます。実行した環境の場所、必要なパッケージ、確認した操作、失敗時のメッセージを記録すれば、研究室内で原因を再検討しやすくなります。

再確認の結果、環境作成やプロジェクトのパスだけが問題なら、まず既存環境を修正します。macOS専用ソフトウェアの確認やMac上での互換性検証が必要で、研究室に利用できるMacがない場合は、VNCMacのMac利用方法を確認し、実際のプロジェクト複製で必要な操作ができるかを試す選択肢があります。

現在のLinux・Windows環境を使い続ける方法は、追加費用や環境移行を避けられる一方、macOS固有の挙動を確認できず、別途Macの手配が必要になることがあります。Macを購入すれば手元で継続利用できますが、初期費用と保守が伴います。短期間だけmacOS上の科研ソフトウェアやプロジェクトを検証する場合は、遠隔Macを借りて適合性を確かめる方法もあります。ただし、長期の高頻度利用、物理機器の接続、機密データの扱いが中心なら、所属機関の規則と運用条件を先に確認してください。必要な作業がmacOSに限られると確かめてから、VNCMacの利用案内を参照し、試験用の複製で実行環境と研究手順の両方を検証するのが安全です。