python / python/cpython

On Windows, VENV does not copy pip module into a new created virtual environments

未關閉
#139,018 4 則留言 0 個 reaction 已指派 0 人 在 GitHub 檢視

還沒有人認領這個 Issue。

stdlib topic-venv type-bug
主要語言
Python
星號
77.2k
分支
35.9k
PR 合併指標
PR 指標待擷取

描述

Bug report

Bug description:

When creating a new isolated environment via VENVE, module pip is not installed and does not exist in Lib/site-packages. The command pip is available but still operates on non-virtual environment level.

Specification
  • Windows 10 Home (22H2)
  • PowerShell 7.5.3
  • Python 3.13.7
  • Launcher (py.exe).
Steps to reproduce the issue
  • Run py -m venv .venv
  • Activate environment: .\ .venv\Scripts\Activate.ps1
  • Try to upgrade pip: python -m pip install pip --upgrade
  • Python will report the error that pip is not installed.

Other distribution s.a. 3.12 and 3.11 have the same issue.

Description

I simply run the following command py -m venv .venv to create a new environment, followed by activation .venv\Scripts\Activate.ps1. I've got a new prompt (.venv) PS D ...> . The Get-Command python indicates the correct path to python.exe: <local path>\.venv\Scripts\python.exe.

Here's the problem. After activating new environment, while pip is still available as a standalone program, it does not work on a local level. If I try to run pip install numpy --dry-run, I get the report

Requirement already satisfied: numpy in <user>\appdata\local\programs\python\python313\lib\site-packages (2.3.3)

I believe pip should work on a local level. BTW, if I run the command Get-Command pip, the path to pip is

<User>\AppData\Local\Programs\Python\Python313\Scripts\pip.exe
Impossible to install new modules

This obviously leads to the problem of not being able to install new modules in newly created environments because pip is missing. For instance python -m pip install pip --upgrade issues the error

`<local path>\.venv\Scripts\python.exe: No module named pip

while python still works as expected, that is Get-Command python outputs

<local path>\.venv\Scripts\python.exe

I can also run Get-Children -Recurse -Path ".venv/" to check local Lib/site-packages

    Directory: <Local Path>\.venv

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d----          16/09/2025    12:20                Include
d----          16/09/2025    12:20                Lib
d----          16/09/2025    12:20                Scripts
-a---          16/09/2025    12:20             71 .gitignore
-a---          16/09/2025    12:20            338 pyvenv.cfg

    Directory: <Local Path>\.venv\Lib

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d----          16/09/2025    12:20                site-packages

    Directory: <Local Path>\.venv\Scripts

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a---          16/09/2025    12:20           2208 activate
-a---          16/09/2025    12:20           1022 activate.bat
-a---          16/09/2025    12:20           2281 activate.fish
-a---          06/08/2025    16:16           9031 Activate.ps1
-a---          06/08/2025    16:14            393 deactivate.bat
-a---          06/08/2025    16:15         255320 python.exe
-a---          06/08/2025    16:15         251736 pythonw.exe

    Directory: <Local Path>\__pycache__

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a---          29/07/2024    16:12          15096 backup.cpython-312.pyc

but the folder Lib/site-packages is empty. please, note Get-Children -Recurse ignores empty folders in further iteration.


Possible workarounds

The only working workaround is to copy pip and pip-25.2.dist-info from global Lib/site-packages into isolated environment's Lib/site-packages.

CPython versions tested on:

CPython main branch

Operating systems tested on:

Windows

貢獻指南

開啟貢獻指南

從這裡開始

  1. 先讀完整個 Issue,再讀專案的貢獻指南。
  2. 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
  3. Fork 儲存庫,在一個分支上完成修改。
  4. 送出 Pull Request,並在描述裡引用這個 Issue 編號。

研究方向

py -m venv .venv 入口點開始,並重現報告中描述的 Windows PowerShell 命令。檢查新環境如何引導 pip,並根據空的 Lib/site-packages 目錄驗證結果;完成的標準是 pip 可透過環境的 Python 使用,而不是透過全域安裝使用。

由索引模型根據 Issue 內容生成。

評估

技術堆疊
python
領域
tooling
Issue 類型
缺陷
難度
3/5
預估耗時
1-2 天
活躍度
停滯
描述清晰度
基本清楚
新手友好度
45/100

把新 issue 寄到你的電子郵件信箱

精選適合新手參與的 GitHub issue 摘要。