在 VS Code 中创建 Python 虚拟环境是隔离项目依赖的最佳实践,可防止不同项目之间的库冲突。以下是创建步骤的综合指南,基于多个最新来源总结而成。确保已安装 Python(推荐 Python 3.3+)和 VS Code Python 扩展。

1. ‌创建虚拟环境

  • 在项目文件夹中,启动 VS Code 终端(快捷键 Ctrl+Shift+ 或点击菜单栏 Terminal → New Terminal)。
  • 运行以下命令
    python -m venv .venv
    创建虚拟环境(以 .venv 为名,可自定义):
  • 其中:
  • python:调用 Python 解释器(如使用 Python 3,可用 python3)。
  • -m venv:指定内置虚拟环境模块。
  • .venv:虚拟环境文件夹名称,通常创建为隐藏目录。

    2. ‌激活虚拟环境

  • Windows 系统‌:在终端运行:
    .\.venv\Scripts\activate
    激活后,终端提示符前显示 (.venv) 表示成功 。
  • macOS/Linux 系统‌:在终端运行:
source .venv/bin/activate

同样观察提示符变化确认激活 。

3. ‌配置 VS Code 使用虚拟环境

  • 激活虚拟环境后,在 VS Code 中设置 Python 解释器:
    • 打开命令面板(快捷键 Ctrl+Shift+P 或 Cmd+Shift+P)。
    • 输入并选择 Python: Select Interpreter
    • 从列表中选择虚拟环境的解释器(如 .venv\Scripts\python.exe on Windows 或 .venv/bin/python on macOS/Linux) 。
    • VS Code 会自动识别虚拟环境,右下角状态栏显示环境名称 。
    • tips:这里存在选择Select Interpreter后找不到虚拟环境所在目录的情况,需要手动把当前的目录设置为workplace即可

4. ‌可选设置:自动激活虚拟环境

  • 在 VS Code 中,按 Ctrl+, 打开设置,搜索 Python Terminal Activate Env,确保勾选 Python > Terminal: Activate Environment 选项。
  • 此设置使新开终端时自动激活当前虚拟环境
Logo

魔乐社区(Modelers.cn) 是一个中立、公益的人工智能社区,提供人工智能工具、模型、数据的托管、展示与应用协同服务,为人工智能开发及爱好者搭建开放的学习交流平台。社区通过理事会方式运作,由全产业链共同建设、共同运营、共同享有,推动国产AI生态繁荣发展。

更多推荐