VSCode中正确配置Jupyter Notebook需四步:一、手动指定jupyter可执行文件路径;二、统一Python解释器与内核环境;三、用%matplotlib inline避免图形渲染问题;四、规范变量命名并预检数据加载,防止内核崩溃。
VSCode 里用 Jupyter Notebook 做数据分析,核心不是装插件就完事——得让
内核真正被识别、能连上、且不卡在依赖冲突或路径错误上。
确认 Python 环境和 jupyter 可执行文件位置
VSCode 不自动继承系统终端的 PATH,常导致它找不到
命令。先在终端运行:
或 Windows 上:
拿到路径后,在 VSCode 设置里搜
,填入完整路径(例如
或
)。否则即使装了插件,新建 notebook 也会报
。
选择正确的 Python 解释器和内核
按
(
mac
OS 是
),输入
,选你装了
、
、
的环境(比如 conda env 或 venv)。然后打开一个
文件,右上角点击内核选择器(显示类似
),确保它和上面选的解释器一致。常见坑:
在 base 环境,但 VSCode 用了
虚拟环境
,结果 kernel 启动失败,报
。
处理 matplotlib 图形不显示或弹窗卡死
默认后端可能触发 GUI 阻塞。在 notebook 第一个 cell 运行:
Trae win
Trae Windows 官方版本现已全面支持 Win10 和 Win11 系统(64位)。国内开发者可直接访问 Trae 中文官网(trae.cn 或 trae.com.cn),一键下载官方正版 .exe 安装包,享受国内直连的高速稳定体验。安装过程极其简便,双击即可运行,并支持一键无缝导入 VS Code 或 Cursor 的原有主题、快捷键及插件配置。登录支持手机号、微信或稀土掘金账号。内置免费的豆包与 DeepSeek 等顶级大模型,让你开箱即用,轻松开启高效的 AI 智能编程之旅。
下载
而不是
或
。如果非要交互式,需额外装
并重启内核:
但注意:
在 VSCode 的 Remote-SSH 或某些 Linux 桌面环境下可能无法渲染,此时老实用
最稳。
避免变量名冲突和 kernel 意外重启
VSCode 的 notebook 默认共享 kernel,但「Run All Cells」时若某 cell 报错(比如
或
),后续 cell 可能因变量未定义而连锁失败。建议:
写分析前先清空所有变量:加一个 cell 运行
避免用
、
这类泛化变量名,改用带业务含义的(如
)
大文件读取加
和
快速试跑,别一上来就
内核崩溃往往不是 VSCode 的问题,而是
版本和
不兼容,或者某个 cell 里写了无限循环 —— 这些细节比界面操作更决定你能不能把分析跑通。
jupyterjupyterwhich jupyterwhere jupyterjupyter.jupyterCommand/opt/anaconda3/bin/jupyterC:\Users\Alice\Anaconda3\Scripts\jupyter.execommand 'jupyter.runCell' not foundCtrl+Shift+PCmd+Shift+PPython: Select Interpreterpandasnumpymatplotlib.ipynbPython 3.11.5 ('myenv': conda)pip install jupyterNo module named 'IPython'%matplotlib inline%matplotlib widget%matplotlib qtipymplpip install ipympl
jupyter nbextension enable --py --sys-prefix ipymplipymplinlineNameErrorMemoryError%reset -fdfdatasales_q3_2024low_memory=Falsenrows=1000pd.read_csv('huge.csv')pandasnumpy