Windows系统下Python安装Jupyter后的环境变量配置

拾柒

发布时间：2026-10-25| 4人浏览过

原创

在 Windows 环境中使用命令提示符或 PowerShell 执行 pip install jupyter，命令输出显示安装成功，但当紧接着在终端中输入 jupyter notebook 时，系统却弹出提示：'jupyter' 不是内部或外部命令，也不是可运行的程序或批处理文件。遇到这一现象，通常并不是 Jupyter 安装损坏，而是因为系统尚未获知其执行文件所在的存储路径。本文将说明 Windows 终端执行命令的检索机制，指导如何精准定位 Python 及 Scripts 目录，并完成系统的 Path 环境变量配置与服务可用性验证。

一、为什么安装成功后系统找不到 jupyter 命令

在 Windows 操作系统中，当用户在命令行终端中输入某个程序名称（例如 jupyter）时，系统并不会主动遍历整个硬盘寻找该文件。系统的查找逻辑非常固定：首先检查当前执行命令的工作目录；如果当前目录下不存在对应名字的可执行文件，系统便会遍历环境变量 Path 中预先登记的每一个文件夹路径。

使用 pip 安装 Python 第三方工具包时，核心的 Python 代码会被置入 Lib\site-packages 目录，而向操作系统暴露的可执行工具脚本（如 jupyter.exe、pip.exe）则被统一存放在 Python 安装目录下的 Scripts 子文件夹内。如果在最初安装 Python 时未勾选“Add Python to PATH”，或者后续使用的是独立安装的用户路径，系统环境变量中就缺少该 Scripts 目录的登记项，导致终端在收到 jupyter 指令时无处可查。

Windows系统下Python安装Jupyter后的环境变量配置 — 图 1：Windows 终端命令查找逻辑与 Path 环境变量的对应关系

二、准确定位 Python 与 Scripts 安装路径

配置环境变量的前提是掌握精确的文件物理路径。在 Windows 平台中，Python 的安装位置通常分为两类：系统全局安装与当前用户独立安装。不同的安装方式决定了路径的前缀差异。

1. 使用命令行查询 Python 解释器位置

如果当前命令行能够识别 python 命令本身，可以直接在终端中运行以下指令：

where python

示例输出：

C:\Users\Username\AppData\Local\Programs\Python\Python311\python.exe
C:\Program Files\Python311\python.exe

where python 命令会输出当前调用的 python.exe 完整路径。该文件所在的父级文件夹即为 Python 根目录，而其内部的 Scripts 文件夹即为目标路径。

2. 使用 Python 内部模块获取精准路径

如果系统安装了多个版本，或者通过带 --user 标志安装了 Jupyter，可以通过执行 Python 内置模块代码直接打印位置：

python -c "import sys, os; print('Python根目录:', sys.prefix); print('Scripts目录:', os.path.join(sys.prefix, 'Scripts'))"

对于采用 pip install --user jupyter 安装的用户，脚本可能位于用户独立的 AppData 漫游目录中，可通过如下命令获取漫游脚本路径：

python -m site --user-base

该命令输出的文件夹路径下同样存在一个 Scripts 目录。记录下这两个关键路径：一个是 Python 根目录，另一个是 Scripts 目录。

三、Windows 环境变量 Path 的配置步骤

获取到 Scripts 目录的完整绝对路径后，即可通过 Windows 系统图形化设置面板，将该路径加入 Path 变量。

打开系统属性窗口：
按下键盘快捷键 Win + R 唤起“运行”对话框，输入 sysdm.cpl 并按下回车，直接打开“系统属性”窗口。
进入环境变量配置面板：
在“系统属性”窗口顶部点击切换到“高级”选项卡，在窗口右下方点击“环境变量”按钮。
选择并编辑 Path 变量：
环境变量窗口分为两部分：上方为“当前用户的用户变量”，下方为“系统变量”。
- 如果仅需当前 Windows 账户可用，在上方用户变量列表中找到并选中 Path，点击“编辑”。
- 如果需要本台计算机的所有登录用户均可使用，在下方系统变量中选中 Path，点击“编辑”（此操作可能需要管理员授权）。
添加路径条目：
在弹出的“编辑环境变量”窗口中，点击右侧的“新建”按钮，将刚才获取的 Scripts 目录绝对路径完整粘贴进去（例如 C:\Users\Username\AppData\Local\Programs\Python\Python311\Scripts）。
同时检查列表中是否存在 Python 根目录（例如 C:\Users\Username\AppData\Local\Programs\Python\Python311）；若未存在，建议同样新建条目添加该路径。
保存配置：
点击“编辑环境变量”窗口的“确定”，再点击“环境变量”窗口的“确定”，最后点击“系统属性”窗口的“确定”。必须连续点击三次“确定”，配置才会写入注册表并正式生效。

注意：如果当前已经打开了命令提示符（CMD）或 PowerShell 窗口，配置完环境变量后，旧终端不会自动更新变量。必须完全关闭已有终端窗口，重新启动新的终端实例，修改后的 Path 才会生效。

四、配置验证与 Jupyter 启动测试

完成环境变量设置并重新开启终端窗口后，需要按照以下两步验证配置是否正确。

1. 验证命令识别与版本输出

在新开启的终端中输入以下指令，检查系统是否能够正确调度 Jupyter：

jupyter --version

示例输出：

Selected Jupyter core packages...
IPython          : 8.22.1
ipykernel        : 6.29.3
jupyter_client   : 8.6.0
jupyter_core     : 5.7.1
jupyter_server   : 2.12.5
jupyterlab       : 4.1.2
nbclient         : 0.9.0
nbconvert        : 7.16.1
nbformat         : 5.9.2
notebook         : 7.1.1

当能够正常打印出各核心模块的版本清单时，证明系统已能够顺畅检索到 Scripts 目录下的 jupyter 入口。

2. 启动 Jupyter Notebook 服务

确认命令可被识别后，执行启动指令：

jupyter notebook

此时控制台会输出本地服务器的日志信息，包括监听的端口号（默认 http://localhost:8888/tree）及带身份令牌（Token）的访问链接，默认浏览器将自动弹出 Jupyter Notebook 的主管理界面。

五、常见问题排查与注意事项

1. 仍提示命令找不到时的备用调用方案

如果在配置后由于系统权限限制或配置格式错误导致 jupyter 仍无法直接调用，可利用 Python 解释器模块直接启动：

python -m notebook

只要当前 Python 环境安装了 Notebook 包，-m 参数就能绕过系统的 Path 文件名检索机制，直接调用包内入口。这也是检验 Jupyter 包本身是否完好的有效手段。

2. 多 Python 版本与虚拟环境隔离

如果电脑中安装了多个不同版本的 Python（例如 Python 3.9 与 Python 3.12），需要保证添加到 Path 中的 Scripts 目录与执行 pip install jupyter 时的 Python 版本保持一致。如果希望在不同的项目中使用独立的环境，建议使用 venv 创建虚拟环境：

python -m venv myenv
myenv\Scripts\activate
pip install jupyter
jupyter notebook

在虚拟环境中，激活脚本 activate 会自动在当前终端会话的前端临时注入该环境专属的 Scripts 路径，退出终端后自动失效，不会对操作系统的全局环境变量产生冲突。

3. Windows 应用商店版 Python 的路径别名干扰

部分 Windows 系统预装了应用商店（Microsoft Store）的 Python 快捷方式（AppExecutionAlias）。当用户在没有安装 Python 时输入 python，系统会自动打开应用商店页面。如果已经通过官方安装包安装了 Python，却依然频繁发生环境混乱，可在 Windows“设置 -> 应用 -> 高级应用设置 -> 应用执行别名”中，将“应用安装程序 (python.exe)”和“应用安装程序 (python3.exe)”两项开关关闭，以避免系统默认应用执行别名对实际安装路径的劫持。