From cf51e948d628eeb7de2c4221b083ec122b432110 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 91e4ce18acef1d..4eee4ac5f5facd 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