Skip to content

Commit dd670fa

Browse files
authored
Adds docs to help with troubleshooting pip installs. (GH-133692)
1 parent 6f6f48d commit dd670fa

File tree

1 file changed

+13
-0
lines changed

1 file changed

+13
-0
lines changed

Doc/using/windows.rst

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -95,6 +95,9 @@ as ``python3.14.exe``) to be available. The directory will be
9595
administrator. Click Start and search for "Edit environment variables for your
9696
account" for the system settings page to add the path.
9797

98+
Each Python runtime you install will have its own directory for scripts. These
99+
also need to be added to :envvar:`PATH` if you want to use them.
100+
98101
The Python install manager will be automatically updated to new releases. This
99102
does not affect any installs of Python runtimes. Uninstalling the Python install
100103
manager does not uninstall any Python runtimes.
@@ -713,6 +716,16 @@ default).
713716
your ``pythonw.exe`` and ``pyw.exe`` aliases are consistent with your
714717
others.
715718
"
719+
"``pip`` gives me a ""command not found"" error when I type it in my
720+
terminal.","Have you activated a virtual environment? Run the
721+
``.venv\Scripts\activate`` script in your terminal to activate.
722+
"
723+
"","The package may be available but missing the generated executable.
724+
We recommend using the ``python -m pip`` command instead, or alternatively
725+
the ``python -m pip install --force pip`` command will recreate the
726+
executables and show you the path to add to :envvar:`PATH`. These scripts are
727+
separated for each runtime, and so you may need to add multiple paths.
728+
"
716729

717730

718731
.. _windows-embeddable:

0 commit comments

Comments
 (0)