vscode笔记本是jupyter的工程化增强，支持调试、git对比、单元测试等；runbyline协议实现逐行执行与精准断点；需配置askforkernelrestart、celltoolbarlocation、experimental.debugging；模块导入需通过extrapaths而非%cd，并转.ipynb为.py复用。
VSCode 的笔记本功能不是 Jupyter 的简单替代，而是深度集成后的工程化增强——它能跑 .ipynb，但更关键的是支持调试、Git 差异对比、单元测试、类型提示和模块复用，这些是纯 Jupyter 环境长期缺失的。
为什么 jupyter.notebook.runByLine 比传统 Cell 执行更可控
VSCode 内置的 Notebook 运行逻辑不依赖 jupyter-server 的完整生命周期管理，而是通过 runByLine 协议逐行注入内核上下文。这意味着：
- 变量作用域可被 VSCode 调试器实时捕获，
debugger语句可停在任意 Python 行（包括 Cell 中间） - Cell 执行失败时，错误堆栈直接映射到源码行号，而非 Jupyter 默认的
<ipython-input-5-123abc></ipython-input-5-123abc>这类模糊标识 - 配合
python.defaultInterpreterPath配置，可确保每个 Notebook 使用独立虚拟环境，避免pip install后需重启内核的等待
settings.json 中必须调整的三个 Notebook 相关配置项
默认配置会让数据科学工作流卡在“看似能用、实则反直觉”的状态。以下三项直接影响体验：
-
"jupyter.askForKernelRestart": false—— 关闭每次执行前弹窗确认，否则批量运行多个 Cell 会频繁中断 -
"notebook.cellToolbarLocation": {"default": "right"}—— 把运行按钮固定在右侧，避免滚动时工具栏消失 -
"jupyter.experimental.debugging": true—— 启用后，Cell 内断点才真正生效；不开启时breakpoint()会被忽略
如何让 import my_module 在 Notebook 里正常工作而不报 ModuleNotFoundError
VSCode Notebook 的模块查找路径默认只包含当前文件所在目录，不自动加入 sys.path 的父级或工作区根目录。解决方式不是改 sys.path，而是靠工程配置：
- 在工作区根目录下创建
.vscode/settings.json，添加：{ "python.defaultInterpreterPath": "./venv/bin/python", "python.extraPaths": ["./src", "./utils"] } - 确保
src/下有__init__.py，否则 Python 不识别为包 - 不要用
%cd切换路径来“绕过”导入问题——这会让后续 Cell 的相对路径失效，且无法被 Git 跟踪
真正难处理的是跨 Notebook 的函数复用：VSCode 不会自动把其他 .ipynb 当作模块加载，import notebook_name 必须先用 jupyter nbconvert --to python 转成 .py，再按常规方式导入。这点容易被忽略，直到你发现修改了源 Notebook 却没生效。
