1-2. ローカル開発環境の構築(Windows / Mac)

Pythonでのプログラミングを始めるにあたり、最初に必要となるのが「ローカル開発環境」の構築です。本節では、インストールの手順からコマンドライン操作、パッケージ管理、そして実務で必須となる仮想環境(venv)の使い方までを体系的に解説します。

1. 公式インストーラーを使用したPythonの導入とPath(環境変数)の設定

まずは、Python本体をパソコンにインストールします。

Windowsでの手順

  1. 公式サイトからダウンロード: Python公式サイトの Downloads ページから、Windows用の最新安定版(Python 3.x)のインストーラーをダウンロードします。
  2. インストーラーの実行: ダウンロードした .exe ファイルを起動します。
  3. Pathの設定(最重要): インストーラー最初の画面下部にある Add python.exe to PATH(または Add Python to PATH)に必ずチェックを入れてから Install Now をクリックしてください。注意: ここにチェックを入れ忘れると、コマンドプロンプトやPowerShellから python コマンドが認識されず、環境変数の手動設定が必要になります。

Macでの手順

  1. 公式サイトからダウンロード: Python公式サイトから macOS用インストーラー(.pkg)をダウンロードして実行します。
  2. インストール: 画面の指示に従って進めれば完了します(macOSでは自動的に実行パスが通ります)。
  3. Homebrewを使う場合(代替手段): ターミナルを開き、brew install python でインストールすることも可能です。

インストールの確認

インストールが成功したか確認するため、ターミナル(Mac)またはPowerShell(Windows)を起動し、以下のコマンドを実行します。

Bash

python --version
# または
python3 --version

バージョン番号(例: Python 3.12.x)が表示されれば準備完了です。

2. コマンドライン(Terminal / PowerShell)の基本コマンド操作

Pythonの開発や実行、パッケージ管理はコマンドラインツールを使って行います。まずは頻繁に使う基本操作を押さえましょう。

操作内容Windows (PowerShell / Command Prompt)Mac (Terminal)
現在地の表示Get-Location (または pwd)pwd
ファイル・フォルダ一覧dir (または ls)ls -la
フォルダの移動cd フォルダ名cd フォルダ名
1つ上のフォルダへ戻るcd ..cd ..
フォルダの作成mkdir フォルダ名mkdir フォルダ名
画面のクリアclear (または cls)clear

3. パッケージ管理ツール pip の使い方と requirements.txt による環境の固定

Pythonには外部ライブラリ(パッケージ)を簡単に導入できる標準ツール pip が付属しています。

基本的な pip コマンド

Bash

# パッケージのインストール
pip install requests

# インストール済みパッケージの一覧表示
pip list

# パッケージのアンインストール
pip uninstall requests

requirements.txt による環境の固定と共有

チーム開発や本番環境へ配置する際、「どのライブラリのどのバージョンを使っているか」を記録・再構成するために requirements.txt を利用します。

  1. 現在の環境をテキストに出力(固定)Bashpip freeze > requirements.txt
  2. requirements.txt から一括インストール(環境の復元)Bashpip install -r requirements.txt

4. 仮想環境(venv)の役割と完全理解

なぜ仮想環境が必要なのか?

パソコン全体(グローバル環境)にライブラリを直接インストールしていくと、「プロジェクトAでは Pandas v1.x が必要だが、プロジェクトBでは Pandas v2.x が必要」といったバージョン衝突が発生します。

venv を使うことで、プロジェクトごとに独立したPython実行環境(箱庭)を作成でき、プロジェクト同士の干渉を防ぐことができます。

venv の基本操作手順

① 仮想環境の作成

プロジェクトのルートフォルダに移動し、myenv(名前は任意)という名前で仮想環境を作成します。

Bash

python -m venv myenv
# Macの場合: python3 -m venv myenv

② 仮想環境の有効化(Activate)

作成した仮想環境を有効にします(OSによってコマンドが異なります)。

  • Windows (PowerShell):PowerShell.\myenv\Scripts\Activate.ps1 (※スクリプト実行エラーが出る場合は Set-ExecutionPolicy RemoteSigned -Scope Process を実行してください)
  • Windows (Command Prompt):DOSmyenv\Scripts\activate.bat
  • Mac / Linux:Bashsource myenv/bin/activate

有効化されると、ターミナルの先頭に (myenv) と表示されます。この状態で pip install を行うと、myenv 内だけにライブラリがインストールされます。

③ 仮想環境の無効化(Deactivate)

開発作業が終わったら、以下のコマンドで通常の環境に戻ります。

Bash

deactivate

まとめ

  1. Python導入時: Windowsでは必ず Add to PATH にチェックを入れる。
  2. pip & requirements.txt: パッケージの管理と構成情報の保存・共有を行う。
  3. venv: プロジェクトごとに独立した仮想環境を作り、依存関係の衝突を防ぐ。

これで、安全かつ快適にPython開発を始めるための基盤が整いました。

コメント

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