讲师中心 微信公众号

工具推荐

视频效率加速
SoundView
SoundView

字幕擦除翻译、配音口型同步

Seko
Seko

AI短剧一键生成成片

AniShort
AniShort

AI短剧协同制作平台

Laper
Laper

剧本策划到成片协作

VS Code 虚拟环境列表缓存清理与实时刷新完整指南

大墨小哥_4548

大墨小哥_4548

发布时间:2026-11-22 12:50:17

|

904人浏览过

|

来源于php中文网

原创

VS Code 虚拟环境列表缓存清理与实时刷新完整指南

VS Code 会缓存已发现的 Python 虚拟环境信息,当手动删除环境后仍残留于解释器列表中时,需清除 environments.json 等缓存文件并刷新扫描,才能让列表准确反映当前系统真实状态。

vs code 会缓存已发现的 python 虚拟环境信息,当手动删除环境后仍残留于解释器列表中时,需清除 environments.json 等缓存文件并刷新扫描,才能让列表准确反映当前系统真实状态。

在 VS Code 中管理 Python 项目时,一个常见却易被忽视的问题是:已物理删除的虚拟环境(如 r-keras、r-tensorflow)依然出现在 Python: Select Interpreter 的候选列表中。这并非 VS Code 故意“记错”,而是其 Python 扩展为提升响应速度,将扫描到的环境元数据(如路径、Python 版本、包列表)持久化缓存至本地存储。若不主动清理,VS Code 不会自动感知磁盘上环境目录的消失。

✅ 正确刷新环境列表的两步法

第一步:强制刷新环境扫描(推荐优先尝试)

无需重启或删文件,先执行轻量级刷新:

  • 按下快捷键 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS)打开命令面板;
  • 输入并选择 Python: Refresh Environments;
  • 等待右下角通知提示“Environments refreshed”(通常 2–5 秒);
  • 再次打开 Python: Select Interpreter,检查旧环境是否已消失。

⚠️ 注意:此操作仅重新扫描当前工作区及其父目录中符合规范的环境(如含 pyvenv.cfg 或 conda-meta/ 的目录)。若已删环境曾位于非标准路径(如用户主目录下孤立的 ~/envs/r-keras),可能仍残留——此时需进入第二步。

第二步:手动清除全局环境缓存(彻底解决)

当刷新无效时,说明缓存已“固化”。VS Code 的 Python 扩展将环境清单统一存于以下位置:

VS Code Node
VS Code Node

通过作为 OpenClaw 节点连接的 VS Code/Cursor IDE 操作代码,提供 40 多种命令,涵盖文件操作、语言智能、Git、测试等功能。

下载
系统 缓存路径
Windows C:\Users\<em><yourusername></yourusername></em>\AppData\Roaming\Code\User\globalStorage\ms-python.python\
macOS ~/Library/Application Support/Code/User/globalStorage/ms-python.python/
Linux ~/.config/Code/User/globalStorage/ms-python.python/

✅ 操作步骤:

  1. 完全退出 VS Code(确保后台进程已终止);
  2. 进入对应路径,定位并删除以下关键缓存文件:
    environments.json      # 主环境索引(必删)
    interpreterInfo.json   # 解释器详细信息(建议一并删除)
    # (其他以 timestamp 命名的 .json 文件可选删,非必需)
  3. 重新启动 VS Code;
  4. 再次执行 Python: Refresh Environments —— 此时列表将基于全新扫描生成,已删除环境将彻底消失。

? 额外技巧:预防缓存污染

  • 避免跨项目混用环境路径:不要将虚拟环境创建在项目根目录之外(如统一放在 ~/venvs/),否则 VS Code 可能反复扫描并缓存大量废弃路径;
  • 使用标准命名约定:优先采用 .venv(项目级)或 env,VS Code 对此类名称识别率最高;
  • 启用官方新扩展(推荐):安装微软推出的 Python Environments 扩展(需在 settings.json 中启用 "python.useEnvironmentsExtension": true),它提供图形化环境管理面板,并支持一键“Remove Environment”从缓存中移除条目,无需手动删文件。

? 验证是否成功

完成上述任一方法后,可通过以下方式交叉验证:

  • 底部状态栏点击 Python 版本 → 查看列表是否干净;
  • 在命令面板运行 Python: Show All Environments(部分版本支持);
  • 新建终端(Terminal > New Terminal),运行:
    python -c "import sys; print(sys.executable)"

    输出路径应严格匹配你当前选中的环境,且该路径在文件系统中真实存在。

? 总结:VS Code 的环境列表不是“实时文件系统视图”,而是带缓存的智能索引。刷新(Refresh)是日常维护首选,清缓存(Clear Cache)是根治残留的终极手段。掌握二者组合使用,即可始终确保你的解释器选择精准、可靠、无干扰。

热门AI工具

更多
Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
Navicat创建数据库教程
Navicat创建数据库教程

本专题整理Navicat创建数据库相关教程,介绍新建前的准备、基础设置和创建后的检查方法。内容兼顾入门学习及实际使用需求,帮助用户了解不同数据库类型下的操作差异,为后续建表、保存数据和日常管理提供参考。

20

2026.11.20

Navicat入门教程大全
Navicat入门教程大全

本专题整理Navicat入门教程,从认识软件界面到开展数据库操作,介绍初次使用需要了解的知识和方法。内容兼顾连接配置、数据管理及日常使用中的疑问,方便用户按学习进度查阅,为后续实践和独立操作打好基础。

20

2026.11.20

Navicat数据库连接配置指南
Navicat数据库连接配置指南

从确认数据库信息到建立可用连接,本专题串联Navicat连接数据库的相关知识和操作方法。既有初次配置时需要了解的基础内容,也有连接后的检查思路,方便用户按实际需求查阅教程,逐步熟悉数据库连接的设置流程。

0

2026.11.20

PHP8.6数组与数据处理教程
PHP8.6数组与数据处理教程

本专题汇总PHP8.6数组与数据处理教程,涵盖CSV读取和导出、引用遍历删除、array_filter回调模式、配置键名冲突、pathinfo文件名校验、GMP大整数进制转换及UTF-8正则筛选,说明升级兼容变化、输入范围和失败处理方法。

60

2026.11.20

PHP8.6升级迁移教程
PHP8.6升级迁移教程

本专题汇总PHP8.6升级迁移与弃用接口改造教程,涵盖反射调用、对象属性赋值、标识符更名、构造函数与__debugInfo调整,以及插件类名检查、常量导出、ArrayIterator排序、SPL和DTO查询参数转换,帮助梳理弃用提示并完成代码兼容改造。

0

2026.11.20

PHP8.6安装配置与FPM运维教程
PHP8.6安装配置与FPM运维教程

本专题汇总PHP8.6正式版安装部署与FPM运维教程,涵盖Linux并存安装、独立ini配置、扩展重新编译、Nginx切换与回滚、FPM状态监控和慢日志排查,以及环境变量、请求超时、OPcache刷新和预加载配置。

40

2026.11.20

Nginx CVE-2026-123007排查与防护指南
Nginx CVE-2026-123007排查与防护指南

Nginx HTTP/2漏洞该怎么修复?本专题围绕CVE-2026-123007,介绍安全版本升级、模块兼容检查和配置恢复方法,以及日志排查、权限设置等后续加固操作,方便你按实际部署情况查找对应教程。

40

2026.11.20

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

80

2026.11.17

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

100

2026.11.17

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn