ITメモベース

Python・開発環境まわりの「つまずきポイント」を整理するITメモ


MacにPythonをインストールして実行するまでの手順(VS Code対応)


MacでPythonを使い始めたいと思っても、
「そもそもPythonが入っているのかわからない」
「VS Codeでどうやって実行するのか分からない」

といったところでつまずくことがあります。

この記事では、MacにPythonを用意し、VS Codeで実行できる状態にするまでの基本手順をまとめます。

この記事でわかること

  • MacにPythonがインストールされているか確認する方法
  • Pythonをインストールする手順(Mac)
  • Pythonのバージョン確認方法
  • VS CodeでPythonを実行する方法
  • 実行できないときの基本チェック項目

※ 本記事では Mac環境 を前提に説明します。

MacにPythonが入っているか確認する方法

まずは、現在のMacにPythonが入っているかを確認します。

  1. ターミナルを起動します
  2. 次のコマンドを入力します
python3 --version

結果の見方

  • Python 3.x.x のように表示される
    → Pythonはすでにインストールされています
  • command not found と表示される
    → Pythonが入っていない、または認識されていません

Macでは、python ではなく python3 コマンドを使うのが一般的です。

Pythonをインストールする方法(Mac)

Pythonが入っていない場合は、公式サイトからインストールします。

手順

  1. Python公式サイトにアクセス
  2. macOS向けのインストーラをダウンロード
  3. ダウンロードした .pkg ファイルを実行
  4. 画面の指示に従ってインストール

インストールが完了したら、再度ターミナルで次を実行します。

python3 --version

バージョンが表示されれば、インストールは完了です。

Pythonのバージョンを確認する

Pythonはバージョンによって挙動が異なることがあります。
作業前に、現在使っているバージョンを確認しておくと安心です。

python3 --version

また、pip(パッケージ管理ツール)も確認しておきます。

pip3 --version

この段階でエラーが出る場合は、Pythonのインストールが正しく完了していない可能性があります。

VS CodeでPythonを実行する方法

次に、VS CodeでPythonファイルを実行します。

VS Codeの準備

  1. VS Codeを起動
  2. 拡張機能から Python 拡張をインストール

実行手順

  1. 任意のフォルダを開く
  2. test.py などのPythonファイルを作成
  3. 以下のようなコードを書きます
print("Hello, Python")
  1. ファイルを保存
  2. ターミナルで次を実行
python3 test.py

ターミナルに Hello, Python と表示されれば成功です。

VS Code上で実行できないときの確認ポイント

うまく実行できない場合は、次の点を確認してください。

1. 実行しているPythonが正しいか

VS Codeでは、複数のPythonが存在すると
「別のPythonで実行している」ケースがあります。

  • ステータスバーに表示されているPythonバージョンを確認
  • 意図したPythonが選択されているか確認

2. コマンドが python3 になっているか

Macでは python ではなく python3 を使うケースが多いです。

python test.py   # エラーになることがある
python3 test.py  # 推奨

3. ファイルの保存場所を確認

  • 実行しているディレクトリと
  • test.py を保存している場所

が一致しているかを確認します。

まとめ

MacでPythonを使い始めるための基本手順は、次の流れです。

  1. Pythonが入っているか確認
  2. 入っていなければ公式サイトからインストール
  3. バージョンを確認
  4. VS CodeでPythonファイルを作成
  5. ターミナルから実行

この状態が整えば、

  • Pythonのエラー対処
  • パッケージのインストール
  • 仮想環境の利用

といった次のステップに進めます。

関連記事


コメントを残す

メールアドレスが公開されることはありません。 が付いている欄は必須項目です

PAGE TOP