Python 逆引き集 | Python基礎・実行環境：.pyファイルを実行する

Python Python
スポンサーリンク
スポンサーリンク

Python基礎・実行環境のイメージをそろえる

Pythonを学び始めたときに必ず通るのが、「.pyファイルをどうやって実行するのか」というテーマです。 ここをきちんと理解しておくと、チュートリアルや書籍のサンプルコードを自分の環境で再現できるようになり、学習のストレスが一気に減ります。

Pythonの世界では、ざっくり次の3つが協力し合って動いています。

  • Pythonインタープリタ: .pyファイルを読み、1行ずつ解釈して実行する「エンジン」です。
  • テキストエディタ／IDE: コードを書くための「作業机」です（VS Code、PyCharmなど）。
  • ターミナル／コマンドプロンプト: インタープリタに「このファイルを実行して」と命令を出す場所です。

この3つの役割を頭の中で整理しながら、「.pyファイルを実行する」流れを見ていきます。

.pyファイルとは何か

まず、「.pyファイルってそもそも何者？」というところから押さえておきます。

.pyファイルは、Pythonのソースコードが書かれたただのテキストファイルです。 メモ帳やVS Codeで開くと、普通の文字列としてコードが並んでいるだけで、特別なバイナリ形式ではありません。

  • 拡張子が.pyであること
  • 中身がPythonの文法に従って書かれていること

この2つさえ満たしていれば、それは「Pythonスクリプト」として実行できます。

Pythonインタープリタは、.pyファイルを上から下へ順番に読みながら実行します。 途中でエラーが出ればそこで止まり、最後まで到達すればプログラムは終了します。

最小の .py ファイルを作ってみる

まずは、いちばんシンプルな.pyファイルを作ってみましょう。

# hello.py
print("Hello, Python file!")
print("このファイルは上から順番に実行されます。")
Python

作成手順（共通イメージ）

  1. 好きなフォルダ（例: デスクトップ上のpython_practice）を作る。
  2. その中にhello.pyという名前のファイルを作る。
  3. 上のコードを貼り付けて保存する。

ここまでできたら、「Pythonにこのファイルを読ませて実行してもらう」段階に進みます。

ターミナルから .py ファイルを実行する基本3ステップ

.pyファイルを実行する標準的な流れは、どのOSでもほぼ共通です。

ステップ1：ターミナル／コマンドプロンプトを開く

  • Windows: 「コマンドプロンプト」または「PowerShell」を検索して起動します。
  • macOS: 「アプリケーション」→「ユーティリティ」→「ターミナル」を開きます。
  • Linux: 多くの環境ではCtrl + Alt + Tでターミナルが開きます。

ここが「Pythonに命令を出す場所」になります。

ステップ2：ファイルがあるフォルダに移動する

ターミナルは起動した直後、「ホームディレクトリ」などの初期位置にいます。 .pyファイルを実行するには、そのファイルがあるフォルダに移動する必要があります。

# 例: デスクトップ上の python_practice フォルダに移動
cd Desktop/python_practice

移動できたかどうかは、次のコマンドで確認できます。

# macOS / Linux
ls

# Windows
dir

ここに hello.py が表示されていれば、準備OKです。

ステップ3：Pythonインタープリタに「このファイルを実行して」と命令する

いよいよ実行です。OSごとにコマンドが少し違います。

Windows

python hello.py

または、Pythonランチャーを使う場合は次のように書きます。

py hello.py
# Python 3を明示したい場合
py -3 hello.py

macOS / Linux

python3 hello.py

多くの環境では、pythonコマンドが古いPython 2を指していることがあるため、必ずpython3を使う癖をつけると安全です。

コマンドを実行すると、ターミナルに次のような出力が表示されます。

Hello, Python file!
このファイルは上から順番に実行されます。

これで、「.pyファイルを実行できた」という最初のゴールに到達です。

よくあるエラーとその直し方（初心者がつまずきやすいポイント）

.pyファイルを実行するとき、初心者の方がよく遭遇するエラーをいくつか挙げておきます。

1. 「python が認識されません」系

メッセージ例（Windows）

'python' は内部コマンドまたは外部コマンド、操作可能なプログラムまたはバッチ ファイルとして認識されていません。

これは、

  • Pythonがインストールされていない
  • インストールされているが、PATHに通っていない

のどちらかです。

対処の方向性

  • Python公式サイトからインストーラをダウンロードして再インストールする。
  • インストール時に「Add Python to PATH」にチェックを入れる（Windows）。

2. 「No such file or directory」系

メッセージ例（macOS / Linux）

python3: can't open file 'hello.py': [Errno 2] No such file or directory

これは、ターミナルの現在地とファイルの場所が違うときに出ます。

対処の方向性

  • ls（macOS / Linux）やdir（Windows）で、今いるフォルダにhello.pyがあるか確認する。
  • なければ、cdコマンドで正しいフォルダに移動する。

3. 文法エラー（SyntaxError）

  File "hello.py", line 2
    print("Hello"
                 ^
SyntaxError: unexpected EOF while parsing

これは、

  • 括弧の閉じ忘れ
  • コロンの付け忘れ
  • インデントの不整合

など、Pythonの文法に合っていない部分があるときに出ます。

対処の方向性

  • エラーメッセージに書かれている「行番号」をよく見る。
  • その行付近の括弧やコロン、インデントを確認する。

エラーは「敵」ではなく、「どこがおかしいか教えてくれるメッセージ」だと捉えると、怖さがかなり減ります。

入力を受け取る .py ファイルを実行してみる

次は、ユーザーから入力を受け取る少しだけリッチなスクリプトを作ってみます。

# hello_input.py
print("Hello, World!")
name = input("あなたの名前は？: ")
print(f"はじめまして、{name}さん！")
Python

実行の流れ

  1. ターミナルでファイルがあるフォルダに移動する。
  2. 次のように実行する。bash# Windows python hello_input.py # macOS / Linux python3 hello_input.py
  3. ターミナルに次のような表示が出る。textHello, World! あなたの名前は？: ← ここで入力待ち
  4. 名前を入力してEnterを押すと、textはじめまして、Aliceさん！

このように、.pyファイルを実行するだけで、対話的なプログラムも簡単に作れることがわかります。

VS Codeなどのエディタから .py ファイルを実行する

ターミナルからの実行はPythonの「基礎体力」ですが、実際の開発ではエディタやIDEから実行することが多くなります。

VS Codeの場合の基本的な流れ

  1. VS Codeをインストールする。
  2. Python拡張機能をインストールする。
  3. プロジェクトフォルダをVS Codeで開く。
  4. hello.pyなどのファイルを作ってコードを書く。
  5. エディタ右上の「Run Python File in Terminal」ボタン（再生マーク）をクリックする。

すると、画面下にターミナルが開き、次のようなコマンドが自動で実行されます。

python hello.py      # Windows の例
python3 hello.py     # macOS / Linux の例

つまり、エディタの「実行」ボタンは、裏でターミナルに同じコマンドを打っているだけです。

この仕組みを理解しておくと、

  • 「ターミナルで動くのに、エディタからだと動かない」
  • 「エディタから動くのに、ターミナルだとエラーになる」

といったときに、「どのPythonが使われているのか」「どのフォルダがカレントディレクトリなのか」を意識して問題を切り分けられるようになります。

学習テンプレート：.py ファイル実行の一連の流れ

最後に、初心者の方が「.pyファイルを実行する」感覚を身につけるための、シンプルなテンプレートをまとめます。

テンプレート

  1. フォルダを作る
    • 例: デスクトップにpython_practiceフォルダを作成。
  2. .pyファイルを作る
    • hello.pyを作り、次のコードを書く。pythonprint("Hello, Python script!") for i in range(3): print(f"count: {i}")
  3. ターミナルを開く
    • Windows: コマンドプロンプト／PowerShell
    • macOS / Linux: ターミナル
  4. フォルダに移動するbashcd Desktop/python_practice
  5. ファイルがあるか確認するbash# macOS / Linux ls # Windows dir
  6. Pythonで実行するbash# Windows python hello.py # macOS / Linux python3 hello.py
  7. 出力を確認するtextHello, Python script! count: 0 count: 1 count: 2

この一連の流れを何度か繰り返すことで、

  • 「.pyファイルとは何か」
  • 「ターミナルとPythonインタープリタの関係」
  • 「フォルダ移動とファイル実行の基本」

が自然と身についていきます。

Pythonは、「書く場所」と「動かす場所」がはっきり分かれている言語です。 .pyファイルをターミナルから実行する基本を押さえ、エディタからの実行も仕組みごと理解していくことで、学習と実務の両方で迷いにくくなります。少しずつ、自分の手で動かせるスクリプトを増やしていってください。

スポンサーリンク
タイトルとURLをコピーしました