windowspython环境变量一文搞懂设置、作用与管理

什么是 Windows Python 环境变量？

在 Windows 操作系统中，环境变量是系统范围或用户范围的配置值，它们存储了关于系统环境的信息。当你在命令行或运行程序时，操作系统和程序可以读取这些变量来改变它们的行为。

对于 Python 而言，环境变量扮演着至关重要的角色，它们告诉 Windows **在哪里找到 Python 解释器**，以及告诉 Python **在哪里找到你编写的模块和第三方库**。简单来说，它们是让你的 Windows 系统“认识”Python 并知道如何使用它的关键。

为什么要设置 Windows Python 环境变量？

设置 Python 相关的环境变量主要有以下几个目的：

方便执行 Python 命令： 如果没有将 Python 的安装路径添加到系统的 PATH 环境变量中，你就只能在 Python 的安装目录下或者通过指定完整的路径来运行 python.exe。设置好 PATH 后，你就可以在任何命令提示符或 PowerShell 窗口中直接输入 python、pip 等命令来执行，无需关心 Python 安装在哪里。
让 Python 找到自定义模块或第三方库： 当你在 Python 脚本中使用 import 语句导入模块时，Python 会按照一定的顺序去查找这些模块。如果你的模块文件或者某个库不在 Python 的标准库路径或当前脚本目录下，Python 可能就找不到它们。通过设置 PYTHONPATH 环境变量，你可以告诉 Python 额外的模块搜索路径，从而顺利导入自定义或特定位置的模块。
配置 Python 运行时行为： 少数环境变量（如 PYTHONSTARTUP、PYTHONIOENCODING 等）可以用来微调 Python 解释器的启动行为、编码设置或其他运行时特性，提供更灵活的控制。

总而言之，设置环境变量是为了提升使用 Python 的便利性、确保程序能找到所需的资源，并提供一定的运行时配置能力。

Windows Python 环境变量在哪里设置和查看？

在 Windows 中，环境变量通常有两个级别：

用户环境变量： 仅对当前登录用户生效。
系统环境变量： 对所有用户（包括系统服务）生效。

Python 相关的环境变量通常建议设置在用户环境变量中，除非你需要系统范围内都能够访问特定的 Python 版本或库。

在 Windows GUI 中设置环境变量（推荐）

这是最常用且修改后通常会永久生效的方式。

右键点击“此电脑”（或“计算机”），选择“属性”。
在打开的系统窗口中，点击左侧的“高级系统设置”。
在“系统属性”窗口中，切换到“高级”选项卡。
点击右下角的“环境变量”按钮。
在弹出的“环境变量”窗口中，你会看到上下两个列表：上面是“用户变量”，下面是“系统变量”。
要修改或添加用户环境变量，在“用户变量”列表中操作：
- 要添加 PYTHONPATH 或其他新变量，点击“新建”按钮，输入变量名（如 PYTHONPATH）和变量值（如 C:\MyPythonModules），点击确定。
- 要修改 PATH 变量，选中“用户变量”列表中的 Path，点击“编辑”按钮。
  - 在 Windows 10/11 中，会出现一个路径列表编辑器。点击“新建”添加新的路径（如 Python 安装目录下的 Scripts 文件夹路径和 Python 根目录路径），可以通过“上移”或“下移”调整路径的搜索顺序。编辑完成后点击确定。
  - 在旧版本 Windows 中，Path 变量的值是一个长字符串，不同路径之间用分号 ; 分隔。编辑时请小心，不要删除已有的路径，在末尾添加分号后，再追加你的新路径。
- 要删除变量，选中变量，点击“删除”。
修改完成后，逐级点击“确定”关闭所有窗口。
重要： 修改环境变量后，需要关闭所有已打开的命令提示符、PowerShell 或其他终端窗口，然后重新打开一个新的窗口，修改才会生效。对于某些应用程序，可能需要重启。

在命令提示符 (CMD) 中设置环境变量

使用 set 命令可以临时设置环境变量，仅在当前命令提示符窗口及其子进程中有效。关闭窗口后即失效。

临时设置 PATH：

set PATH=%PATH%;C:\Python39;C:\Python39\Scripts

临时设置 PYTHONPATH：

set PYTHONPATH=C:\MyModules;D:\AnotherRepo

临时查看变量值：

echo %PATH%

echo %PYTHONPATH%

查看所有临时变量：

set

使用 setx 命令可以永久设置环境变量（或用户环境变量）。但需要注意的是，setx 命令不会影响当前窗口的环境变量，它设置的环境变量会在新打开的命令提示符窗口中生效。

永久设置用户 PATH (追加)：

setx PATH "%PATH%;C:\Python39;C:\Python39\Scripts"

永久设置用户 PYTHONPATH：

setx PYTHONPATH "C:\MyModules;D:\AnotherRepo"

注意： 使用 setx 修改 PATH 时，如果原有 PATH 值过长，可能会被截断。推荐使用 GUI 方式修改 PATH。设置 PYTHONPATH 时，如果已存在，setx 默认会覆盖原有值，而不是追加。需要手动将新路径和旧路径组合起来。

在 PowerShell 中设置环境变量

在 PowerShell 中，环境变量通过 $env: 前缀访问。

临时设置 PATH (追加)：

$env:Path += ";C:\Python39;C:\Python39\Scripts"

临时设置 PYTHONPATH：

$env:PYTHONPATH = "C:\MyModules;D:\AnotherRepo"

临时查看变量值：

$env:Path

$env:PYTHONPATH

查看所有临时变量：

Get-ChildItem Env:

要永久设置用户环境变量，可以使用 .NET Framework 的 [Environment] 类。

永久设置用户 PATH (追加，较为复杂，推荐 GUI)：

$oldPath = [Environment]::GetEnvironmentVariable("Path", "User")

[Environment]::SetEnvironmentVariable("Path", "$oldPath;C:\Python39;C:\Python39\Scripts", "User")

永久设置用户 PYTHONPATH：

[Environment]::SetEnvironmentVariable("PYTHONPATH", "C:\MyModules;D:\AnotherRepo", "User")

注意： PowerShell 中修改环境变量后，也需要重新打开新的 PowerShell 窗口才能生效。

在 Python 脚本中查看环境变量

你可以通过 Python 的标准库 os 来访问当前进程的环境变量。

import os

# 查看特定环境变量的值
python_path = os.environ.get('PYTHONPATH')
print(f"PYTHONPATH is: {python_path}")

path_var = os.environ.get('PATH')
print(f"PATH is: {path_var}")

# 查看所有环境变量
print("\nAll environment variables:")
for key, value in os.environ.items():
    print(f"{key}={value}")

多少是合适的环境变量设置？（关于 PATH 和 PYTHONPATH）

对于大多数用户而言，最关键的 Python 相关的环境变量是 PATH 和 PYTHONPATH。其他的环境变量通常是高级用法或特定库的需求。

PATH 环境变量

PATH 是一个包含目录路径的列表，操作系统在执行命令时会按顺序去这些目录中查找可执行文件（如 python.exe、pip.exe、.py 脚本等）。

需要添加到 PATH 的路径：
- Python 安装目录的根目录（例如 C:\Python39）。这让你可以直接运行 python 命令。
- Python 安装目录下的 Scripts 目录（例如 C:\Python39\Scripts）。这是 pip 安装的可执行文件（如 pip.exe、jupyter.exe 等）的默认存放位置。将此目录添加到 PATH 后，可以直接在命令行中运行这些工具。
- 如果你在使用虚拟环境 (venv, conda 等)，通常不需要手动将虚拟环境的 Scripts 目录添加到全局 PATH。激活虚拟环境后，其 Scripts 目录会被临时添加到当前 shell 会话的 PATH 前面，优先被搜索。
路径顺序： PATH 中的路径是从左到右按顺序搜索的。如果你安装了多个 Python 版本，将你希望默认使用的版本的路径放在前面。
数量： PATH 变量的值会比较长，包含系统自带的、其他软件添加的路径。重要的是确保 Python 相关的路径被包含在内，并且顺序合适。

典型的用户 PATH 示例 (Windows 10/11 编辑器视图)：

C:\Users\YourName\AppData\Local\Programs\Python\Python39\Scripts\

C:\Users\YourName\AppData\Local\Programs\Python\Python39\

... (其他系统或用户路径) ...

PYTHONPATH 环境变量

PYTHONPATH 是一个包含目录路径的列表，Python 解释器在查找要导入的模块时，会除了标准库路径、当前目录和 .pth 文件指定的路径外，额外搜索 PYTHONPATH 指定的这些目录。

需要添加到 PYTHONPATH 的路径：
- 包含你自己的 Python 模块或包的目录。例如，如果你有一个项目，其中自定义模块放在 C:\MyProjects\MyUtils 目录下，你可以将 C:\MyProjects\MyUtils 添加到 PYTHONPATH，这样在任何地方运行 Python 脚本时，都可以直接 import MyUtils。
- 你可能需要让 Python 找到的、不在标准 site-packages 目录下的第三方库路径。但这通常不推荐，更好的做法是使用 pip 安装到当前环境或虚拟环境中。
路径分隔符： 在 Windows 上，PYTHONPATH 中的多个路径使用分号 ; 分隔。
数量： PYTHONPATH 通常只包含少数几个自定义模块或项目根目录，不会像 PATH 那么长。如果不需要导入特定位置的自定义模块，可以不设置 PYTHONPATH。
优先级： Python 导入模块时，搜索顺序大致是：当前目录 -> PYTHONPATH 中的目录 -> 标准库目录 -> site-packages 目录。

典型的用户 PYTHONPATH 示例 (Windows GUI 编辑器视图或字符串值)：

C:\MyProjects\MyLibraries;D:\SharedModules

其他 Python 相关的环境变量 (了解)

虽然不如 PATH 和 PYTHONPATH 常用，但了解它们有助于解决一些特定问题或进行高级配置：

PYTHONSTARTUP：指定一个 Python 脚本文件的路径。当 Python 交互式解释器启动时，会自动先执行这个脚本。常用于设置一些常用函数或导入常用模块。
PYTHONIOENCODING：设置标准输入/输出/错误流的编码。在处理不同编码的文件或输出时可能有用，尤其是在 Windows 的旧版本或某些终端中默认编码不是 UTF-8 时。
PYTHONBUFFERED：如果设置为非空字符串（如 1），标准输出和标准错误流将不被缓冲，立即输出。对于实时查看程序输出（特别是错误信息）很有用。
PYTHONCASEOK：在 Windows 上，默认情况下，导入模块是大小写敏感的。如果设置此变量，Python 会执行大小写不敏感的导入查找。但通常不推荐依赖此变量，保持模块名和导入语句大小写一致是更好的习惯。

这些变量通常不需要手动设置，除非你有特定的需求。它们的设置方式与 PYTHONPATH 类似。

如何检查和确认 Windows Python 环境变量是否生效？

设置或修改环境变量后，最重要的是确认它们是否已经生效，并且 Python 能否按照预期找到解释器或模块。

确认 PATH 是否包含 Python

打开一个新的命令提示符 (CMD) 或 PowerShell 窗口（确保不是之前已打开的）。
输入命令 python –version 或 python -V 并回车。
如果环境变量设置正确，并且 Python 安装无误，你应该能看到 Python 的版本信息，例如 Python 3.9.7。这表明系统通过 PATH 找到了 python.exe。
如果出现“’python’ 不是内部或外部命令，也不是可运行的程序或批处理文件”等错误，说明 PATH 变量没有正确设置或没有生效。
你也可以输入 where python (CMD) 或 Get-Command python (PowerShell) 来查看系统找到了哪个 python.exe 的路径。

确认 PYTHONPATH 是否生效

打开一个新的命令提示符 (CMD) 或 PowerShell 窗口。
输入 python 命令进入 Python 交互式解释器。

在 Python 提示符 >>> 下，输入以下代码：

        import sys
        print(sys.path)

sys.path 是一个 Python 列表，包含了 Python 查找模块的所有路径。你应该能在这个列表中看到你在 PYTHONPATH 环境变量中设置的路径。如果列表包含了你的自定义模块路径，说明 PYTHONPATH 设置成功。
你也可以尝试导入位于 PYTHONPATH 中某个目录下的自定义模块。如果导入成功，说明 PYTHONPATH 起作用了。
```
        # 假设你的 PYTHONPATH 包含 C:\MyModules，且 C:\MyModules 下有一个文件叫做 my_utils.py
        import my_utils
        print("导入 my_utils 成功！")
        
```
如果导入失败并出现 ModuleNotFoundError，则说明 PYTHONPATH 可能没有设置正确或没有包含正确的路径。

怎么处理 Windows Python 环境变量的常见问题？

在使用过程中，可能会遇到一些与环境变量相关的问题。

问题 1：“’python’ 不是内部或外部命令…”

原因： 系统找不到 python.exe 可执行文件，通常是 Python 安装目录的路径没有添加到系统的 PATH 环境变量中。

解决方法： 按照前面提到的方法，将 Python 安装目录的根目录和 Scripts 目录添加到用户或系统 PATH 环境变量中。修改后，务必关闭并重新打开命令提示符或 PowerShell 窗口。如果在安装 Python 时有勾选“Add Python to PATH”，但仍然出现此问题，可能是安装过程中的错误或环境变量没有立即生效，手动添加通常可以解决。

问题 2：“ModuleNotFoundError: No module named ‘…’”

原因： Python 找不到你要导入的模块。可能的原因包括：

模块名称写错了。
模块没有安装（如果是第三方库）。
模块是你自己编写的，但所在的目录不在 Python 的搜索路径 (sys.path) 中。

解决方法：

确认模块名称是否正确。
如果是第三方库，确保你已经在当前使用的 Python 环境中安装了它，可以使用 pip list 命令查看已安装的库。如果未安装，使用 pip install 模块名 进行安装。
如果模块是你自己编写的或放在特定位置，并且你希望 Python 能找到它：
- 可以将模块文件放在当前正在运行的 Python 脚本所在的目录下。
- 将包含该模块的目录添加到 PYTHONPATH 环境变量中（如前所述），然后重新打开终端窗口。
- 或者，在脚本中临时修改 sys.path：
```
                import sys
                sys.path.append('C:/Path/To/Your/Modules')
                import your_module
                
```
  但这只对当前脚本有效。

问题 3：安装了多个 Python 版本，命令行运行 python 时不是我想要的版本

原因： PATH 环境变量中包含了多个 Python 版本的路径，系统会优先查找排在前面的路径。

解决方法： 修改 PATH 环境变量，将你希望默认使用的 Python 版本的根目录和 Scripts 目录排在其他 Python 版本路径的前面。或者，使用完整的路径来运行特定版本的 Python 解释器，例如 C:\Python39\python.exe your_script.py。使用虚拟环境是管理多个 Python 版本及其依赖的更佳实践。

问题 4：修改了环境变量但没有生效

原因： 环境变量的修改通常不会立即影响正在运行的程序或已打开的终端窗口。

解决方法： 关闭所有相关的命令提示符、PowerShell、IDE 或其他可能使用到环境变量的程序，然后重新打开它们。对于系统环境变量的修改，有时甚至需要重启计算机才能在某些系统服务中生效，但对于用户级别的命令行使用，重启终端通常就足够了。

总结

理解和正确配置 Windows 上的 Python 环境变量，尤其是 PATH 和 PYTHONPATH，对于顺畅地进行 Python 开发至关重要。它们决定了系统如何找到 Python 解释器以及 Python 如何找到你需要导入的模块。通过本文详细介绍的 GUI 和命令行设置方法，你可以根据自己的需求轻松管理这些重要的配置项，解决常见问题，提升开发效率。记住，修改环境变量后，总是需要重启相关的终端或程序才能让变更生效。

windowspython环境变量