首页 关于我们 成功案例 网络营销 电商设计 新闻中心 联系方式
QQ联系
电话联系
手机联系

在VSCode中正确配置和使用Python虚拟环境

发布时间:2025-12-07 07:29
发布者:网络
浏览次数:
VSCode中正确配置Python虚拟环境需三步:一是在项目根目录运行python -m venv .venv创建环境;二是通过命令面板选择对应解释器路径并确认状态栏显示;三是配置终端自动激活,验证sys.executable路径含.venv且pip list仅显示基础包。

在vscode中正确配置和使用python虚拟环境

在 VSCode 中正确配置 Python 虚拟环境,关键不是“创建完就完事”,而是让编辑器真正识别、激活并持续使用它——包括解释器选择、终端自动激活、以及避免常见路径和权限陷阱。

创建虚拟环境要指定明确路径

不要依赖默认位置(比如项目根目录下无名的 venv),容易混淆或被误删。推荐统一放在项目内的 .venv 文件夹:

  • 终端中运行:python -m venv .venv(Windows/macOS/Linux 均适用)
  • 确保当前目录是你的项目根目录,.venv 会自动创建且被 VSCode 默认忽略(因以点开头)
  • 如果提示“找不到 python 命令”,说明系统没配好 Python 路径,先运行 where python(Win)或 which python3(macOS/Linux)确认可执行文件位置

手动指定 VSCode 使用的 Python 解释器

VSCode 不会自动切换到你刚建的虚拟环境,必须手动选一次,之后才生效:

  • 快捷键 Ctrl+Shift+P(Win/Linux)或 Cmd+Shift+P(macOS),输入 Python: Select Interpreter
  • 在列表中找到类似 ./.venv/bin/python(macOS/Linux)或 .\.venv\Scripts\python.exe(Windows)的路径并选择
  • 状态栏左下角会显示当前解释器路径,确认它指向 .venv 内部
  • 选完后,VSCode 会自动在工作区生成 .vscode/settings.json,写入 "python.defaultInterpreterPath",这是项目级配置,团队协作时建议提交该文件

让集成终端自动激活虚拟环境

否则每次打开新终端都要手动运行 source .venv/bin/activate(macOS/Linux)或 .venv\Scripts\activate(Windows),很麻烦:

简小派 简小派

简小派是一款AI原生求职工具,通过简历优化、岗位匹配、项目生成、模拟面试与智能投递,全链路提升求职成功率,帮助普通人更快拿到更好的 offer。

简小派 123 查看详情 简小派
  • 打开设置(Ctrl+,),搜索 Python: Terminal Execute In File Dir,勾选它
  • 再搜索 Python: Default Interpreter Path,确认值与上面选的一致
  • 更关键的是:在用户或工作区设置中添加:
    "python.terminal.launchArgs": ["-WorkingDirectory", "${workspaceFolder}"](仅 Windows PowerShell 用户需额外配置)
  • 重启终端(Ctrl+Shift+` 关闭再打开),应该看到提示符前带 (.venv),表示已激活

验证是否真正生效

别只看状态栏,实际测一下最可靠:

  • 新建一个 test.py,写 import sys; print(sys.executable),运行它——输出路径应包含 .venv
  • 在集成终端中运行 pip list,只看到基础包(如 pip、setuptools),没有全局安装的第三方库
  • pip install requests 安装一个包,再在 Python 文件中 import requests,不报错即成功
  • 如果仍提示 ModuleNotFoundError,大概率是解释器没选对,或终端没激活,回头检查前两步

基本上就这些。不复杂但容易忽略细节——尤其是解释器选择和终端激活这两步,缺一不可。

以上就是在VSCode中正确配置和使用Python虚拟环境的详细内容,更多请关注其它相关文章!


# linux  # python  # vscode  # js  # json  # windows  # mac  # macos  # win  # 虚拟环境  # cos  # 让你  # 鼠标  # 状态栏  # 两步  # 的是  # 这是  # 是在  # 专注于  # 放在  # 尤其是  # 太原网站建设公司流程  # seo全套网站优化教程  # 嵩明网站建设运营招聘  # 三只松鼠的营销推广  # 商业图库网站怎么建设好  # 阜宁seo优化价格优惠  # 徐州网络推广seo  # 网站营销推广葳杏hfqjwl  # 微网站建设流程  # 厦门网站构建建设