You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

VS Code打开Jupyter Notebook报错"Couldn't start client Python Tools"求助

问题根因

该错误是2021.9版本VS Code Python扩展、Pylance语言服务器的已知兼容性bug,对存储在\\profiles$这类UNC网络重定向路径下的.ipynb笔记本文件识别异常,导致Python工具客户端启动失败。你可以正常运行代码单元是因为Jupyter内核独立于Pylance语法服务运行,所以服务报错不影响内核执行逻辑。

解决步骤

  • 升级扩展版本
    打开VS Code扩展面板,找到「Python」和「Pylance」两个官方扩展,升级到最新稳定版即可,该UNC路径兼容问题在2021年10月之后的版本已经完成修复。如果升级后仍有异常,可以尝试回退到2021.8版本的Python扩展和Pylance,也可规避该bug。
  • 临时规避方案
    若暂时无法升级扩展,可选择以下任意一种操作:
    1. 将需要打开的.ipynb文件移动到本地非重定向目录下存储,比如直接在C:\盘新建专属的Python工作目录,不要将文件放在\\profiles$开头的网络共享路径中
    2. 打开VS Code设置,搜索python.languageServer,将默认值从Pylance修改为Jedi,重启VS Code后报错即可消失,仅会小幅影响代码补全、语法检查的性能表现

操作完成后重启VS Code,重新打开Jupyter笔记本即可消除错误提示。

内容的提问来源于stack exchange,提问作者xeric080

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.05 06:39:01