Cursor Pylance 禁用问题详细中文攻略

2025.10.11更新

笑死,pylance把cursor禁用了,然后cursor把pylance也禁用了,难绷

解决方法

这个时候需要从vscode安装好pylance,然后从vscode下载pylance的VSIX文件,然后倒入到cursor 注意只能下载2024.8.1版本,再新的版本不行

由于cursor禁用了非cursor应用市场的插件
所以此时还要修改

  • Gallery: Service Url → https://marketplace.visualstudio.com/_apis/public/gally
    具体如何修改方式下面有

由于这个链接以及失效了,所以cursor根据这个失效的链接也不会查了,pylance直接生效哈哈哈


​

在 Cursor 里重现 Pylance:最详细的中文攻略

写在前面
如果你把 Type Checking Mode 设成 “off”,Pyright 就不会再提示缺失导入等错误;而 Pylance 又因为 Cursor 改用 OpenVSX 而「下架」了。这篇文章手把手教你在 Cursor 中重新启用 Pylance,并附带推荐的开源替代 —— basedpyright。


为何要折腾 Pylance?

  • Pyright + Django Stub 配置繁琐,仍会漏检类型。
  • Pylance 自带更智能的类型推断,对 Django 友好,开箱即用。
  • Cursor 默认使用 OpenVSX,官方 Pylance 扩展不再可见。
  • 即使你离线安装 .vsix,Pylance 也会检查 IDE,不是 VS Code 就拒绝启动。

:warning: 基于隐私与开源立场,作者本人已切换到 basedpyright。本文提供 Pylance 的曲线救国方案,供有刚需的朋友参考。

声明,方法来源:Unable to find Pylance in the extension marketplace - #39 by onticdani - Bug Reports - Cursor - Community Forum


实现思路

  1. 让 Cursor 重新连接到微软官方扩展市场(VS Code Marketplace)。
  2. 绕过 Pylance 的 IDE 校验,强制启用扩展代码。

Step 1:恢复 VS Code Marketplace

  1. 打开设置
  1. 定位扩展源配置
  • 导航到 Features → Extensions。
  • 找到两项:
    • Gallery: Item Url
    • Gallery: Service Url
  1. 填入微软地址
  • Gallery: Item Url → https://marketplace.visualstudio.com/items
  • Gallery: Service Url → https://marketplace.visualstudio.com/_apis/public/gally
  1. 重启 Cursor
  • 此时,VS Code 官方扩展pylance已重新出现在商店里。

Step 2:安装并破解 Pylance

以下示例在 Ubuntu DevContainer 下演示,Windows/Mac 仅需替换路径。

2-1 安装 Pylance

  • 在扩展市场搜索 “Pylance” 并安装。
  • Cursor 当前拉取的版本通常是 ms-python.vscode-pylance-2024.8.1。

2-2 找到扩展目录

# 以 Linux 为例,路径可能是:
~/.cursor-server/extensions/ms-python.vscode-pylance-2024.8.1/dist


# 以 windows 为例,路径可能是:
C:\\Users\\你的用户\\.cursor-server/extensions/ms-python.vscode-pylance-2024.8.1/dist

[image]

2-3 备份并修改 extension.bundle.js

# linux
cd ~/.cursor-server/extensions/ms-python.vscode-pylance-2024.8.1/dist
cp extension.bundle.js extension.bundle.js.bak   # 备份

# windows
直接复制粘贴备份即可

[image]

  1. 用你熟悉的编辑器打开 extension.bundle.js。
  2. 搜索以下 高亮字符串(长得像一串混淆代码)并整段删除:
return(0x0,_0x3cf4c5[_0x41b32f(0x1cb)])(_0x1802de['licenseErrorText']),{'client':_0x114703,'start':()=>{const _0xdc463e=_0x41b32f;return _0x5f5976[_0xdc463e(0x472)](_0x15fc6b[_0xdc463e(0x596)][_0xdc463e(0x4e4)]),Promise['resolve']();},'stop':()=>Promise[_0x41b32f(0x147)](),'disposables':_0xf1f7d3}

[image]

这段代码负责检测当前 IDE 是否为 VS Code,删掉即可跳过校验。

  1. 保存文件并关闭编辑器。

2-4 重启 Cursor

  • Pylance 现在应能正常加载。
  • 在 .py 文件右下角确认 “Pylance” 字样即成功。

basedpyright:开源替代方案

虽然上述方法可行,但 Pylance 闭源且采集遥测,社区已经 fork 了 basedpyright:

  • 基于 Pyright,补齐了大量 Pylance 特性。
  • 完全开源、无遥测,活跃维护。
  • 一键安装,免去手动打补丁。

如何安装
直接在 OpenVSX / GitHub Releases 下载 basedpyright.vsix,或通过包管理器 ext install basedpyright.based-pyright。安装后在设置里选择 python.languageServer = basedpyright 即可。


常见问题(FAQ)

问题 解答
升级 Pylance 后又失效? 新版本可能恢复 IDE 校验,重复 Step 2-3 即可。
找不到 extension.bundle.js? 路径因系统、版本不同,请在扩展目录下全局搜索文件名。
想彻底换 basedpyright? 卸载 Pylance,安装 basedpyright,然后把 python.languageServer 指向它。

写在最后

  • 本教程仅供学习与临时过渡。
  • 长期来看,basedpyright + Django 类型存根 才是更自由、更稳妥的选择。
  • 欢迎在评论区交流你的实践经验或踩坑记录!

如果本文对你有帮助,别忘了点赞、收藏与分享!
​

23 个赞

感谢大佬

3 个赞

pass

2 个赞

大佬这边只有service url,而且改完重启完之后还是搜不到pylance啊

1 个赞

是的,搜不到,所以需要最上面说的那样,从vscode下载VSIX文件然后导入到cursor里(如果这个service url不修改,cursor会把导入的扩展变成自己应用市场对应的,自己应用市场没有就直接删除)

明白了,感谢大佬详细教程

1 个赞

cursor + pycharm

1 个赞

pycharm remote ssh感觉不是很好用

感谢大佬,我是cursor禁用前就安装好了pylance,按教程添加了Service Url和修改extension.bundle.js后插件列表里有pylance但仍然提示In order to use Anysphere Python, Ims-python.vscode-pylance must be uninstalled.请问该如何解决?

1 个赞


这个步骤做了吗,就是pylance的代码修要删去一行,注意pylance的版本是2024.8.1

更新的版本修改js也不行吗

1 个赞

更新的版本 我记得cursor就没办法支持了吧

直接下载指定版本的VSIX就行

删除了已经

1 个赞

方便贴出更多信息吗?比如插件列表,cursor版本


1 个赞

In order to use Anysphere Python, Ims-python.vscode-pylance must be uninstalled.

这个需要卸载呢Anysphere Python和microsoft python冲突了呢
pylance依赖microsoft python :rofl:

:joy:可以了 感谢大佬