ターミナルでPythonを実行したのに、コマンドが見つからない。授業で使う版も分からない。
最初に授業の指定を確認し、公式案内に沿ってPythonを導入してから、短いプログラムで動作を確かめましょう。最初から開発ツールを一式そろえる必要はありません。
この手順は、初めてMacでPython開発環境を整える学生や、設定が成功したか判断できない人向けです。
Macを持っていなくても、授業でmacOSが必要なら、後半の環境選びを参考にしてください。
最初に授業の指定を確認します
授業の資料や課題ページを先に見て、必要なPythonの版と、指定されたエディタがあるかを確認します。授業で版が決められていれば、最新のものを選ぶより、その指定を優先してください。教材と異なる版では、説明や実行結果が一致しないことがあります。
指定が見つからない場合は、Python公式のmacOSダウンロードページで、現在案内されている版と導入方法を確認します。版や手順は変わるため、古い記事だけを頼りにインストーラーを選ばないようにします。
選ぶ道具は、まず必要なものだけで十分です。
- ファイルを編集する場所：授業指定のエディタ。指定がなければ、最初は使い慣れたテキスト編集環境で構いません。
- プログラムを動かすもの：Pythonのインタープリター。
- コマンドを入力する場所：macOSのターミナル。
単独の練習問題を解く段階なら、追加パッケージやプロジェクト管理ツールは後回しにできます。
導入元とMacの準備を確認します
ダウンロード先は、Python公式のmacOS案内を起点にしてください。Python公式のmacOS使用説明には、Macでの導入や利用について説明があります。配布方法や実行ファイルの場所は導入方法によって異なるため、別のMacの設定をそのまま当てはめないことが大切です。
ターミナルは、コマンドを文字で入力するmacOS標準のアプリです。開き方や基本操作に迷ったら、ターミナルの公式ガイドを確認できます。初めて操作する場合は、授業ファイルを置くフォルダを決めておくと、作成したファイルを見失いにくくなります。
注意：インストール場所が分からなくても、システム管理下のファイルを削除したり、書き換えたりしないでください。配布元の案内に沿って導入し、既存のシステム設定を変更する前に授業の指示を確認してください。
ターミナルからPythonを確認します
ターミナルを開き、次のコマンドを入力します。
python3 --version
このコマンドは、ターミナルから呼び出せるPythonの版を表示する確認方法です。PythonのmacOS使用説明を参照し、表示された版が授業の指定と合っているか見比べてください。表示が出ることと、授業の条件を満たすことは別々に確認します。
結果によって、原因の見当をつけられます。
Python 3.x.xのような表示が出て、授業の指定とも合う：次の実行確認へ進みます。- 版は表示されるが、授業の指定と異なる：導入し直す前に、どの実行ファイルが呼び出されているかを確認します。
- コマンドが見つからないという表示が出る：Pythonが未導入とは限りません。ターミナルが実行ファイルを見つけられていない可能性があるため、導入元の案内やパス設定を確認します。
場所を調べるときは、次のコマンドを使えます。
command -v python3
出力があれば、ターミナルが見つけた実行ファイルの場所を表示しています。何も返らない場合は、別の名前のコマンドが使われているか、実行ファイルの場所が検索対象に含まれていない可能性があります。インストール直後なら、まずターミナルを開き直し、公式手順どおりに導入できているかを確認します。
ターミナルでコマンドを実行するときの基本操作は、コマンド実行の案内でも確認できます。表示されたエラーを省略せずに読むと、「コマンドが見つからない」のか、別の処理で失敗したのかを区別しやすくなります。
最初のファイルを作って実行します
設定を確かめるには、複雑な課題ではなく短いスクリプトを使います。授業用フォルダに hello.py というファイルを作り、次の内容を入力して保存してください。
print("Hello, Python!")
ターミナルでそのファイルを保存した場所へ移動し、次のように実行します。
python3 hello.py
Hello, Python!と表示されれば、ターミナルからPythonを呼び出し、ファイルを実行するところまで確認できています。フォルダの移動方法が分からない場合は、ターミナルに cd と入力し、続けてフォルダを入力欄へドラッグしてから実行する方法もあります。
失敗したときは、原因を分けて考えます。
- コマンドの直後に「見つからない」と表示される：Pythonの呼び出し方や導入を確認します。
- ファイルがないという表示が出る：ターミナルがいるフォルダと、ファイルの保存先を確認します。
- 文法に関するエラーが出る：ファイルの内容や保存状態を見直します。
- エディタ上だけに警告が出る：実行時のエラーとは限りません。ターミナルから実行した結果も確認します。
編集画面の警告、プログラムの書き間違い、インタープリターの呼び出し失敗は別の問題です。ひとまとめにして再インストールすると、原因が残ったままになることがあります。
学習段階に合う環境を選びます
最初の練習で必要な道具と、複数の課題や追加パッケージを使う段階で必要な道具は異なります。今の学習内容に合う選択肢を、下の比較で判断してください。
| 選択肢 | 合う段階 | よい点 | 気をつけること |
|---|---|---|---|
| Pythonとターミナル | 最初の文法練習、短い課題 | 構成が少なく、実行の流れを覚えやすい | ファイルの場所とコマンドを自分で確認します |
| エディタを追加 | 複数ファイルの課題、編集支援が必要なとき | コードやファイルを見渡しやすくなります | 授業指定がある場合は指定を優先します |
| 仮想環境と追加パッケージ | プロジェクトごとに使うライブラリが違うとき | 依存パッケージをプロジェクト単位で分けられます | 初回から必須ではなく、操作を一つずつ覚えます |
課題が短いスクリプトだけなら、まずはPythonとターミナルで十分です。課題が特定のエディタやパッケージを指定した時点で、その項目だけを追加すると、設定作業で学習時間を使い切りにくくなります。
プロジェクトごとに環境を分ける必要が出たら、Python標準の venv を検討します。公式の仮想環境の説明では、python3 -m venv .venv のように環境を作る方法が紹介されています。環境を有効にする操作はシェルによって異なるため、公式説明の手順を自分のターミナルに合わせて確認してください。
追加パッケージを使う場合も、まず授業資料に導入方法の指定がないか見ます。指定がなければ、Python公式のパッケージ導入ガイドを参照し、使っている環境に対応した方法を選びましょう。最初から複数の導入手段を混ぜると、どの環境にパッケージが入ったのか分かりにくくなります。
迷ったときは確認項目を上からたどります
- [ ] 授業や課題が指定するPythonの版を確認しました。
- [ ] ダウンロード元の案内で、Mac向けの導入手順を確認しました。
- [ ]
python3 --versionの結果と授業の指定を照らし合わせました。 - [ ]
hello.pyを保存し、ターミナルから実行しました。 - [ ] エラーが出たら、コマンド、保存場所、コード、エディタのどこで起きたかを分けました。
- [ ] 追加ツールは、課題で必要になったものから導入する方針にしました。
Pythonを学ぶだけなら、必ずしもMacが必要なわけではありません。一方、授業や課題でmacOSが必要なら、手元にMacを買う方法は購入費がかかり、使う期間が短くても保有し続けることになります。仮想環境は導入や動作確認を自分で行う必要があり、学校の端末はソフトウェアの権限に制限がある場合もあります。
まずは手元の環境で授業要件を満たせるか確認し、Macが必要な期間や作業内容を見積もってください。実機を持っていない場合は、vmzigのリモートMac利用案内を確認して、授業の環境に合うか比較する方法もあります。短期間のmacOS演習にはレンタルが選択肢になりますが、継続して長時間使う場合や物理的な機器接続が必要な場合は、自分のMacを用意するほうが適することもあります。
vmzig M4リモートノード
Python学習に使えるMac環境を、vmzigで
手元のMacの容量や設定に不安がある方は、vmzigのリモートMacで学習環境を整えられます。