跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像AI 生图工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Python

Python 与 PyCharm 虚拟环境搭建及实战指南

Python 虚拟环境用于隔离项目依赖,避免版本冲突。涵盖 venv、virtualenv 及 conda 三种搭建方式,详解 PyCharm 中创建与关联环境的步骤,并解决 Windows PowerShell 脚本执行策略报错问题,最后介绍包管理命令,帮助开发者快速构建独立且干净的 Python 开发环境。

编程诗人发布于 2026/3/28更新于 2026/7/2238 浏览
Python 与 PyCharm 虚拟环境搭建及实战指南

什么是虚拟环境

虚拟环境 (Virtual Environment) 是 Python 中用于隔离项目依赖的工具。它允许我们在同一台机器上为不同的 Python 项目创建独立的环境,每个环境可以拥有自己独立的 Python 版本和第三方库。


虚拟环境的作用

  1. 依赖隔离:不同项目可以使用不同版本的库而不会冲突。
  2. 项目独立性:确保项目所需的依赖被明确记录且不会影响系统全局环境。
  3. 便于协作:通过 requirements 文件可以轻松分享项目环境配置。
  4. 避免权限问题:不需要系统管理员权限安装包。
  5. 干净卸载:删除虚拟环境目录即可完全移除所有相关依赖。

如何搭建虚拟环境

首选方案:内置 venv 模块

Python 3.3+ 自带 venv 模块,无需额外安装,是最推荐的方式。

# 创建虚拟环境
python -m venv myenv

# 激活虚拟环境
# Windows: myenv\Scripts\activate
# Linux/Mac:
source myenv/bin/activate

# 停用虚拟环境
deactivate

PyCharm 新建项目界面

备选方案:使用 virtualenv

如果你需要更灵活的控制或兼容旧版 Python,可以使用 virtualenv。

# 安装 virtualenv
pip install virtualenv

# 创建虚拟环境
virtualenv myenv

# 激活/停用命令同上

科学上网用户:使用 conda

适用于 Anaconda 或 Miniconda 用户,特别适合数据科学场景。

# 创建虚拟环境
conda create --name myenv python=3.8

# 激活
conda activate myenv

# 停用
conda deactivate

在 PyCharm 中使用虚拟环境

创建新项目时

新建项目时,直接选择 "New Environment using Virtualenv",指定 Python 解释器位置和虚拟环境位置即可。

PyCharm 新建项目配置

为已有项目添加虚拟环境

如果项目已经存在,可以通过以下步骤关联新环境:

  1. 打开 File > Settings > Project: [项目名] > Python Interpreter。
  2. 点击齿轮图标,选择 Add。
  3. 选择 Virtualenv Environment 并配置路径。

PyCharm 添加解释器

PyCharm 虚拟环境设置

使用已有虚拟环境

在 Python Interpreter 设置中,选择 Existing environment,指向虚拟环境中的 Python 解释器(如 myenv/Scripts/python.exe)。

你也可以先通过命令行 python -m venv myenv 创建好环境,随后在 PyCharm 中直接引用。

PyCharm 引用现有环境

验证是否成功

在 PyCharm 控制台输入命令时,左侧会显示当前虚拟环境的名称,这表示环境已正确激活。

PyCharm 环境激活确认


常见报错:禁止在系统上运行脚本

在 Windows 下执行虚拟环境的脚本命令时,可能会遇到如下报错:

无法加载文件 D:\Coder\Warehouse\python\algorithm_problem\myenv\Scripts\Activate.ps1,因为在此系统上禁止运行脚本。

原因分析

当我们运行 .\myenv\Scripts\Activate.ps1 激活虚拟环境时,PowerShell 会阻止执行 .ps1 脚本。这是因为默认的执行策略是 Restricted(禁止运行任何脚本)。这是 Windows 的安全机制,防止恶意脚本自动运行。

你可以在 Windows 下执行 get-ExecutionPolicy 查看当前策略,通常默认为 Restricted。

PowerShell 执行策略

解决方法

方法 1:临时允许脚本运行(推荐)

仅对当前会话生效,关闭 PowerShell 后恢复默认策略,不影响系统安全。

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
方法 2:永久修改执行策略

如果需要经常运行 .ps1 脚本(如 Python 虚拟环境激活),可全局修改(需管理员权限)。

Set-ExecutionPolicy RemoteSigned -Force
方法 3:改用 CMD 激活虚拟环境

如果不想修改 PowerShell 策略,可以直接用 CMD 激活,CMD 没有脚本执行限制。

D:\Coder\Warehouse\python\algorithm_problem\myenv\Scripts\activate.bat

管理虚拟环境中的包

在虚拟环境中,包管理操作与全局环境一致,但仅限于当前环境生效。

# 安装包
pip install package_name

# 生成 requirements 文件 (记录所有依赖)
pip freeze > requirements.txt

# 根据 requirements 文件安装依赖
pip install -r requirements.txt

虚拟环境是 Python 开发中的最佳实践。一般情况下,出于依赖隔离与项目独立性的考虑,建议为每个项目单独创建虚拟环境。

目录

  1. 什么是虚拟环境
  2. 虚拟环境的作用
  3. 如何搭建虚拟环境
  4. 首选方案:内置 venv 模块
  5. 创建虚拟环境
  6. 激活虚拟环境
  7. Windows: myenv\Scripts\activate
  8. Linux/Mac:
  9. 停用虚拟环境
  10. 备选方案:使用 virtualenv
  11. 安装 virtualenv
  12. 创建虚拟环境
  13. 激活/停用命令同上
  14. 科学上网用户:使用 conda
  15. 创建虚拟环境
  16. 激活
  17. 停用
  18. 在 PyCharm 中使用虚拟环境
  19. 创建新项目时
  20. 为已有项目添加虚拟环境
  21. 使用已有虚拟环境
  22. 验证是否成功
  23. 常见报错:禁止在系统上运行脚本
  24. 原因分析
  25. 解决方法
  26. 方法 1:临时允许脚本运行(推荐)
  27. 方法 2:永久修改执行策略
  28. 方法 3:改用 CMD 激活虚拟环境
  29. 管理虚拟环境中的包
  30. 安装包
  31. 生成 requirements 文件 (记录所有依赖)
  32. 根据 requirements 文件安装依赖
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒,将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • Flutter serial 库在鸿蒙系统的适配指南与串口通信实战
  • Flutter 三方库 shelf_modular 的鸿蒙化适配指南
  • 学术写作合规工具功能分型与协同路径:八类系统解析
  • 前后端共用校验规则方案:后端为最终权威
  • Tokio:Rust 异步运行时核心指南
  • 基于改进 YOLOv8 的美食图像分割系统实战与源码解析
  • 低代码平台分类与价值取向:业务开发者与专业开发者视角
  • 基于城市场景下无人机三维路径规划的导航变量多目标粒子群优化算法 NMOPSO 研究
  • 数据结构:排序算法详解(插入与选择排序)
  • 二分查找算法详解:基础查找与边界定位
  • 深度学习模型训练六大步骤详解:数据预处理到参数优化
  • GitHub Copilot学生认证指南:轻松获取两年免费Copilot Pro
  • 从软件工程视角理解低代码的价值、边界与演进路径
  • AI 聚合系统:支持 nano-banana-2 绘画、VEO3 及 Sora-2 视频生成与 Agent 工作流
  • Proxmox VE 无公网 IP 远程运维方案
  • 35 岁转行 Python 开发:职业转型的机遇与路径
  • 基于飞算 JavaAI 的在线图书借阅平台设计与实现
  • OpenClaw 智能体实战:从零搭建你的第一个 AI 员工
  • 低代码选型指南:AI 与低代码双向赋能企业数字化
  • 程序员转行大模型领域:热门岗位推荐与选择策略

相关免费在线工具

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online