vscode不会自动识别项目里的.venv或venv文件夹,必须手动指定解释器路径;选中后终端仍用系统python,因python.terminal.activateenvironment未设为true,且需以文件夹方式打开项目。

VSCode不会自动识别项目里的.venv或venv文件夹,必须手动指定解释器路径,否则补全、调试、pip install全都会用错环境。
为什么选了解释器,终端还是用系统Python?
VSCode集成终端默认不激活虚拟环境,即使状态栏显示(.venv),新开终端仍走系统PATH。这不是配置失败,而是功能开关没打开。
-
python.terminal.activateEnvironment必须设为true(在.vscode/settings.json里加) - Windows用户若用了PowerShell,还要检查
python.terminal.launchArgs是否被覆盖——清空它,别留["-NoExit", "-Command", ""] - 改完设置后,关掉所有终端再新开一个,看提示符前是否出现
(.venv)
解释器路径填相对路径还是绝对路径?
必须填相对于工作区根目录的相对路径,否则换电脑或共享项目时立刻失效。
- macOS/Linux:写
"./.venv/bin/python",不是/Users/xxx/project/.venv/bin/python - Windows:写
".\.venv\Scripts\python.exe",注意双反斜杠或正斜杠都行,但不能是C:...python.exe - 路径错误典型表现:
Python interpreter not found或选完后状态栏不更新
用python -m venv还是virtualenv?
优先用python -m venv .venv,VSCode Python扩展对标准库venv模块兼容最稳;第三方工具容易在Windows上触发ModuleNotFoundError: No module named 'venv'。
- 创建前确认Python ≥ 3.3(
python --version) - 别在C盘根目录或含空格路径下运行命令,权限和Shell初始化问题高发
- 创建完立刻在VSCode里执行
Python: Select Interpreter,别等装完包再选——否则可能误选系统Python
WSL2里怎么找conda环境的解释器路径?
VSCode不扫描conda环境,必须手动填绝对路径,而且得填到python可执行文件本身,不是环境目录。
- 先在WSL里运行
conda env list,抄“Path”列那一行完整路径 - Windows端VSCode连WSL时,路径要转成
wsl$Ubuntuhomeuserminiconda3envsmyenvinpython格式 - 千万别用
conda activate myenv && which python的结果——那个路径常带shell wrapper,VSCode调不动
最常被忽略的一点:VSCode必须以“文件夹”方式打开项目(File → Open Folder),如果只是双击.py文件启动,Python扩展根本不会加载,Python: Select Interpreter选项压根不出现。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











