直接装 pip install jupyter notebook 常因环境混乱、path未生效、端口冲突或默认目录权限受限导致启动失败；需确认python/pip版本正常、使用清华镜像安装、指定安全工作目录并正确注册内核。
直接装 pip install jupyter notebook 就能跑起来，但 Windows 11 下常卡在启动失败、内核不响应、路径乱码或浏览器打不开——根本原因不是命令错了，而是 Python 环境没理清、权限没对、或默认工作目录在系统保护区。
确认 Python 和 pip 已就位，且不在系统路径盲区
很多人输完 pip install jupyter notebook 后，再敲 jupyter notebook 却报“不是内部或外部命令”，其实是 pip 装上了，但 jupyter 可执行文件没进 PATH，或者 Python 自身就没注册进系统变量。
- 先在 CMD 或 PowerShell（不用管理员）里运行：
python --version和pip -V，必须都返回版本号；如果报错，说明 Python 没加到环境变量，得手动补全（比如 Python 安装时勾选了 “Add Python to PATH”，但某些 winget 安装版本默认不勾） - 若
pip -V显示路径含AppData\Local\Programs\Python，那大概率是用户级安装，PATH 通常没问题；若路径是Program Files但命令仍无效，重启终端或重开 CMD 再试一次（PATH 变更不会热加载） - 避免用 winget 装多个 Python 版本后混用：比如
winget install python.python.3.12和winget install python.python.3.13共存时，python命令可能指向旧版，而pip指向新版，导致jupyter装在 A 版本、却试图用 B 版本启动
用 pip 安装时加国内镜像，防超时或证书错误
Windows 11 默认走微软网络策略，pip install jupyter notebook 经常卡在下载 notebook 或 ipykernel 包，甚至抛出 SSLError 或 ConnectionAbortedError。
- 换成清华源最稳：
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ --trusted-host pypi.tuna.tsinghua.edu.cn jupyter notebook - 别漏掉
--trusted-host参数，否则即使指定了镜像，pip 仍会校验原始 PyPI 的 SSL 证书，而企业网/校园网常拦截或替换证书 - 如果已装过但失败，先清理：
pip uninstall jupyter notebook ipykernel，再重装，避免残留半成品干扰
启动失败？检查端口占用和默认目录权限
输完 jupyter notebook 后黑窗闪退、或浏览器打开空白页 / 404 / 500，90% 是以下两个问题之一。
- 端口被占：Jupyter 默认用
8888，但 Teams、OneDrive、甚至某个 Chrome 插件后台进程都可能抢走它。临时换端口试试：jupyter notebook --port=8889 - 默认启动目录是
C:\Users\用户名，Win11 对该路径下某些子文件夹（如AppData或带空格/中文的路径）有严格 ACL 限制，jupyter 无法创建.ipynb_checkpoints目录。解决方法：启动时明确指定路径，例如：jupyter notebook --notebook-dir=D:\jupyter（确保 D:\jupyter 存在且你有完全控制权） - 不建议用管理员身份运行 CMD 启动 jupyter——它会让所有新建 notebook 文件属主变成 SYSTEM，后续你用普通用户改不了权限
想换 Python 环境？别只装 ipykernel，还得注册内核名
在虚拟环境中装了 ipykernel，但在 Jupyter 右上角 Kernel 菜单里看不到那个环境？说明内核没注册进 Jupyter 的全局列表。
- 激活目标环境后，运行：
python -m ipykernel install --user --name myenv --display-name "Python (myenv)" -
--name是内核标识符（纯英文+下划线），--display-name是你在网页界面里看到的名字，二者可以不同 - 注册后，重启 Jupyter（不是刷新页面，是关掉命令行再重跑
jupyter notebook），否则新内核不生效 - 删内核用：
jupyter kernelspec uninstall myenv，别手动删%USERPROFILE%\AppData\Roaming\jupyter\kernels\下的文件夹，容易残留注册表项
最易被忽略的一点：Jupyter 启动后生成的 token 是一次性且有时效的，如果你复制链接时多按了一个空格、或 URL 里混入了换行符，浏览器就会 403；此时别反复重启服务，直接看终端第一行输出的真实 URL，用鼠标精确双击复制整段，一个字符都不能少。
