PyCharm显示配置venv不等于真正使用——需右键项目根目录设为Sources Root、.venv文件夹设为Excluded，再验证python和pip是否同属venv路径，且sys.path包含venv的site-packages，否则import仍会失败。
确认 PyCharm 是否真正在用这个 venv
PyCharm 显示已配置 venv，不代表它当前在用——常见情况是解释器路径设对了，但项目根目录没识别为源码根（Sources Root），或 .venv 文件夹没被排除，导致索引混乱。
检查方法：右键点击项目根目录 → “Mark Directory as” → 确保 “Sources Root” 已勾选；再右键 .venv 文件夹 → “Mark Directory as” → “Excluded”。这时 .venv 应变成黄色高亮，PyCharm 才会停止索引它内部的 .pyc 和 site-packages，转而信任解释器本身的包路径。
如果跳过这步，PyCharm 可能一边从 venv 里加载运行时模块，一边又在 .venv 目录下做静态分析，结果 import 提示失效、Alt+Enter 没反应。
激活后仍 import 失败？先验证解释器和 pip 是不是一对
终端激活 .venv 后，必须确认 python 和 pip 指向同一环境，否则容易装到错地方：
立即学习“Python免费学习笔记（深入）”；
-
python -c "import sys; print(sys.executable)"—— 输出应含.venv路径 -
pip show requests（换你实际装的包名）—— 若报错“Package not found”，说明 pip 没走 venv 的 pip - 若 pip 不匹配，强制用
python -m pip install requests，避免系统 pip 干扰
Windows 用户尤其注意：PowerShell 默认禁用脚本执行，.venv\Scripts\Activate.ps1 可能静默失败。改用 .venv\Scripts\activate.bat，或临时运行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser。
sys.path 里没有 site-packages？检查 PYTHONPATH 是否污染
即使 venv 激活成功，若设置了全局 PYTHONPATH，Python 会优先查那个路径，可能跳过 venv 的 site-packages，甚至导入旧版冲突包。
调用 Cutout.Pro 视觉处理 API 进行背景移除、人像抠图和照片增强，支持文件上传与图片 URL 输入。
临时清除干扰：
- Linux/macOS：
unset PYTHONPATH && python -c "import sys; print('\n'.join(sys.path))" - Windows：
set PYTHONPATH=&& python -c "import sys; print('\n'.join(sys.path))"
看输出中是否包含类似 .venv/lib/python3.x/site-packages 的路径。如果没有，说明环境变量或 .pth 文件劫持了搜索顺序。
“No module named X” 和 “cannot import name Y” 要分开看
前者大概率是路径或安装问题；后者说明模块存在，但导出结构变了——比如你 from requests import Session 报错，但 import requests 成功，就该立刻跑：
python -c "import requests; print(requests.__version__, requests.__file__)"
输出的 __file__ 路径必须落在 .venv 内。如果指向 /usr/local/lib/... 或用户级 site-packages，说明 pip 安装时没走 venv，或者有 ~/.local/bin/pip 覆盖了命令。
这种细节不手动验证，只靠“我明明 pip install 过”来判断，十次有九次卡在路径误判上。
