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 -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，甚至导入旧版冲突包。

A Python CLI skill for Cutout.Pro visual APIs — background removal, face cutout, and photo enhancement. Supports file upload & image URL input.

调用 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 过”来判断，十次有九次卡在路径误判上。

Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！