学习Python：VS Code中已安装pdfkit仍报‘No module named’错误求助

核心原因 #

你遇到的问题本质是VS Code运行代码使用的虚拟环境（.venv）与执行pip install的全局Python环境相互隔离。从报错信息看，pdfkit被安装到了全局Python 3.11的站点包目录，但你的代码是在项目专属的虚拟环境中运行的，两个环境相互独立，因此虚拟环境无法识别全局安装的模块。

具体解决步骤 #

• 在虚拟环境内安装模块
  打开VS Code终端，确认终端已激活项目的虚拟环境（终端前缀会显示.venv），执行以下命令：

  pip install pdfkit
  

  若终端未激活虚拟环境，手动激活：

  # Windows PowerShell环境下
  .\.venv\Scripts\Activate.ps1
  

  激活完成后再执行安装命令即可。

• 指定VS Code的Python解释器

  1. 按下Ctrl+Shift+P打开命令面板
  2. 输入并选择Python: Select Interpreter
  3. 选中项目目录下.venv文件夹内的Python解释器（路径示例：c:\Users\atfle\Documents\VSCode Files\Python Strategies\.venv\Scripts\python.exe）

• 避免错误操作
  不要将模块路径添加到系统环境变量PATH中，虚拟环境本身会隔离全局包，这种操作不仅无效，还可能导致多环境包路径冲突，引发更多问题。

稳定模块调用的规范 #

• 安装/更新模块时，始终确保终端已激活当前项目的虚拟环境
• 每次打开项目后，确认VS Code使用的是当前虚拟环境的Python解释器
• 优先使用python -m pip代替直接使用pip，避免因多Python版本导致的pip调用混乱：

  python -m pip install pdfkit
  

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