VSCode中Black Formatter与Pylint扩展初始化失败：ModuleNotFoundError

环境与现象 #

• 系统：Windows 10
• VSCode版本：1.81.1
• Python版本：3.10（嵌入式压缩包安装）
• 问题：安装Black Formatter（ms-python.black-formatter-2023.4.1）和Pylint扩展后，服务无法完成初始化，抛出错误：

2023-08-18 15:25:55.613 [info] Traceback (most recent call last):
File "c:\Users\djames.vscode\extensions\ms-python.black-formatter-2023.4.1\bundled\tool\lsp_server.py", line 38, in
import lsp_jsonrpc as jsonrpc
ModuleNotFoundError: No module named 'lsp_jsonrpc'

已执行操作 #

• VSCode配置文件指定Python解释器路径：

  "python.defaultInterpreterPath": "C:\\Users\\djames\\Devel\\Python\\Python310\\python.exe",
  

• 通过指定解释器安装模块：

  python -m pip install python-lsp_jsonrpc
  

• 模块安装成功，但问题仍未解决

解决方案 #

1. 修复嵌入式Python的site-packages加载问题 #

嵌入式Python默认不会自动将site-packages目录加入sys.path，需手动配置：

• 在Python310安装目录（C:\Users\djames\Devel\Python\Python310）下新建pyvenv.cfg文件
• 文件内容写入：

  include-system-site-packages = true
  

• 保存后重启VSCode

2. 为扩展单独指定Python解释器 #

在VSCode的settings.json中，为两个扩展明确指定使用的Python路径，避免扩展使用默认环境：

"black-formatter.interpreter": ["C:\\Users\\djames\\Devel\\Python\\Python310\\python.exe"],
"pylint.interpreter": ["C:\\Users\\djames\\Devel\\Python\\Python310\\python.exe"]

3. 清理扩展缓存并重新安装 #

• 卸载Black Formatter和Pylint扩展
• 关闭VSCode，删除以下目录的残留文件：
  • C:\Users\djames\.vscode\extensions\ms-python.black-formatter-*
  • C:\Users\djames\.vscode\extensions\ms-python.pylint-*
• 重新打开VSCode，重新安装两个扩展，重启后测试

4. 临时手动复制模块（应急方案） #

找到python-lsp_jsonrpc的安装目录（一般在C:\Users\djames\Devel\Python\Python310\Lib\site-packages\lsp_jsonrpc），将整个lsp_jsonrpc文件夹复制到：

• Black Formatter的工具目录：c:\Users\djames\.vscode\extensions\ms-python.black-formatter-2023.4.1\bundled\tool
• Pylint的对应工具目录（类似路径）

内容的提问来源于stack exchange，提问作者DJames