jupyter notebook 不生效最常见原因是系统 path 未包含 jupyter 可执行文件路径，需检查安装、确认 scripts/bin 目录并添加至 path，或改用 python -m notebook 启动；指定工作目录可用 --notebook-dir 参数或配置文件；启动卡住时应查看日志确认服务是否运行、检查端口占用及防火墙，并保持命令行窗口开启。
jupyter notebook 就能启动，前提是 Python 和 Jupyter 已正确安装且环境变量配置无误。如果报错或打不开，大概率不是命令写错了，而是环境或路径问题。
为什么 jupyter notebook 不生效？
最常见原因是系统找不到这个命令，错误信息通常是：'jupyter' is not recognized as an internal or external command（Windows）或 command not found: jupyter（macOS/Linux）。这说明 pip 安装的可执行文件没进系统 PATH。
- 检查是否真装了：
pip show jupyter或pip show notebook，有输出才代表安装成功 - 确认安装位置：Windows 通常在
C:\Users\{用户名}\AppData\Local\Programs\Python\PythonXX\Scripts\；macOS/Linux 多在~/Library/Python/X.X/bin/或~/.local/bin/ - 把对应
Scripts或bin目录加进系统 PATH，重启终端再试 - 用
python -m notebook是更稳妥的替代写法，绕过 PATH 依赖
如何指定工作目录启动？
默认会在当前命令行所在目录启动，但很多人想固定打开某个项目文件夹（比如 D:\projects\ml），而不是每次都 cd 进去。
- 启动前先
cd D:\projects\ml（Windows）或cd ~/projects/ml（macOS/Linux），再运行jupyter notebook - 一步到位：直接运行
jupyter notebook --notebook-dir="D:\projects\ml"（路径含空格要加英文引号） - 永久生效：运行
jupyter notebook --generate-config，然后编辑生成的jupyter_notebook_config.py，取消注释并修改c.NotebookApp.notebook_dir = 'D:/projects/ml'（注意用正斜杠或双反斜杠）
jupyter notebook 启动后卡住或打不开页面？
命令执行后没反应、浏览器不自动弹出、或页面显示“连接被拒绝”，通常不是程序崩溃，而是服务没真正就绪或端口冲突。
- 看命令行最后一行是否出现类似
The Jupyter Notebook is running at: http://localhost:8888/...—— 没这行说明服务根本没起来 - 如果看到地址但打不开，先试手动复制完整 URL（含
?token=xxx那段）粘贴到浏览器；token 一次性有效，关了页面再开就得重新复制 - 端口 8888 被占用了？加参数换端口：
jupyter notebook --port 8889 - 防火墙或杀毒软件有时会拦截 localhost 请求，临时禁用试试
- 启动后千万别关掉命令行窗口——它就是服务器进程，关了等于关服务
启动时想跳过浏览器自动打开
有些场景下（比如远程服务器、WSL、或你只想后台跑服务），不需要浏览器立刻弹窗。
- 加
--no-browser参数：jupyter notebook --no-browser - 同时指定端口和目录：
jupyter notebook --no-browser --port 8889 --notebook-dir="/home/user/nb" - 此时必须手动访问
http://localhost:8889（或对应 IP + 端口），且 token 仍需从命令行日志里复制
jupyter notebook、jupyter notebook --no-browser 和 python -m notebook 这三条。其他参数都是为特定场景兜底用的，别一上来就堆配置——先跑通，再调优。最容易忽略的是：命令行窗口必须保持开启，以及 token 只在首次启动日志里出现一次。
