新闻中心

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

2025-12-07
浏览次数:
返回列表
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虚拟环境的详细内容,更多请关注其它相关文章!


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


相关栏目: 【 科技资讯46185 】 【 网络学院92790


相关推荐: 必由学网页版入口 必由学官方平台直接访问  Lar*el 递归关系中排除指定分支的教程  夸克浏览器图书入口 夸克手机浏览器阅读入口  MAC怎么让Dock栏只显示当前运行的应用_MAC终端命令实现极简Dock栏  Python模块化编程:有效管理依赖与避免循环引用  Lar*el用户头像管理:实现图片缩放、存储与旧文件安全删除的最佳实践  一加手机拍照效果不好怎么办 一加哈苏影像调校与专业模式使用教程【高手篇】  在J*a中如何开发简易仓库管理与库存统计_仓库管理库存统计项目实战解析  如何使用J*aScript精确选择并批量修改特定父元素下子链接的样式  J*aScript Promise链中如何正确终止后续.then执行并处理错误  sublime如何配置Go语言开发环境_sublime搭建Golang编译运行系统  MAC怎么在地图App里使用“四处看看”_MAC体验部分城市的3D实景街景  优化Log4j2控制台输出性能:解决异步日志瓶颈  Go语言HTML解析:利用Goquery精准获取指定元素内容  理解Python模块与全局变量的作用域管理  Golang如何优雅处理error_Golang error处理最佳实践总结  腾讯QQ邮箱登录入口_QQ邮箱官方网站使用地址  Composer如何处理Git子模块(submodule)依赖_Composer与Git Submodule的对比与选择  聚水潭ERP登录页面入口 聚水潭ERP官网登录界面  苹果手机如何防止被恶意App追踪  BetterDiscord插件中安全更新用户简介的实践指南  解决macOS上安装pyhdf时‘hdf.h’文件缺失的编译错误  手机屏幕碎了但能正常使用怎么办 手机外屏碎裂的修复建议  J*a应用程序首次运行自动创建文件与目录的最佳实践  离线运行Go语言之旅:本地部署与GOPATH配置指南  Angular Material 垂直步进器:实现底部到顶部排序的教程  J*a里如何实现订单支付与库存同步功能_支付库存同步项目开发方法说明  Go语言中的*string:深入理解字符串指针  TikTok搜索结果不显示如何解决 TikTok搜索刷新优化方法  TikTok评论显示延迟如何处理 TikTok评论刷新优化方法  PyTorch模型训练准确率不提升:诊断与修复常见指标计算错误  Win10文件资源管理器“此电脑”分组怎么关 Win10恢复经典视图【技巧】  AO3网页版最新入口合集 Archive of Our Own在线访问指南  拷贝漫画电脑版官网入口 拷贝漫画(PC版)在线直达  CSS Flexbox与媒体查询:实现响应式布局中元素的并排与堆叠  在J*a中如何开发在线活动报名与管理系统_活动报名管理项目实战解析  抖音极速版最新版本 抖音极速版官方下载地址  汽水音乐在线解析 汽水音乐在线解析入口  微信网页版官方入口直达 微信网页版网页版登录使用方法  Excel函数批量查找替换超快方法_Excel用REPLACE和FIND函数秒级替换  漫蛙漫画官方主页入口 漫蛙MANWA网页直达访问链接  sublime如何配置Python开发环境_将sublime打造成轻量级Python IDE  b站怎么取消点赞_b站点赞取消操作方法  12306几点到几点不能订票? | 官方最新系统维护时间全解析  TikTok网页版直接登录 TikTok网页端官方平台入口  J*a实现学校排课程序_面向对象结构化项目示例  PostgreSQL海量数据高效导入策略:Python与Django实践指南  怎么去除衣服上的口红印_生活小妙招教你用酒精轻松擦除  如何在CSS中使用visited与link控制链接颜色_visited link伪类配合  sublime怎么进行远程开发编辑_配置rsub/rmate实现sublime编辑服务器文件 

搜索