(最終更新月: 2025年07月17日)
✓当記事はこんな方におすすめです
「python –versionコマンドの働きを初歩から知りたい」
「自分が使っているPythonのバージョンを簡単に調べたい」
「Pythonのバージョン管理や、よくあるトラブルを回避したい」
✓当記事で理解できること
- python –version コマンドの役割・基本的な使い方
- 自分のPython環境でバージョン確認をする方法(実践例付き)
- バージョンにまつわるエラーや対策、バージョンアップまで
この記事では、プログラミング初心者がつまづきやすいPythonバージョン確認の基礎から、エラー対策・バージョンアップ手順まで、実際のターミナル画面やサンプルコードを使いながら、手順を丁寧に解説していきます。
「バージョンの違いに悩んだ運営者の失敗談」や、「現場で使えるコツ」も交え、読めばきっと自信を持ってPython環境を扱えるようになります。
それでは、一緒に見ていきましょう!
Pythonバージョン管理の重要性
このセクションでは、Pythonにおけるバージョン管理の意義について解説します。
バージョン違いによる動作の違いや、初心者が陥りがちなトラブルの多くは「ちがうバージョンを使っていた…」という原因で発生します。
- Pythonとは何か?現場でもよく使われる理由
- Pythonのバージョン番号の読み方と意味
- 実体験:バージョン違いで苦労した話
Pythonとは何か?現場でもよく使われる理由
Pythonは、そのシンプルな文法と圧倒的な使いやすさで、プログラミング初心者からプロまで幅広く愛されています。
機械学習・データ分析・Web開発など、実務のさまざまな場面で活用されているのも大きな特徴です。
初めて学ぶプログラミング言語としてスタートしやすく、書いたコードがすぐに動く喜びも感じやすいです。
たとえば『<print(“Hello, World!”)>』たった一行でプログラムが動くのが魅力です。
Pythonのバージョン番号の読み方と意味
Pythonのバージョン表記は「3.12.2」のように「メジャー」「マイナー」「マイクロ」の3つの数字で区切られます。
「3」が大まかな世代(メジャー)、次の「12」が新機能や改良(マイナー)、最後の「2」が細かなバグ修正や安定性改善(マイクロ)です。
たとえば「3.12.2」と「3.11.6」は大きく動作が異なる場合があり、同じ「3」系でも注意が必要です。
初心者向け入門書や現場のコード例も、「Python3系限定」や「特定バージョン限定」のものが多いので、環境によって再現できない事例が起こるのも納得ですね。
実体験:バージョン違いで苦労した話
筆者自身も、最初にDjangoというWebフレームワークを試したとき、「チュートリアル通りのコードが動かない!」と悩んだことがあります。
原因は、公式ドキュメントがPython3向けなのに、当時「Python2」がPCの標準になっていたことでした。
「python –version」で確認したら「2.7.17」と表示されたときの衝撃は、今でも忘れられません。
こうした体験を通じて、「まず自分のPythonバージョンを正しく把握する」ことの大切さを痛感しました。
python –version コマンドの基本と実践
このセクションでは、python –version コマンドを使った「今の環境で動くPythonバージョン」の調べ方・実践例を解説します。
なぜなら、バージョン違いによるエラーやトラブルを未然に防ぎ、教材・参考記事・社内プロジェクトでの再現性を確保する最初の一歩となるからです。
- python –version・python3 –version・python2 –version の違い
- 実践例:コマンドライン(ターミナル)で調べてみよう
- 【応用】仮想環境/pyenv でのバージョン確認
python –version・python3 –version・python2 –version の違い
基本のコマンドは「python –version」「python3 –version」「python2 –version」ですが、環境ごとに挙動が異なることを知っておきましょう。
WindowsやMac、LinuxなどOSによって「python」が2系なのか3系なのか違う場合があるからです。
特にMacやLinuxでは、2020年以降「python」は3系=「python3」のエイリアスになる流れになってきましたが、古いバージョンのOSやサーバーでは未だ「python」が2系の場合も残っています。
困ったら必ず「python –version」と「python3 –version」両方試すと安心です。
実践例:コマンドライン(ターミナル)で調べてみよう
自分のPCやサーバーでPythonバージョンを調べる最も基本的な手順を解説します。
やり方はとても簡単です。ターミナル(コマンドプロンプト)を開き、以下のコマンドを入力してみましょう。
python --version
出力例(バージョン3の場合):
Python 3.12.2
もし “command not found” などエラーが出た場合は、下記も試してください。
python3 --version
python2 --version
大切なのは、開発現場や教材で「どのバージョンで動作するか明記されているか」を逐一確認する癖をつけることです。
バージョン違いエラーでつまづきやすい初心者のみなさんにこそ、一番最初に体験してほしい手順です。
【応用】仮想環境/pyenv でのバージョン確認
プロジェクトごとにバージョンを切り替えている場合、「仮想環境」や「pyenv」経由での確認が重要です。
venvなど仮想環境を有効化してから「python –version」を打つことで、そのプロジェクトで使われるPythonが一目で分かります。
pyenvの場合は次のようなコマンドで確認できます。
pyenv version
この運用は、特に現代のPython開発現場では必須です。詳しいバージョン切替方法や仮想環境の使い方については、Pythonのバージョンを切り替える方法をOS別に徹底解説 も参考にしてください。
Pythonコード内でバージョンを確認する方法
このセクションでは、「Pythonのプログラムから」自身のバージョン情報を取得する方法について説明します。
理由は、環境依存の動作や要件管理、パッケージ互換など、コード内で動的にバージョン判定したいケースが実務でも多いためです。
- sysモジュールでバージョンを確認する
- platformモジュールで詳細なバージョン取得
- 実践例:特定バージョン条件分岐(if文)
sysモジュールでバージョンを確認する
Python標準の「sys」モジュールは、現在実行中のPythonのバージョンを簡単に知るのに最もおすすめです。
特に「sys.version」と「sys.version_info」の2つがよく使われます。
たとえば次のコードで確認できます。
import sys
print(sys.version)
print(sys.version_info)
前者は “3.12.2 (main, Mar 17 2025, …)” など詳細なバージョン情報、後者は (3, 12, 2, ‘final’, 0) のような構造体として使えます。
platformモジュールで詳細なバージョン取得
「platform」モジュールも、PythonバージョンやOS依存の動作を確認する際によく利用されます。
コマンド例:
import platform
print(platform.python_version()) # 例: "3.12.2"
print(platform.python_version_tuple()) # 例: ('3', '12', '2')
文字列で取得したい場合は「python_version()」、細かく分解して比較したい場合は「python_version_tuple()」が便利です。
たとえば条件判定のif文やログ出力などで活躍します。
実践例:特定バージョン条件分岐(if文)
バージョン依存の処理切り替えは、以下のように記述できます。
「Python 3.8以上の場合のみ新しい構文を使う」例:
import sys
if sys.version_info >= (3, 8):
print("新しい構文が使えます")
else:
print("古いバージョンなので注意!")
このように、バージョンチェックは実運用・パッケージ作成・教育現場など、多くのシーンで「お守り」になります。
バージョンにまつわるエラーと解決策
このセクションでは、「Pythonバージョンやコマンド実行時」にありがちなエラーの例と解決法をまとめます。
経験上、初心者の多くが「原因が分からず焦ってしまう」傾向が強いため、一つひとつ丁寧に紐解いていきます。
- command not found / is not recognized の対処
- TypeErrorやSyntaxErrorの例と原因
- 未対応バージョン/非推奨機能による落とし穴
command not found / is not recognized の対処
“python: command not found” や “python is not recognized” など、コマンドが動かない時は、パス設定やインストールミスが原因です。
特にWindowsではインストール時に「Add Python to PATH」のチェックを入れてないとよく発生します。
Mac/Linuxではパスが通っていなかったり、python3 しか入っていない場合が多いです。
まずは「python3 –version」や「where python」「which python」で存在を探しましょう。それでも難しければ、Pythonのインストール方法をOS別にまとめました! も参考にしてください。
TypeErrorやSyntaxErrorの例と原因
TypeErrorは「型が違う値を操作しようとした時」に、SyntaxErrorは「文法ミス」で発生します。
バージョン違いによる「書き方」や「仕様変更」も原因になりがちです。
例えば「f文字列」がPython3.6以降しか使えない等は、初学者が陥りやすいポイントです。
解決方法はエラー出力内容をよく読み、怪しい行を重点的に見直しましょう。TypeErrorの具体的な解決法はこちら【一発解決】PythonのTypeError解決方法 でも詳しくまとめています。
未対応バージョン/非推奨機能による落とし穴
「この機能はあなたのバージョンでは使えません」系エラーも頻発します。
たとえば “ModuleNotFoundError: No module named ‘dataclasses'” はPython3.7以降でしか標準サポートされません。
pip install で追加しても直らない場合「そもそもバージョンが古すぎる」ことを強く疑ってください。
このケースはバージョンアップ卓越が最善の近道です。
Pythonバージョンのアップデート・切り替え方
このセクションでは、「自分の環境を最新のPythonへアップデート」したいときや、複数バージョンを使い分ける実践術を紹介します。
バージョン管理は、便利に見えて手順を間違えると動かなくなるリスクもあるため、初心者の目線で安全第一を重視した内容にしました。
- Python公式サイトで最新版をインストールする
- pyenvで複数バージョンを管理(Linux/Mac中心)
- 「怖い」時は仮想環境(venv等)利用が安心
Python公式サイトで最新版をインストールする
基本は python.org から最新版インストーラをダウンロードすればOKです。
Windows, Mac, Linux向けそれぞれ丁寧な手順が掲載されています。
再インストールしても、古いバージョンが残る場合があるので注意。インストール時に「PATHへ追加」オプションも必ず確認しましょう。
OS別の詳細なインストール手順はこちら【簡単】Pythonのインストール方法をOS別にまとめました! も参考にしてください。
pyenvで複数バージョンを管理(Linux/Mac中心)
ターミナル操作に慣れてきたら「pyenv」などのバージョン切り替えツールが大変便利です。
一言でいえば、さまざまなバージョンを共存させて、好きな時にスイッチできます。
pyenvのインストール方法は次の通り:
# Homebrew を使ったインストール例 (Mac)
brew install pyenv
# 任意のバージョンをインストール
pyenv install 3.12.2
# デフォルト切り替え
yenv global 3.12.2
詳しくはPythonのバージョンを切り替える方法をOS別に徹底解説で事例をまとめています。
「怖い」時は仮想環境(venv等)利用が安心
メイン環境を壊したくない初心者や業務未経験者は、必ず「venv」など仮想環境での学習・開発をおすすめします。
何度でも作り直せて、その場のバージョン管理が簡単です。
# 仮想環境作成
python3 -m venv venv_test
# 有効化(Mac/Linux)
source venv_test/bin/activate
# 有効化(Windows)
venv_test\Scripts\activate.bat
有効化後にpython –version コマンドを用い、「仮想環境で使われているPythonのバージョン」が確認できます。
バージョン違いによる事故リスクを最小化する、現場お墨付きのテクニックです。
まとめ
この記事では、python –versionコマンドによるバージョン確認方法、および関連するバージョン管理・エラー対応・アップデート術まで、初心者にも分かりやすい順に解説しました。
最も重要なのは、「(1)必ず自分のPythonバージョンを調べる習慣」「(2)バージョンごとの違いや切り替え手法を知っておく」「(3)エラー解決の初手としてバージョンの確認を徹底」です。
これらを身に付けることで、「教材通り動かない」「謎のエラーに悩む」といったトラブルが激減します。
ITエンジニアの最初の一歩として、ぜひ本記事を参考に楽しいPython学習の道を歩みましょう。
さらに最新のクラウド環境で学習・開発を進めたい方には、DigitalOceanの活用もおすすめしています。自分だけの開発環境構築にも役立ちます。
今後もPython初心者向けサンプルコード特集や、Pythonファイルをexe化する方法といった実践的情報も続々公開中です。
「わからない!」を感じたときは、ぜひITC Mediaを活用してください。一緒にITエンジニアを目指しましょう!