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。 - 临时规避方案
若暂时无法升级扩展,可选择以下任意一种操作:- 将需要打开的.ipynb文件移动到本地非重定向目录下存储,比如直接在
C:\盘新建专属的Python工作目录,不要将文件放在\\profiles$开头的网络共享路径中 - 打开VS Code设置,搜索
python.languageServer,将默认值从Pylance修改为Jedi,重启VS Code后报错即可消失,仅会小幅影响代码补全、语法检查的性能表现
- 将需要打开的.ipynb文件移动到本地非重定向目录下存储,比如直接在
操作完成后重启VS Code,重新打开Jupyter笔记本即可消除错误提示。
内容的提问来源于stack exchange,提问作者xeric080
相关产品推荐
相关产品推荐

