From 9de04a93cc223dbc40ef99b062f5252a37960ee2 Mon Sep 17 00:00:00 2001 From: Steve Dower Date: Thu, 8 May 2025 18:55:54 +0100 Subject: [PATCH 1/2] Adds docs to help with troubleshooting pip installs. --- Doc/using/windows.rst | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/Doc/using/windows.rst b/Doc/using/windows.rst index 74d6db5d7d1a98..1b4ea2135b8881 100644 --- a/Doc/using/windows.rst +++ b/Doc/using/windows.rst @@ -95,6 +95,9 @@ as ``python3.14.exe``) to be available. The directory will be administrator. Click Start and search for "Edit environment variables for your account" for the system settings page to add the path. +Each Python runtime you install will have its own directory for scripts. These +also need to be added to :envvar:`PATH` if you want to use them. + The Python install manager will be automatically updated to new releases. This does not affect any installs of Python runtimes. Uninstalling the Python install manager does not uninstall any Python runtimes. @@ -713,6 +716,16 @@ default). your ``pythonw.exe`` and ``pyw.exe`` aliases are consistent with your others. " + "``pip`` gives me a ""command not found"" error when I type it in my + terminal.","Have you activated a virtual environment? Run the + ``.venv\\Scripts\\activate`` script in your terminal to activate. + " + "","The package may be available but missing the generated executable. + We recommend using the ``python -m pip`` command instead, or alternatively + the ``python -m pip install --force pip`` command will recreate the + executables and show you the path to add to :envvar:`PATH`. These scripts are + separated for each runtime, and so you may need to add multiple paths. + " .. _windows-embeddable: From 56595ce4d510a4f2dd3a0c23760e40c37bc710e4 Mon Sep 17 00:00:00 2001 From: Steve Dower Date: Thu, 8 May 2025 19:01:35 +0100 Subject: [PATCH 2/2] Doubled slashes --- Doc/using/windows.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Doc/using/windows.rst b/Doc/using/windows.rst index 1b4ea2135b8881..c084392ca66d55 100644 --- a/Doc/using/windows.rst +++ b/Doc/using/windows.rst @@ -718,7 +718,7 @@ default). " "``pip`` gives me a ""command not found"" error when I type it in my terminal.","Have you activated a virtual environment? Run the - ``.venv\\Scripts\\activate`` script in your terminal to activate. + ``.venv\Scripts\activate`` script in your terminal to activate. " "","The package may be available but missing the generated executable. We recommend using the ``python -m pip`` command instead, or alternatively