Windows 11 上で Python + venv を使う

Python
2025.03.13

Python のバージョンやライブラリの問題は多いので、Python のバージョンを複数入れられて、環境も仮想環境を用いることでライブラリの競合などを最小限にできるような環境を構築する。

git も使うので、git bash 上で使うことにした。

git bash を快適にする

起動方法

エクスプローラーの適当なフォルダで、Shift + 右クリックで「Open Git Bash here」を選択する

設定

左上のマークをクリックし、Options… を選択する

フォントサイズの変更

Options を開いたら Text を選択する。そこで、Font の Select を選択する。
今回は Terminal の 14px に設定

初期画面サイズの変更

Options を開いたら Window を選択する。Columns と Rows を設定する。
今回は Columns 120, Rows 40 にした。

右クリックでペーストできるようにする

Options を開いたら Mouse を選択する。Right mouse button を Paste に設定する

音を消す

今回は設定していないが、Termial に項目がある

プロンプトを変える

１）vi を使える方

vi ~/.bashrc

以下を記入

PS1='\$ '

２) vi を使えない方

以下のファイルをテキストエディタで開いて上記内容を記述。

c:\Users\<ユーザ名>\.bashrc

インストール

pyenv のインストール

PowerShell を管理者権限で起動。

スクリプト実行ポリシーの確認

ExecutionPolicy

出力結果をメモしておく。

スクリプト実行ポリシーの変更

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

pyenv をインストール

Invoke-WebRequest -UseBasicParsing -Uri "https://raw.githubusercontent.com/pyenv-win/pyenv-win/master/pyenv-win/install-pyenv-win.ps1" -OutFile "./install-pyenv-win.ps1"; &"./install-pyenv-win.ps1"

これにより、スクリプトが pyenv-win を適切な場所 (C:\Users\<ユーザー名>\.pyenv\pyenv-win\) にインストールされる。

環境変数を設定

[System.Environment]::SetEnvironmentVariable("PYENV", "$env:USERPROFILE\.pyenv\pyenv-win", "User")
[System.Environment]::SetEnvironmentVariable("Path", "$env:USERPROFILE\.pyenv\pyenv-win\bin;$env:USERPROFILE\.pyenv\pyenv-win\shims;$env:Path", "User")

インストール中に作成したファイルを削除する

rm install-pyenv-win.ps1

スクリプト実行ポリシーを戻す

Set-ExecutionPolicy Restricted -Scope CurrentUser

Restricted の部分は、スクリプト実行ポリシーの確認でメモした内容にする。Restrected は制限が強いのでよくわからなければこれにしておけばよい。

pyenv を使って Python をインストール

利用可能なバージョンを確認

pyenv install --list

どのバージョンを選ぶべきか？

バージョン意味入れるべきか？
3.11.5安定版 (推奨)⭕ 入れるべき
3.12.0a1アルファ版 (a1, a2, …)❌ 非推奨（開発者向け）
3.12.0b1ベータ版 (b1, b2, …)❌ 非推奨（テスト向け）
3.12.0rc1リリース候補版 (rc1, rc2, …)❌ 非推奨（最終テスト向け）
3.11.5-win3232ビット版❌ 非推奨（Windows 11 なら 64bit が良い）
3.11.5-6464ビット版⭕ 推奨（Windows 11 は 64bit）

Python のインストール

pyenv install 3.13.2

グローバル設定

pyenv global 3.13.2

確認

python --version

venv の基本的な使い方

仮想環境の作成

python -m venv myenv

myenv は仮想環境のフォルダ名（好きな名前でOK）。 myenv フォルダの中に仮想環境が作成される。

仮想環境の有効化

git bash の場合

source myenv/Scripts/activate

PowerShell の場合

myenv\Scripts\Activate

仮想環境の無効化

deactivate

この後は？

こちらの記事に、Jupyter Notebook のセットアップ方法を書きましたので、参考にしてください。

Jupyter Notebook 環境の構築 (Windows11)

おまけ：VSCode の設定

VSCode で、venv内で pip install したライブラリなどを認識してくれないため、
.vscode/settings.json に明示的に指定する (以下の例だと C:/src/mypj 配下に作り、VSCode で C:/src/mypj を開く )

{
  "python.defaultInterpreterPath": "C:/src/mypj/myenv/Scripts/python.exe",
  "python.analysis.extraPaths": [
    "C:/src/mypj/myenv/Lib/site-packages"
  ]
}