Pythonの環境構築の手順(公式インストーラとvenv仮想環境の作り方)

Pythonの環境構築の手順(公式インストーラとvenv仮想環境の作り方) 環境構築

こんにちは!ともです。自動化の作例で最もよく使う言語がPythonです。ただ、Pythonは「入れたはずなのに動かない」「バージョンがぐちゃぐちゃになった」という声が多い言語でもあります。最初の用意の仕方で、その後の進みやすさが大きく変わります。

この記事では、公式インストーラでPythonを入れる手順と、プロジェクトごとに環境を分ける「venv(仮想環境)」の作り方をまとめます。この2つを押さえれば、作例を進めるための土台が整います。

【この記事で分かること】

この記事で分かること
この記事で分かること
  • Pythonの環境構築でやることの全体像
  • 公式インストーラでの入れ方(WindowsとMacの違い)
  • バージョンの確認方法
  • venvで仮想環境を作って有効化する手順
  • 仮想環境の中でパッケージを入れる方法

【Pythonの環境構築でやること】

Pythonの環境構築でやること
Pythonの環境構築でやること

やることは大きく2段階です。1段階目は、パソコン全体で使えるPython本体を入れること。2段階目は、プロジェクトごとに「venv」という仮想環境を作り、その中で作業することです。

仮想環境とは、プロジェクト専用の小さな作業部屋のようなものです。部屋ごとに道具(パッケージ)を分けて置けるので、ある作例で入れた道具が、別の作例の邪魔をしなくなります。

最初は面倒に感じるかもしれませんが、この「分ける」習慣があるだけで、「昨日まで動いていたのに壊れた」という事故がぐっと減ります。考え方の背景は、全体像の記事でも触れています。

開発環境とは何か

【必要なものとコスト】

必要なものとコスト
必要なものとコスト

Python本体も、venvの仕組みも無料です。追加の料金はかかりません。

項目内容
使うツールPython(公式配布)/venv(Python付属の仕組み)
料金の目安無料(約0円)
前提Windows 10以降、またはmacOSのパソコン/VS Codeなどのエディタ

【難易度と進め方の目安】

難易度と進め方の目安
難易度と進め方の目安

難易度は中くらいです。インストールは簡単ですが、後半でターミナルを少し使います。目安の所要時間は40分前後です。

進め方は「インストール→バージョン確認→venv作成→パッケージ導入→動作確認」の順番です。エディタのVS Codeがまだの場合は、先に入れておくと確認作業が楽になります。

VS Codeのインストールと初期設定

【手順1:Pythonをインストールする】

手順1:Pythonをインストールする
手順1:Pythonをインストールする

Pythonは、公式サイト(python.org)から配られているインストーラで入れるのが基本です。お店のアプリストア経由でも入れられますが、作例の解説と画面をそろえるため、この記事では公式インストーラで進めます。

Windowsの場合、手順で最も大事なのは最初の画面です。インストーラを起動すると、下のほうに「Add python.exe to PATH」というチェック項目が出ます。これに必ずチェックを入れてから「Install Now」を押してください。ここを忘れると、あとでコマンドが通らなくなります。

Macの場合は、公式サイトから自分のチップ(AppleシリコンかIntelか)に合ったインストーラを選び、案内に沿って進めます。Macには最初から別のPythonが入っていることもありますが、バージョンが古いことが多いので、公式のものを別途入れるのが基本です。

【手順2:バージョンを確認する】

手順2:バージョンを確認する
手順2:バージョンを確認する

インストールが終わったら、ターミナルで確認します。コマンドの上の「#」で始まる行は説明文なので、入力するのはその下の行だけです。

Windows(PowerShell)の場合:

# Pythonのバージョンを表示する(数字が出ればインストール成功)
python --version

Mac(ターミナル)の場合:

# Pythonのバージョンを表示する(Macでは python3 と打つことが多い)
python3 --version

「Python 3.13.x」のように、3から始まる数字が表示されれば成功です。Windowsでお店のアプリの画面が開いてしまう場合は、手順1のPATHのチェックを忘れている可能性が高いので、インストーラをもう一度実行して確認してください。

【手順3:venvで仮想環境を作る】

手順3:venvで仮想環境を作る
手順3:venvで仮想環境を作る

次に、プロジェクト専用の仮想環境を作ります。まず、作例用のフォルダを用意して、その中へ移動します。

Windows(PowerShell)の場合:

# プロジェクトのフォルダへ移動する(場所は自分の環境に合わせる)
cd C:\Users\あなたの名前\projects\my-app

# 仮想環境を作る(.venv という名前のフォルダができる)
python -m venv .venv

# 仮想環境を有効化する(先頭に (.venv) と表示されれば成功)
.venv\Scripts\Activate.ps1

Mac(ターミナル)の場合:

# プロジェクトのフォルダへ移動する(場所は自分の環境に合わせる)
cd ~/projects/my-app

# 仮想環境を作る(.venv という名前のフォルダができる)
python3 -m venv .venv

# 仮想環境を有効化する(先頭に (.venv) と表示されれば成功)
source .venv/bin/activate

有効化すると、コマンド入力欄の先頭に「(.venv)」と付きます。これが「今はプロジェクト専用の部屋の中にいる」という印です。ターミナルを開き直したら、もう一度有効化のコマンドを実行してください。

【手順4:仮想環境の中でパッケージを入れる】

手順4:仮想環境の中でパッケージを入れる
手順4:仮想環境の中でパッケージを入れる

仮想環境の中では、「pip」という道具で追加の部品(パッケージ)を入れられます。試しに、よく使うパッケージを入れてみます。

# パッケージ管理ツール pip 自体を最新に更新する
python -m pip install --upgrade pip

# 例として、Webページの情報を取得するための requests を入れる
pip install requests

# 今入っているパッケージの一覧を表示して確認する
pip list

一覧に「requests」と、その仲間のパッケージが表示されれば成功です。この一覧は仮想環境の中だけのものなので、他のプロジェクトには影響しません。

【動作確認:短いプログラムを動かす】

動作確認:短いプログラムを動かす
動作確認:短いプログラムを動かす

最後に、Pythonが本当に動くか確かめます。プロジェクトのフォルダに「hello.py」というファイルを作り、次の内容を書いてください。「#」で始まる行は、プログラムの動きを説明するコメントです。

# 画面に文字を表示する(動作確認用の短いプログラム)
print("Pythonが動いています")

# 簡単な計算をして、結果を表示する
total = 100 + 250
print(total)

保存したら、仮想環境を有効化したままのターミナルで実行します。

# hello.py を実行する(Windowsは python、Macは python3 でも可)
python hello.py

「Pythonが動いています」と「350」が表示されれば、環境構築は完了です。この形が、この先のPython作例すべての出発点になります。

【つまずきやすい点】

つまずきやすい点
つまずきやすい点

よくあるつまずきは4つです。1つ目は、WindowsでPATHのチェックを忘れることです。コマンドが「見つからない」と言われたら、まずここを疑ってください。再インストールのときにチェックを入れ直せば直ります。

2つ目は、「python」と「python3」の違いです。Macでは「python3」と打つのが基本で、Windowsでは「python」が基本です。記事によって書き方が違うのは、このOSの違いが理由です。

3つ目は、仮想環境の有効化を忘れることです。ターミナルを開き直すたびに有効化が必要です。パッケージを入れたのに読み込めない、という場合は、まず画面の先頭に「(.venv)」があるか確認してください。

4つ目は、WindowsのPowerShellで有効化がエラーになることです。セキュリティ設定で止められる場合があり、そのときは管理者として開いたPowerShellで実行ポリシーの変更が必要になります。会社のパソコンでは情シス部門のルールもあるので、無理に変更せず、まず確認するのが安全です。

【まとめ】

まとめ
まとめ

Pythonの環境構築は、公式インストーラで本体を入れることと、venvでプロジェクトごとに部屋を分けることの2段階です。PATHのチェックと、有効化の習慣さえ押さえれば、作例を進める土台が安定します。

Pythonがどんな言語で、どんな目的に向いているかを確認したい場合は、言語全体の記事もあわせてどうぞ。

プログラミング言語とは何か

次の一歩としては、作ったコードをGitで記録できるようにしておくと安心です。記録の土台とセットで、環境づくりはひと区切りになります。

GitのインストールとGitHub連携の手順

なお、「自分で作るのではなく、業務の自動化そのものを相談したい」という場合は、作ってもらう選択肢もあります。

\ 業務の自動化やAI活用を、代わりに作ってほしい方はこちら /

コメント

タイトルとURLをコピーしました