Sublime Text 无法原生支持 Jupyter Notebook 功能,需通过插件调用本地 Jupyter 内核执行代码;必须手动配置 jupyter_command 和 kernel_name,且重启生效;富文本输出(图表、Markdown 等)均不渲染,仅支持代码发送与基础 IPython 执行。

Sublime Text 不能打开或运行 .ipynb 文件,也不支持单元格执行、内核状态保持、富文本输出渲染——它压根没实现 Jupyter 的 messaging protocol。所谓“配置 Jupyter 运行环境”,实际只有一条路径:把选中的 Python 代码发给本地已启动的 IPython/Jupyter 内核执行。
确认 jupyter 命令是否在 PATH 中且指向正确环境
插件依赖系统级 jupyter 可执行文件,不认 python -m jupyter,也不走 Python 解释器路径。
- 终端里运行
jupyter --version,必须有输出(如 5.7.8 或更高) - 用 conda 的话,先激活目标环境,再运行
which jupyter,记下完整路径(例如/opt/anaconda3/bin/jupyter) - Mac 用户注意:
~/.zshrc里改了 PATH 后,subl图形界面可能读不到——必须从终端执行subl启动 Sublime,否则它继承的是 GUI 环境的 PATH - 如果用 pipx 或 pyenv,
jupyter很可能不在默认 PATH,要么加进系统环境变量,要么在插件设置里硬编码jupyter_command
Jupyter 插件必须显式指定 kernel_name
插件默认不自动探测 kernel,留空会卡在 “Connecting…” 或报错 No kernelspec found。
- 打开
Preferences → Package Settings → Jupyter → Settings – User - 填入最小必要配置(路径按你实际调整):
{ "jupyter_command": "/opt/anaconda3/bin/jupyter", "kernel_name": "python3" } -
kernel_name必须和jupyter kernelspec list输出里的名称完全一致(比如python3、myenv、conda-env-myproject-py) - 改完保存,重启 Sublime —— 不重启,新配置不生效
SublimeREPL 是更轻量、更可控的替代方案
如果你只是想快速把代码块丢进 IPython 执行,SublimeREPL 比 Jupyter 插件更少依赖、更容易调试。
- 安装后通过
Tools → SublimeREPL → Python → Python - IPython启动一个本地 IPython REPL - 快捷键发送代码:在
Preferences → Key Bindings的用户配置中加{ "keys": ["ctrl+shift+enter"], "command": "repl_transfer_current", "args": { "scope": "selection", "repl": "IPython" } } - 它支持基础 magic 命令(如
%matplotlib inline),但仍是单 cell 模式,不维持跨行变量状态 - 不需要提前启动
jupyter notebook或jupyter console,只要系统装了ipython就能跑
别指望 Sublime 渲染图表或 Markdown 输出
所有插件都只做代码发送,不处理前端协议。图像、表格、LaTeX、交互控件等全部不会显示。
- 执行含
plt.show()的代码,图窗会弹出(依赖 matplotlib backend),但不会嵌入编辑器 -
display(df)、Markdown("...")、HTML(...)全部被忽略或转成字符串打印 - 想看富输出?唯一办法是切到浏览器里开
jupyter notebook或jupyter lab - 如果你真需要类 Notebook 体验,
SublimeJupyter(GitHub 上仍在维护的分支)可连本地 Jupyter server,但它要求你手动启动服务、配置 token,且仍不支持单元格导航和输出历史回溯
真正麻烦的不是插件怎么装,而是搞清「Sublime 从来就不是 Notebook 前端」这个前提。很多人卡在连接失败,其实只是 jupyter_command 路径错了,或者 kernel_name 和实际注册名对不上——这两个字段必须手填、必须精确、必须重启生效。


















