在vscode的.ipynb文件中，需先按esc退出编辑模式再按b/a插入代码单元格；运行前须手动选择python解释器并确保内核ready；markdown渲染建议用标准语法并ctrl+enter手动渲染；提交前应清除输出以减小文件体积。
VSCode里怎么插入新代码单元格
在 VSCode 的 .ipynb 文件中，光标必须落在已有单元格内（或空白处），才能触发单元格插入逻辑。常见误区是直接按 Enter —— 这只会换行，不是新建单元格。
正确操作是：
- 将光标放在任意单元格末尾（或空白行），按 Esc 退出编辑模式（此时左侧会出现灰色竖条）
- 再按 B（insert **B**elow）插入下方代码单元格，或 A（insert **A**bove）插入上方单元格
- 也可以右键 → Insert Cell Below，但快捷键更快
- 若当前是 Markdown 单元格且想插代码单元格，需先确认已退出编辑态；否则右键菜单可能只显示 Markdown 相关选项
运行单个单元格没反应？检查内核状态
点击单元格左侧的 ▶ 按钮无响应，大概率是内核未启动或已断开。VSCode Notebook 不会自动激活 Python 环境，必须手动选择。
解决步骤：
- 点击右上角
Python 3.11.5 64-bit（或类似文字）下拉框 → 选择已安装的 Python 解释器路径 - 首次选择后，状态栏会显示
Kernel starting...，等它变成Ready再运行 - 如果卡在
Connecting to kernel...，检查是否安装了ipykernel：pip install ipykernel，再执行python -m ipykernel install --user --name python3 - 运行时报错
ModuleNotFoundError，说明当前 kernel 对应的环境里缺包，不是 notebook 文件本身的问题
Markdown 单元格渲染失败或格式错乱
VSCode 的 Notebook Markdown 渲染器不完全兼容 Jupyter 全套语法，尤其对 HTML 标签、自定义 CSS、复杂表格支持有限。
实际使用建议：
- 避免在 Markdown 单元格里写
<div style="color:red"> 类样式，改用标准 Markdown 语法（如 <code>**加粗**、> 引用） - 表格请用管道符语法，不要用 HTML
<table>，否则预览时可能不渲染 <li>数学公式支持 LaTeX，但需用双美元符包裹：<code>$$E = mc^2$$，单美元符$...$在某些版本中不生效 - 编辑 Markdown 单元格后，必须按 Ctrl+Enter（Windows/Linux）或 Cmd+Enter（macOS）手动渲染，不会自动刷新
- 调试阶段保留输出，方便查问题
- 提交前，右键 → Clear All Outputs，或运行命令
Jupyter: Clear All Outputs（Ctrl+Shift+P 调出） - 如需保留部分图表结果，可单独右键某单元格 → Clear Output
- 配合
.gitattributes设置*jupyter diff=ipynb，让 Git 更好比对 notebook 差异，而不是看整个 JSON
保存后 .ipynb 文件体积暴涨？清理输出再提交
Notebook 默认把每次运行的输出（图表、print 结果、变量值）一起存进 JSON 文件，反复调试后可能达几十 MB，Git 提交困难，也拖慢 VSCode 加载速度。
推荐工作流：
别忘了：VSCode 不会自动帮你删输出，手抖多点几次运行，就可能在 notebook 里埋下几百 KB 的 PNG 图片数据。
