讲师中心 微信公众号
AI工具推荐 视频效率加速

如何解决 VS Code 中 PIL/Pillow 导入无法解析的问题

大辰姑娘_7670

大辰姑娘_7670

发布时间:2025-12-31 14:17:02

|

274人浏览过

|

来源于php中文网

原创

如何解决 VS Code 中 PIL/Pillow 导入无法解析的问题

vs code 报错“import 'pil' could not be resolved”通常并非 pillow 未安装,而是 python 解释器配置错误或语言服务器缓存未更新;本文提供完整排查路径,涵盖解释器选择、环境验证、重启策略及重装建议。

在 VS Code 中使用 from PIL import Image 时出现 “Import 'PIL' could not be resolved from source” 提示,并不代表 Pillow 没有安装成功(如你已确认 pip install Pillow 返回 Requirement already satisfied),而更大概率是 VS Code 的 Python 扩展未能正确识别当前激活的 Python 环境。以下是系统性解决步骤:

✅ 第一步:确认当前 Python 解释器是否匹配安装环境

Pillow 安装在哪个 Python 环境中,VS Code 就必须使用同一个解释器。请按以下操作验证并切换:

  1. 在 VS Code 中按下 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),打开命令面板;
  2. 输入并选择 Python: Select Interpreter;
  3. 在弹出列表中,手动选择与你执行 pip install Pillow 时所用的 Python 可执行文件一致的路径(例如:C:\Users\Jason\AppData\Local\Programs\Python\Python310\python.exe 或 Windows 应用商店 Python 的实际路径);
    ⚠️ 注意:你当前使用的 python --version 输出为 3.10.11,但 Windows 应用商店安装的 Python 默认路径常为 AppData\Local\Packages\PythonSoftwareFoundation... —— 请务必在解释器列表中找到该路径,而非默认的 python.exe(可能指向其他环境)。

✅ 第二步:验证 Pillow 是否真正在该环境中可用

在 VS Code 内置终端(确保终端已加载正确解释器)中运行:

python -c "from PIL import Image; print(Image.__version__)"

✅ 若输出类似 10.2.0,说明 Pillow 已正确安装且可导入;
❌ 若报 ModuleNotFoundError,说明 Pillow 未安装在此解释器环境中,请运行:

python -m pip install --upgrade pillow

? 使用 python -m pip 而非裸 pip,可确保调用的是当前解释器关联的 pip,避免多环境混淆。

✅ 第三步:强制刷新 VS Code Python 语言服务

即使解释器已正确配置,Pylance(VS Code 默认 Python 语言服务器)有时会缓存旧状态:

Windows-Android_SSH_Remote_Control
Windows-Android_SSH_Remote_Control

通过 SSH 隧道从 Android 设备在互联网上对 Windows PC 实现完整远程控制的设置与使用指南,适用于远程桌面访问、安全 RDP 等。

下载
  • 保存所有文件 → 关闭 VS Code 完全退出(包括后台进程)→ 重新打开项目;
  • 或在命令面板中执行 Developer: Restart Language Server;
  • 还可尝试清除 Pylance 缓存:删除 VS Code 设置中 python.languageServer 对应的缓存目录(一般位于 %USERPROFILE%\AppData\Roaming\Code\Cache\pil 类似路径,但更推荐重启方式)。

✅ 第四步:终极方案 —— 清理重装(仅当上述无效时)

若仍不识别,请彻底卸载并重建:

# 在正确解释器的终端中执行
python -m pip uninstall Pillow -y
python -m pip install --no-cache-dir Pillow

? 补充提示:Pillow 是 PIL 的现代替代库,import PIL 实际导入的是 Pillow 包(其内部兼容 PIL 命名空间),因此无需安装旧版 PIL(已废弃且不兼容 Python 3.10+)。

✅ 验证代码示例(可直接测试)

创建一个 test_pil.py 文件:

from PIL import Image
import io

# 创建一个简单图像验证导入成功
img = Image.new("RGB", (100, 100), color="blue")
print("✅ PIL imported successfully. Image size:", img.size)

运行后若打印成功信息,即证明环境与 VS Code 配置均已就绪。

总结:95% 的此类问题源于 VS Code 未绑定到 Pillow 所在的 Python 环境。请始终优先检查解释器路径一致性,并配合重启语言服务。切勿仅依赖“pip 安装成功”的直觉判断——VS Code 的 Python 扩展具有独立的环境感知逻辑。

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

相关专题

更多
pip安装使用方法
pip安装使用方法

安装步骤:1、确保Python已经正确安装在您的计算机上;2、下载“get-pip.py”脚本;3、按下Win + R键,然后输入cmd并按下Enter键来打开命令行窗口;4、在命令行窗口中,使用cd命令切换到“get-pip.py”所在的目录;5、执行安装命令;6、验证安装结果即可。大家可以访问本专题下的文章,了解pip安装使用方法的更多内容。

3150

2023.10.09

更新pip版本
更新pip版本

更新pip版本方法有使用pip自身更新、使用操作系统自带的包管理工具、使用python包管理工具、手动安装最新版本。想了解更多相关的内容,请阅读专题下面的文章。

7183

2024.12.20

pip设置清华源
pip设置清华源

设置方法:1、打开终端或命令提示符窗口;2、运行“touch ~/.pip/pip.conf”命令创建一个名为pip的配置文件;3、打开pip.conf文件,然后添加“[global];index-url = https://pypi.tuna.tsinghua.edu.cn/simple”内容,这将把pip的镜像源设置为清华大学的镜像源;4、保存并关闭文件即可。

8822

2024.12.23

python升级pip
python升级pip

本专题整合了python升级pip相关教程,阅读下面的文章了解更多详细内容。

4527

2025.07.23

windows查看端口占用情况
windows查看端口占用情况

Windows端口可以认为是计算机与外界通讯交流的出入口。逻辑意义上的端口一般是指TCP/IP协议中的端口,端口号的范围从0到65535,比如用于浏览网页服务的80端口,用于FTP服务的21端口等等。怎么查看windows端口占用情况呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

3279

2023.07.26

查看端口占用情况windows
查看端口占用情况windows

端口占用是指与端口关联的软件占用端口而使得其他应用程序无法使用这些端口,端口占用问题是计算机系统编程领域的一个常见问题,端口占用的根本原因可能是操作系统的一些错误,服务器也可能会出现端口占用问题。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2858

2023.07.27

windows照片无法显示
windows照片无法显示

当我们尝试打开一张图片时,可能会出现一个错误提示,提示说"Windows照片查看器无法显示此图片,因为计算机上的可用内存不足",本专题为大家提供windows照片无法显示相关的文章,帮助大家解决该问题。

1508

2023.08.01

windows查看端口被占用的情况
windows查看端口被占用的情况

windows查看端口被占用的情况的方法:1、使用Windows自带的资源监视器;2、使用命令提示符查看端口信息;3、使用任务管理器查看占用端口的进程。本专题为大家提供windows查看端口被占用的情况的相关的文章、下载、课程内容,供大家免费下载体验。

2619

2023.08.02

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

40

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn