Jupyter插件在Sublime中无法直接编辑.ipynb文件，仅支持.py文件代码发送至本地内核执行；失败主因是内核未连接、jupyter命令不可用或kernel_name配置错误，需手动指定jupyter_command和kernel_name并重启Sublime。
Jupyter 插件在 Sublime Text 中不能直接打开或编辑 .ipynb 文件，但能实现在 .py 文件中选中代码、一键发送到本地 Jupyter 内核执行——这本质是「轻量前端 + 远程内核」模式，不是 Notebook 界面复刻。
配置失败的绝大多数情况，不是插件没装对，而是内核没连上、路径没对齐、或者根本没启动后台服务。
确认 jupyter 命令是否可用且指向正确环境
Sublime 的 Jupyter 插件依赖系统 PATH 中的 jupyter 可执行文件。它不走 Python 解释器路径，也不认 python -m jupyter。
- 终端里直接运行
jupyter --version，必须有输出（如5.7.8或更高） - 如果用 conda，确保当前 shell 激活了目标环境，再运行
which jupyter，记下完整路径（如/opt/anaconda3/bin/jupyter） - 如果用 pipx 或 pyenv，
jupyter可能不在默认 PATH，需手动加进系统环境变量，或在插件设置里硬编码jupyter_command - Mac 用户特别注意：
~/.zshrc里改了 PATH 后，Sublime 可能读不到——要从终端启动 Sublime（subl），否则它继承的是 GUI 环境的 PATH
Jupyter 插件的 User Settings 必须显式指定 kernel_name
插件默认不自动探测 kernel，留空会报错 No kernelspec found 或卡在 “Connecting…”。
- 打开
Preferences → Package Settings → Jupyter → Settings – User - 填入最小必要配置（路径按你实际调整）：
{
"jupyter_command": "jupyter",
"kernel_name": "python3"
}
-
kernel_name不是 Python 版本号，而是jupyter kernelspec list输出里的名字（常见为python3、myenv、conda-env-myproject-py） - 如果用 conda 环境，kernel 名通常不是
python3，得查清楚再填，否则发过去代码跑在默认 kernel 上，包导入就失败 -
jupyter_command可以写绝对路径，比如/opt/miniconda3/envs/ml/bin/jupyter，绕过 PATH 问题
运行时没反应？先检查内核是否真在监听
插件第一次运行 Ctrl+Alt+B 时，会尝试调用 jupyter console --existing 连接已有内核；连不上就 fallback 启动新内核。但很多失败发生在“以为启动了，其实没起来”。
- 终端手动运行
jupyter console，看是否能进交互式界面；如果报ModuleNotFoundError，说明 kernel 环境缺依赖（比如没装ipykernel） - 确保已安装
ipykernel：在目标环境中运行python -m ipykernel install --user --name myenv --display-name "My Env" - Sublime 底部状态栏若显示
Jupyter: idle却无输出，大概率内核进程已崩溃——去终端查ps aux | grep jupyter，kill 掉残留进程再试 - 别依赖
Ctrl+Alt+B自动启内核：先在终端跑jupyter notebook --no-browser --port=8888（哪怕不用网页端），插件就能稳定连上--existing内核
想编辑 .ipynb 文件？别指望插件渲染，只做 JSON 编辑
Sublime 没有 Notebook 渲染引擎，Jupyter 插件也不处理 .ipynb 文件。强行双击打开，看到的是原始 JSON——可读性差，还容易手抖改坏结构。
- 真正可行的做法：用
jupyter nbconvert --to python notebook.ipynb转成.py，在 Sublime 里编辑，再用jupyter nbconvert --to notebook notebook.py转回 - 装
Pretty JSON插件，至少能让.ipynb文件格式化后可读；配合多光标批量改 cell metadata 有时比网页版快 - 如果输出里有图片或 HTML，转成
.py会丢失——这种场景不适合 Sublime 流程，该切回网页版
最常被跳过的一步：改完插件配置后没重启 Sublime。缓存机制会让旧设置继续生效，哪怕 Settings 文件已保存。遇到诡异行为，先关掉所有 Sublime 窗口再重开。
