环境变量配置的核心是让操作系统通过path等变量定位可执行文件和模块路径；windows需添加python主目录及scripts目录到path，linux/macos用export修改path/pythonpath并写入~/.bashrc或~/.zshrc，修改后必须新开终端或执行source生效，且务必包含scripts（或bin）目录以确保pip等工具可用。
环境变量配置的核心，就是让操作系统知道“工具在哪、怎么找、优先用哪个”。它不是某个软件独有的步骤，而是系统级的寻址机制。只要理解这点，Windows 和 Linux/macOS 的操作差异就只是路径写法和配置文件位置不同而已。
Windows 上快速配 Python 环境变量
最稳妥的方式是安装时勾选 Add Python to PATH。如果已安装但漏了这步，手动补上即可：
- 找到 Python 安装目录（如
C:\Users\张三\AppData\Local\Programs\Python\Python311）和 Scripts 目录（...\Python311\Scripts） - 右键“此电脑”→“属性”→“高级系统设置”→“环境变量”
- 在“系统变量”中找到 Path → “编辑” → “新建”，分别添加上述两个路径
- 关闭所有 CMD/PowerShell 窗口，重新打开，运行
python --version和pip --version验证
Linux/macOS 中用 Shell 脚本配置 PATH 和 PYTHONPATH
临时生效可直接在终端执行命令；永久生效需写入 Shell 配置文件：
- 指定 Python 版本：运行
export PATH="/usr/local/bin/python3.9:$PATH"（把你的实际路径替换进去） - 加载自定义模块：运行
export PYTHONPATH="/home/用户名/myproject/lib:/home/用户名/myproject/utils:$PYTHONPATH" - 永久保存：把上面两行加到
~/.bashrc或~/.zshrc末尾，再执行source ~/.bashrc - 验证：运行
echo $PATH和echo $PYTHONPATH看是否包含你设的路径
关键细节不能跳过
很多失败不是操作错了，而是忽略了这些隐性规则：
-
PATH 必须包含 Scripts 目录——否则
pip、pyinstaller等命令无法使用 - 多个路径用冒号（:）分隔（Linux/macOS）或分号（;）分隔（Windows），多打一个空格或错用符号就会失效
- 修改后必须新开终端或执行 source 命令——已打开的终端不会自动刷新环境变量
-
不要覆盖原有 PATH，一定要写成
$PATH或%PATH%在后面，否则系统命令如ls、cd都会找不到
怎么判断是不是环境变量的问题
遇到“命令未找到”、“ModuleNotFoundError”、“JDK not found”这类报错，先做三件事：
- 在终端输入
which python（Linux/macOS）或where python（Windows），看是否返回路径 - 输入
echo $PATH（Linux/macOS）或echo %PATH%（Windows），检查目标路径是否在里面 - 如果是 Python 模块导入失败，再查
echo $PYTHONPATH或运行python -c "import sys; print(sys.path)"
