From c1a7924a5688e8b4279c11d52e92655ca4bf95ac Mon Sep 17 00:00:00 2001 From: glennglazer Date: Wed, 10 Jun 2026 23:14:34 -0700 Subject: [PATCH] gh-136880: Add warning about PYTHONPATH (GH-151098) (cherry picked from commit 84630e2cb90ef334e41eb9bccd860b3b0a7ff51b) Co-authored-by: glennglazer --- Doc/tutorial/venv.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/Doc/tutorial/venv.rst b/Doc/tutorial/venv.rst index f362e1943b666f7..6b6b8a768e3f58d 100644 --- a/Doc/tutorial/venv.rst +++ b/Doc/tutorial/venv.rst @@ -88,6 +88,11 @@ For example: '~/envs/tutorial-env/lib/python3.5/site-packages'] >>> +Note that the activated virtual environment does not alter the ``PYTHONPATH`` variable in any way. +This may lead to unexpected results if the path includes references to code which is incompatible with +the Python version the virtual environment is using. The best practice is to ``unset PYTHONPATH`` +in bash or the equivalent for the shell you are using. + To deactivate a virtual environment, type:: deactivate