VSCode Jupyter Notebook_数据科学开发与可视化配置

VSCode中Jupyter Notebook无法运行，90%因内核未注册或选错环境；需在目标环境执行python -m ipykernel install注册，重启VSCode后手动选择右上角内核，而非依赖底部Python解释器选择。

遇到VSCode里的Jupyter Notebook跑不起来，先别急着折腾插件或重装Python。十有八九，问题出在内核上——要么是内核根本没注册，要么就是选错了执行环境。

为什么Shift+Enter没反应、单元格灰色、右上角没内核可选

这通常不是快捷键失灵，而是VSCode压根没找到一个可用的ipykernel实例。很多人会误解，以为装了Jupyter扩展就万事大吉。其实，这个扩展只负责界面的渲染和任务调度，真正在背后执行代码的，是你本地Python环境里那个已经注册过的kernel。它跟你命令行里jupyter命令能不能用关系不大，只认ipykernel有没有被显式地“报到”系统里。

• 首先，在终端里激活你的目标环境：用conda activate ds或者source venv/bin/activate。
• 然后，运行这条关键命令：python -m ipykernel install --user --name ds --display-name "Python (ds)"。
• 接下来，必须重启VSCode，再重新打开你的.ipynb文件，去点击右上角的内核选择器看看。
• 如果列表里还是没有，可以运行jupyter kernelspec list检查一下输出。如果对应的路径里包含空格或者中文字符，注册很可能会失败。

选了解释器，但Notebook还是连错环境

这里有个经典的“坑”：VSCode底部状态栏那个Python: Select Interpreter选项，只对普通的.py文件生效，负责调试和代码补全。对于.ipynb文件，它完全不起作用。Notebook的执行环境，只由右上角的内核选择器单独决定，这两者完全可以指向不同的Python环境。

• 典型场景：你在项目里用venv或.venv装了pandas，但Notebook默认连的却是系统Python，结果一运行就报ModuleNotFoundError。
• 解决方法很直接：点击右上角显示的内核名称，从下拉列表里手动选中你之前注册好的那个（比如Python (ds)）。
• 如果列表里找不到，那就说明那个环境压根没注册过kernel，得回到上一步去操作。
• 别指望VSCode会自动把你工作区里的虚拟环境映射成内核——它不会猜你的心思，你得明确地告诉它。

# %% 分隔的 .py 文件比 .ipynb 更适合日常探索

说到协作和维护，.ipynb文件有个硬伤：一保存就会产生大量JSON格式的差异，包括输出内容、元数据、单元格ID等等，让版本对比变得一团糟。相比之下，用# %%分隔的纯文本.py文件就友好多了：它可以轻松diff、方便代码审查，几乎没有冲突风险，同时还能享受到类似Notebook的交互体验。

• 你可以新建一个explore.py文件，写几段代码，中间用# %%分隔开。
• 把光标放在任意一段代码里，按下Shift+Enter，VSCode会自动打开交互式窗口来执行这段。
• 生成的变量会自动进入Variables面板供你查看，DataFrame可以双击展开成表格，图表也能直接渲染出来。
• 更重要的是，这种方式不会意外地把运行输出保存到源文件里污染它，而且即使重启了kernel，之前的变量上下文也不会丢失（因为输出根本没被保存）。

Matplotlib / Plotly 图表不显示或卡住

图表渲染不出来，问题往往不在库本身有没有安装，而在于内核的后端配置和VSCode的输出通道是否匹配。这在远程连接、conda环境未启用GUI后端，或者内核被某个阻塞调用卡住时尤其常见。

• 首先确保库已安装：在当前kernel所在的环境里执行pip install matplotlib plotly。
• 对于Matplotlib，其默认后端可能不兼容，可以尝试在导入前加一行配置：import matplotlib; matplotlib.use('Agg')，然后再import matplotlib.pyplot as plt。
• 对于Plotly，需要启用针对VSCode的离线渲染模式：import plotly.io as pio; pio.renderers.default = 'vscode'。
• 如果图表区域一片空白但控制台又没有报错，记得看一眼VSCode右下角的状态栏。如果显示“Kernel is busy”，那很可能是前一个单元格的代码陷入了死循环，或者在等待输入。

最后提一个最容易被忽略的点：内核注册基本上是一次性的。但是，如果你的环境路径变了（比如重装了Conda、把项目文件夹挪了地方），或者你新建了一个虚拟环境，那么就必须重新执行一遍注册命令。VSCode不会主动去同步这些变化，更不会跳出来提醒你，这事儿得自己记着。