Início·Comandos de terminal

python -m venv

Pacotes e runtimes

Uso

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

Cria um interpretador isolado e o site-packages dentro de uma pasta; criar não faz nada até você ativar ou chamar .venv/bin/python direto, e os caminhos ficam gravados, então renomear a pasta depois quebra tudo.

Opções comuns

OpçãoSignificado
--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

Exemplos

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

A pergunta é sempre o que vai onde: dentro deste projeto ou na máquina toda.

Como ler

  • Os colchetes [ ] marcam uma parte que você pode omitir.
  • As reticências … indicam que você pode listar vários.
  • As opções diferenciam maiúsculas: em alguns comandos -r e -R fazem coisas diferentes.

Perguntas

Q. O que python -m venv faz?

Cria um interpretador isolado e o site-packages dentro de uma pasta; criar não faz nada até você ativar ou chamar .venv/bin/python direto, e os caminhos ficam gravados, então renomear a pasta depois quebra tudo.

Q. Como se digita?

python -m venv [--upgrade-deps] <directory> — os colchetes marcam o que você pode omitir.

Q. Quantas opções vale a pena saber?

Aqui estão 5; a lista completa está em man python. Este comando fica em Pacotes e runtimes.

Comandos relacionados

página man: man python--m-venv