Python虚拟环境配置完全指南 - 从零开始的环境搭建之路

最新推荐文章于 2025-03-11 09:50:58 发布

逐星101

最新推荐文章于 2025-03-11 09:50:58 发布

阅读量4.1k

点赞数 27

分类专栏： Python 文章标签： python 开发语言

本文链接：https://blog.csdn.net/qq_41791705/article/details/145488958

版权

Python 专栏收录该内容

6 篇文章

订阅专栏

前言

作为一名Python新手，第一次接触虚拟环境可能会觉得有点懵。不同的项目需要不同版本的Python和依赖包，如何优雅地管理这些环境呢？本文将从零开始，手把手教你配置Python虚拟环境。

为什么需要虚拟环境？

想象一下这个场景：

项目A需要Django 2.2
项目B需要Django 3.0
项目C需要Django 4.0

如果把所有包都装在系统Python环境下，这些不同版本的包就会互相冲突。虚拟环境就是为了解决这个问题而生的，它可以为每个项目创建独立的Python环境。

第一部分：安装Python

Windows系统

访问Python官网下载安装包：https://www.python.org/downloads/
下载最新版本的Python安装包（建议选择Python 3.8以上版本）
运行安装包，重要的是要勾选"Add Python to PATH"选项
打开命令提示符（CMD），输入以下命令验证安装：

python --version
pip --version

常见问题1：Python未添加到环境变量

如果出现"python不是内部或外部命令"，需要手动添加环境变量：

右键"此电脑" -> 属性 -> 高级系统设置 -> 环境变量
在"系统变量"中找到PATH
添加Python安装路径（通常是C:\Users\用户名\AppData\Local\Programs\Python\Python3x）
添加Python Scripts路径（通常是C:\Users\用户名\AppData\Local\Programs\Python\Python3x\Scripts）

第二部分：创建虚拟环境

方法一：使用venv（推荐）

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

# Windows激活虚拟环境
myenv\Scripts\activate

# Linux/Mac激活虚拟环境
source myenv/bin/activate

# 查看是否激活成功（此时命令提示符前应该有(myenv)标识）
pip list

常见问题2：激活脚本无法运行

在Windows上可能遇到"在此系统上禁止运行脚本"的错误，解决方法：

以管理员身份运行PowerShell
执行以下命令：

Set-ExecutionPolicy RemoteSigned

方法二：使用Anaconda（适合数据科学）

# 安装Anaconda后创建环境
conda create --name myenv python=3.8

# 激活环境
conda activate myenv

# 查看已安装的包
conda list

第三部分：管理项目依赖

安装项目依赖

# 安装单个包
pip install requests

# 安装指定版本
pip install requests==2.25.1

# 从requirements.txt安装依赖
pip install -r requirements.txt

生成requirements.txt

# 导出当前环境的所有依赖
pip freeze > requirements.txt

常见问题3：依赖安装失败

conda create -n asr python=3.9

Channels:
 - https://mirrors.ustc.edu.cn/anaconda/cloud/menpo
 - https://mirrors.ustc.edu.cn/anaconda/cloud/bioconda
 - https://mirrors.ustc.edu.cn/anaconda/cloud/msys2
 - https://mirrors.ustc.edu.cn/anaconda/cloud/conda-forge
 - https://mirrors.ustc.edu.cn/anaconda/pkgs/main
 - https://mirrors.ustc.edu.cn/anaconda/pkgs/free
 - https://mirrors.aliyun.com/anaconda/pkgs/main
 - https://mirrors.aliyun.com/anaconda/pkgs/free
 - https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/pytorch
 - https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge
 - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free
 - defaults
Platform: win-64
Collecting package metadata (repodata.json): \ Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'NewConnectionError('<urllib3.connection.HTTPSConnection object at 0x000001DDDAAEED50>: Failed to establish a new connection: [WinError 10061] 由于目标计算机积极拒绝，无法连接。')': /anaconda/pkgs/free/noarch/repodata.json

| Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'NewConnectionError('<urllib3.connection.HTTPSConnection object at 0x000001DDDBB00C20>: Failed to establish a new connection: [WinError 10061] 由于目标计算机积极拒绝，无法 连接。')': /anaconda/pkgs/free/win-64/repodata.json

在这里插入图片描述

如果pip安装包时报错，可以尝试以下解决方案：

更换pip源（推荐使用清华源）：

# 临时使用
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple some-package

# 永久设置
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

配置Conda镜像源（可选，但推荐，加快下载速度）


bash
CopyInsert
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/
conda config --set show_channel_urls yes

升级pip：

python -m pip install --upgrade pip

第四部分：已有项目的环境配置

步骤1：克隆项目

git clone https://github.com/username/project.git
cd project

步骤2：创建并激活虚拟环境

python -m venv venv
venv\Scripts\activate  # Windows
source venv/bin/activate  # Linux/Mac

步骤3：安装依赖

pip install -r requirements.txt

常见问题4：requirements.txt不完整

有时候clone下来的项目可能没有requirements.txt或文件不完整，解决方法：

运行项目，看缺少什么包
根据错误提示手动安装：

pip install missing-package

安装完成后更新requirements.txt：

pip freeze > requirements.txt

第五部分：已有项目的环境配置

最佳实践建议

项目结构建议：

project/
├── venv/              # 虚拟环境文件夹
├── requirements.txt   # 项目依赖
├── src/              # 源代码
└── README.md         # 项目说明

.gitignore配置：

venv/
*.pyc
__pycache__/

虚拟环境使用规范：

每个项目使用独立的虚拟环境
激活环境后再安装依赖
定期更新requirements.txt
不要把虚拟环境文件夹提交到代码仓库

故障排除清单

包安装失败：

检查网络连接
尝试更换pip源
查看包是否与Python版本兼容
检查是否有依赖冲突

虚拟环境无法激活：

确认是否在正确的目录
检查Python环境变量
Windows上检查执行策略
尝试重新创建虚拟环境

requirements.txt问题：

确保在激活环境下执行pip freeze
检查文件编码（建议使用UTF-8）
验证所有依赖版本兼容性

结语

虚拟环境是Python开发中非常重要的工具，掌握它可以让你的开发过程更加顺畅。记住，遇到问题时不要慌张，按照本文的故障排除清单一步步检查，相信你很快就能解决问题。