python -m venv

パッケージと実行環境

書き方

python -m venv [--upgrade-deps] <directory>

フォルダー一つに独立したPythonとsite-packagesを作ります。作っただけでは何も起きず、activateするか.venv/bin/pythonを直接呼ぶ必要があり、経路が中に焼き込まれるので後でフォルダー名を変えると壊れます。

よく使うオプション

オプション意味
--upgrade-depsstart with an up-to-date pip
--system-site-packageslet it see the globally installed packages
--clearempty the directory first
--prompt <name>what the shell prompt should say
--without-pipno pip inside

python -m venv .venv

creates an isolated interpreter and site-packages in .venv

source .venv/bin/activate

starts using it; on Windows it is .venv\Scripts\activate

python -m venv --upgrade-deps .venv

creates it with the newest pip inside

何をどこに入れるかが問題です。このプロジェクトの中か、マシン全体かを先に決めてください。

読み方

  • 角括弧 [ ] は省いてよい部分です。
  • 三点 … は複数並べられるという意味です。
  • オプションは大文字小文字を区別します — -r と -R が別物のコマンドもあります。

よくある質問

Q. python -m venv は何をしますか。

フォルダー一つに独立したPythonとsite-packagesを作ります。作っただけでは何も起きず、activateするか.venv/bin/pythonを直接呼ぶ必要があり、経路が中に焼き込まれるので後でフォルダー名を変えると壊れます。

Q. どう打ちますか。

python -m venv [--upgrade-deps] <directory> — 角括弧は省いてよい部分です。

Q. よく使うオプションはいくつですか。

ここにまとめたのは5個です。全部は man python にあります。このコマンドはパッケージと実行環境の仲間です。

関連するコマンド

man ページ: man python--m-venv