1. 虚拟环境路径包含中文、空格或特殊符号

VSCode 对中文路径支持不好，会识别失败。

→ 项目文件夹必须全英文、无空格。

2. 没选中正确的解释器（只选了文件夹，没选 python.exe）

虚拟环境真正的解释器是：

- Windows： .venv\Scripts\python.exe 

- Mac/Linux： .venv/bin/python 

只选  .venv  文件夹是无效的。

3. VSCode 没有加载出新创建的 venv

刚创建完虚拟环境，VSCode 缓存没刷新，列表里不显示。

→ 重启 VSCode 即可。

4. VSCode Python 插件未安装或失效

没有官方 Python 插件，就无法切换解释器。

→ 安装插件： ms-python.python 。

5. 系统权限问题 / 虚拟环境损坏

文件夹被锁定、权限不足，或创建时出错导致 venv 不完整。

→ 删除  .venv  重新创建。

6. 终端激活的环境与VSCode选中的环境不一致

右下角显示对了，但终端还是旧环境。

→ 关闭终端重新打开，或手动  deactivate  再激活。

7. 多个Python版本冲突（系统Python vs 安装版Python）

电脑装了多个Python，VSCode 识别混乱。

→ 手动输入路径指定解释器。

8. .venv 被设置为排除文件夹

settings.json 里如果把  .venv  排除搜索，解释器也会找不到。