VSCode中必须正确绑定Python解释器才能真正激活虚拟环境。右下角显示路径需指向.venv,通过Ctrl+Shift+P选择对应解释器,配置Python: Terminal Execute In File Dir并验证sys.executable路径一致,且将相对路径的"python.defaultInterpreterPath"写入.git可提交的.settings.json中。

VSCode里选对解释器才是激活的前提
很多人以为在终端里运行 source .venv/bin/activate 就算“激活”了,其实 VSCode 并不认这个——它只看你当前绑定的是哪个 python 解释器。右下角状态栏显示的路径没指向 .venv,那所有操作(包括 pip install、调试、运行)都还在系统 Python 里。
实操建议:
立即学习“Python免费学习笔记(深入)”;
inference.sh 的 Python SDK:运行 AI 应用、构建智能体,并集成 150 多个模型。包名:inferencesh (pip install inferencesh)。支持同步/异步……
- 先确认项目根目录下确实有
.venv文件夹(不是venv或env) - 按
Ctrl+Shift+P(macOS 是Cmd+Shift+P),输入Python: Select Interpreter,从列表里选带.venv字样的路径 - Windows 用户注意路径是
.\.venv\Scripts\python.exe,macOS/Linux 是./.venv/bin/python - 如果列表为空,点
Enter interpreter path...手动导航选择;别信“自动检测”,它常漏掉隐藏文件夹
终端不自动带括号?检查 VSCode 的终端行为设置
选了解释器后,新打开的集成终端应该自动激活并显示 (.venv) 前缀。如果没有,不是环境坏了,而是 VSCode 没配置终端自动执行激活脚本。
实操建议:
立即学习“Python免费学习笔记(深入)”;
- 打开设置(
Ctrl+,),搜Python: Terminal Execute In File Dir,勾选它 - 再搜
Python: Default Interpreter Path,确认值和你刚选的一致(比如"./.venv/bin/python") - 关掉所有终端标签页,重新用
Ctrl+Shift+`开一个——这次应该带括号了 - 若仍失败,Windows PowerShell 用户可能需先运行
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser授权脚本执行
验证是否真在 venv 里:别只看 pip list
pip list 显示一堆包,不代表你在用 venv 的 Python。常见错误是终端里 pip 路径对了,但 VSCode 运行按钮或调试器调用的还是系统解释器。
实操建议:
立即学习“Python免费学习笔记(深入)”;
- 新建
test.py,写import sys; print(sys.executable),运行它——输出必须是.venv下的路径 - 在 VSCode 终端里分别运行
which python和which pip(macOS/Linux)或where python和where pip(Windows),两个路径前缀必须完全一致 - 如果
pip install成功但代码报ModuleNotFoundError,八成是没走对解释器,优先查sys.executable
工作区设置要提交,别只靠手动选一次
你手动选了解释器,VSCode 会在 .vscode/settings.json 里加一行 "python.defaultInterpreterPath"。但这只是本地设置,不提交到 Git,别人 clone 项目后还得重选一遍,且容易选错。
实操建议:
立即学习“Python免费学习笔记(深入)”;
- 把
.vscode/settings.json加进版本管理(别忽略它) - 路径写相对的,比如
"./.venv/bin/python",而不是绝对路径/home/user/project/.venv/bin/python - 团队协作时,统一用
.venv名称,避免有人建venv、有人建env导致路径不一致 - 如果项目已存在
.vscode但没这行配置,删掉整个.vscode文件夹,再重新选一次解释器生成干净配置
.vscode/settings.json 那行配置,才是让整个编辑器“认准”这个 venv 的唯一依据。

















