PyCharm中Jupyter无法运行的根源是解释器环境不一致:项目解释器与终端安装环境不同导致模块找不到;需在PyCharm终端激活对应环境并安装jupyter和ipykernel,正确注册内核,检查kernel.json路径格式(Windows用双反斜杠或正斜杠),切换终端为cmd避免PowerShell激活失效,并确保Jupyter服务端口未被占用且token可正常获取。

PyCharm 项目解释器和 Jupyter 安装环境不一致
这是最常被忽略的根源:PyCharm 运行 Jupyter 时,用的是项目设置里的 Python 解释器;但你在终端里 pip install jupyter,很可能装到了另一个环境(比如系统默认 Python 或 Anaconda base)。结果就是 PyCharm 找不到 jupyter 模块,报 “ModuleNotFoundError” 或直接卡在启动界面。
- 检查当前解释器:右下角点击解释器名称 → 进入「Python 解释器」设置页,确认路径是否和你预期的一致(比如
C:UsersXXXAnaconda3envsmyenvpython.exe) - 安装 Jupyter 到该解释器:在 PyCharm 终端里,确保已激活对应环境(
conda activate myenv或source activate myenv),再运行pip install jupyter ipykernel - 别在系统 cmd/PowerShell 里装——除非你明确知道它指向的就是 PyCharm 当前解释器路径
内核注册失败或路径错误(kernel.json 里 python.exe 路径失效)
即使 Jupyter 装好了,PyCharm 仍可能显示 “Kernel does not exist on the Jupyter server”,原因是 kernel.json 文件里写的 python 路径不对——常见于重装 Anaconda、迁移环境、或复制粘贴路径时把 / 和 混用。
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包,下载地址指向官方 Windows 安装包直链,可用于旧项目兼容、版本回退和环境测试。
- 先查已注册内核:
jupyter kernelspec list,看输出里类似myenv C:UsersXXXAppDataRoamingjupyterkernelsmyenv的路径 - 进该目录打开
kernel.json,检查argv字段第一项是不是完整且可访问的python.exe路径(例如"C:\Users\XXX\Anaconda3\envs\myenv\python.exe") - Windows 下必须用双反斜杠
\或正斜杠/,不能混用单反斜杠(否则 JSON 解析失败) - 路径里有空格或中文?建议重装环境到无空格纯英文路径,比如
D:pyenvmyenv
PyCharm Terminal 默认 shell 导致内核启动失败
PyCharm 终端默认用 PowerShell(显示 PS 提示符),而某些 Windows 环境下 PowerShell 会干扰 conda 激活逻辑,导致 activate myenv 失效,进而让 python -m ipykernel install 实际注册到错误环境。
- 进入 Settings → Tools → Terminal → Shell path,把值从
powershell.exe改成cmd.exe - 改完重启 PyCharm,再在 Terminal 里执行
conda activate myenv→python -m ipykernel install --user --name myenv --display-name "Python (myenv)" - 验证注册成功:
jupyter kernelspec list应该能看到myenv,且路径指向你期望的环境
PyCharm 连接本地 Jupyter 服务时 token 或端口配置错
PyCharm 启动 Notebook 时,其实是自己拉起一个 Jupyter 服务(默认 localhost:8888)。如果这个端口被占用,或服务启动后没返回 token,PyCharm 就会一直转圈或报超时。
- 关掉所有其他 Jupyter 进程:任务管理器结束
python.exe或运行taskkill /f /im python.exe - 手动启动一次确认服务可用:
jupyter notebook --no-browser --port=8888,看控制台是否输出 token(形如?token=abc123...) - PyCharm 设置里不要填完整 URL,只填
http://localhost:8888;token 由 PyCharm 自动提取,无需手动输入 - 如果仍卡住,尝试换端口:
jupyter notebook --no-browser --port=8889,再在 PyCharm 中改成http://localhost:8889

















