Python 环境变量管理的核心是让解释器、包安装工具和第三方库能准确定位 Python 可执行文件、标准库路径、第三方包位置以及用户自定义模块路径。关键不在“设多少”，而在“设对地方”和“避免冲突”。
区分 PYTHONPATH 和 sys.path
PYTHONPATH 是操作系统环境变量，仅在 Python 启动时被读取一次，用于扩展 sys.path 的初始内容；它不随运行中修改 sys.path 而变化。
sys.path 是 Python 运行时实际使用的模块搜索列表，由 PYTHONPATH、安装路径、当前目录等共同构成，可动态增删（但不推荐频繁修改）。
常见误区：把开发路径硬编码进 PYTHONPATH 后忘记清理，导致不同项目间模块互相干扰。
- 临时添加路径（适合调试）：
python -c "import sys; sys.path.insert(0, '/path/to/my/module'); import mymod" - 永久添加（仅限可信本地开发环境）：在 shell 配置文件（如
~/.bashrc）中写export PYTHONPATH="/opt/mylib:$PYTHONPATH"，然后source ~/.bashrc - 检查效果：
python -c "import sys; print('\n'.join(sys.path))"
用虚拟环境隔离 PYTHONPATH 和 site-packages
虚拟环境（venv / conda）本质是创建独立的 Python 解释器副本 + 独立的 site-packages 目录。它自动重置 PYTHONPATH 为 None（即不依赖系统 PYTHONPATH），并把虚拟环境路径优先加入 sys.path。
这比手动管理 PYTHONPATH 更安全、更可复现。
立即学习“Python免费学习笔记（深入）”；
PHP商城系统是国内领先商城系统,网店系统,购物系统,网上商城系统,B2C商城系统产品.同时也是一个商业的PHP开发框架。PHP 商城系统由内容、文章、会员、留言、订单、 财务、广告、短消息、数据库管理、营销推广、内置支付管理、商品配送管理、无限级分类、全站搜索等多个功能模块插件组成。在当今瞬机万变的市场环境中，快速高效的IT解决方案是您业务成功的关键。我们PHP商城系统能为您量身打造完全符合需求
- 创建并激活：
python -m venv myenv && source myenv/bin/activate（Linux/macOS）或myenv\Scripts\activate（Windows） - 验证：
which python应指向虚拟环境内；python -c "import site; print(site.getsitepackages())"应只显示虚拟环境路径 - 不建议在虚拟环境中再设 PYTHONPATH —— 容易绕过隔离机制
理解 PATH 对 python 命令的影响
PATH 决定终端输入 python 或 pip 时调用哪个可执行文件；它和模块导入无关，但直接影响你实际运行的是哪个 Python 版本。
典型问题：明明装了 Python 3.11，python --version 却显示 3.9 —— 很可能是 PATH 中旧版本路径排在前面。
- 查看当前 python 位置：
which python（Linux/macOS）或where python（Windows） - 临时切换：
export PATH="/usr/local/bin/python3.11:$PATH"（注意把新路径放最前） - 长期管理建议：用
pyenv（跨平台）或conda（科学计算场景），它们通过动态修改 PATH 实现版本切换，无需手动编辑
敏感变量慎用：PYTHONHOME 和 PYTHONEXECUTABLE
PYTHONHOME 指向 Python 的安装根目录（含 lib/, bin/ 等），一般由 Python 自动推导；手动设置容易破坏标准库加载逻辑，仅在嵌入式或特殊部署场景下由专业人士使用。
PYTHONEXECUTABLE 多用于打包工具（如 PyInstaller）内部，普通开发几乎不用。
除非明确知道后果，否则不要设置这两个变量 —— 它们不是解决“找不到模块”的常规手段。
- 误设 PYTHONHOME 的典型症状：启动报错
ImportError: No module named site - 排查方法：
python -c "import sys; print(sys.executable, sys.base_prefix, sys.prefix)"，三者应一致或符合预期结构 - 清除影响：
unset PYTHONHOME PYTHONEXECUTABLE（Linux/macOS）或set PYTHONHOME=（Windows）
不复杂但容易忽略：环境变量的作用时机、作用范围和优先级决定了它的实际效果。与其反复调试 PYTHONPATH，不如优先用好虚拟环境 + 明确 PATH 顺序。
