«

Windows 下 Conda 完整配置教程:创建 Python3.10 环境 + 镜像加速 + 激活问题全解决

从0至1 • 1 个月前 • 81 次点击 • 灵感迸发


Windows 下 Conda 完整配置教程:创建 Python3.10 环境 + 镜像加速 + 激活问题全解决

在使用 Conda 管理 Python 环境时,新手常遇「环境激活不显示前缀」「旧版本兼容报错」「下载速度慢」「脚本执行被禁止」等问题。本文整合 Conda 安装→环境创建→镜像配置→问题排查 全流程,针对 Windows 10/11(PowerShell/CMD)提供一步到位解决方案,特别适配 Python3.10 场景(如 YOLO 训练、数据分析、爬虫开发等)。


一、前提准备

1. 系统环境要求

2. 核心目标


二、第一步:安装 / 升级 Conda(关键避坑)

1. 卸载旧版 Conda(版本≤4.5.x 必做)

旧版本 Conda 兼容性问题极多,建议直接重装:

  1. 卸载程序:打开「设置→应用→应用和功能」,搜索「Anaconda/Miniconda」卸载;

  2. 清理残留:

2. 下载最新版 Miniconda(轻量推荐)

优先选择清华镜像(国内下载速度快),无需科学上网:

下载来源 链接地址 核心优势
清华镜像(推荐) Miniconda3-latest-Windows-x86_64.exe 国内节点,下载秒级完成;内置最新 Conda + Python3.12(兼容 Python3.10 环境)
官方源 Miniconda3-latest-Windows-x86_64.exe 适合网络通畅场景,版本绝对最新

3. 安装关键步骤(必看!)

  1. 双击下载的 .exe 文件,选择「Just Me」(仅当前用户,避免权限冲突);

  2. 安装路径:默认 C:\Users\你的用户名\miniconda3(⚠️ 禁止中文、空格路径);

  3. 勾选核心选项(缺一不可):

  1. 点击「Install」完成安装,关闭向导。

4. 验证安装成功

打开 新的 PowerShell(旧终端需重启,环境变量才生效),执行命令:

conda --version

输出类似 conda 24.5.0(版本号≥23.x 即为最新),说明安装成功。


三、第二步:创建 Python3.10 专属环境

1. 一键创建命令(复制粘贴即可)

\# 创建名为 yolo\_test 的环境,指定 Python3.10,-y 自动确认所有选项

conda create -n yolo\_test python=3.10 -y

2. 常见提示处理

(1)首次创建环境:服务条款确认

终端会提示接受 Anaconda 服务条款,输入 a(accept)回车:

Do you accept the Terms of Service (ToS) for https://repo.anaconda.com/pkgs/msys2? \[(a)ccept/(r)eject/(v)iew]: a

(2)SSL 安全警告(配置镜像后可能出现)

若出现 InsecureRequestWarning(未验证 HTTPS 证书),仅为警告不影响功能,后续可通过恢复 SSL 验证消除(见下文第六节)。

3. 验证环境创建成功

执行命令查看所有 Conda 环境:

conda info --envs

输出类似以下内容(yolo_test 存在即为成功):

\# conda environments:

base                  \*  C:\Users\17482\miniconda3

yolo\_test                C:\Users\17482\miniconda3\envs\yolo\_test

四、第三步:配置清华镜像源(加速下载)

默认官方源在国内下载速度极慢(几十 KB/s),配置清华镜像后可达到 MB/s 级别。

1. 方法 1:命令行一键配置(新手推荐)

在 PowerShell 中依次执行以下命令,自动覆盖原有配置:

\# 1. 清空原有源,避免冲突

conda config --remove-key channels

\# 2. 添加清华核心镜像源(覆盖主流包仓库)

conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/

conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/r/

conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/msys2/

conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge/

conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/bioconda/

\# 3. 显示下载通道地址(方便排查问题)

conda config --set show\_channel\_urls yes

\# 4. 临时禁用 SSL 验证(避免证书报错,后续可恢复)

conda config --set ssl\_verify false

2. 方法 2:手动编辑配置文件(命令行失败时用)

若命令行配置无效,直接编辑 .condarc 文件:

  1. 找到文件路径:C:\Users\你的用户名\.condarc(隐藏文件,需勾选「查看→隐藏项目」);

  2. 删除原有内容,粘贴以下配置:

channels:

  \- defaults

show\_channel\_urls: true

default\_channels:

  \- https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main

  \- https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/r

  \- https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/msys2

custom\_channels:

  conda-forge: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud

  bioconda: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud

  pytorch: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud

ssl\_verify: false
  1. 保存文件,重启终端生效。

3. 验证镜像配置成功

执行命令查看当前镜像源:

conda config --show channels

输出包含 https://mirrors.tuna.tsinghua.edu.cn/ 开头的地址,说明配置成功。


五、第四步:解决「环境激活不显示前缀」问题

执行 conda activate yolo_test 后,终端不显示 (yolo_test) 前缀,是 PowerShell 配置问题,按以下步骤彻底解决:

1. 核心原因(对症下药)

2. 分步解决(按顺序执行)

步骤 1:开启 Conda 前缀显示开关

\# 查看当前设置(默认应为 true,若为 false 则修改)

conda config --show changeps1

\# 若为 false,执行以下命令开启

conda config --set changeps1 true

步骤 2:初始化 PowerShell 的 Conda 脚本

  1. 管理员身份 运行 PowerShell(右键 PowerShell → 选择「以管理员身份运行」);

  2. 执行初始化命令:

conda init powershell
  1. 终端提示「修改了 PowerShell 配置文件」,关闭所有终端(必须重启)。

步骤 3:修改 PowerShell 执行策略(关键!)

默认执行策略 Restricted 禁止运行脚本,导致 Conda 激活脚本无法加载:

  1. 保持管理员身份运行 PowerShell;

  2. 执行以下命令,输入 Y 确认:

\# 设置为 RemoteSigned 策略(允许本地脚本运行,兼顾安全)

Set-ExecutionPolicy RemoteSigned
  1. 验证修改结果:
Get-ExecutionPolicy

输出 RemoteSigned 说明成功。

步骤 4:切换到用户目录激活环境

避免在系统目录操作,切换到用户目录后激活:

\# 切换到用户目录(替换 17482 为你的用户名)

cd C:\Users\17482

\# 激活环境

conda activate yolo\_test

3. 最终验证

终端前缀显示 (yolo_test) C:\Users\17482>,说明激活成功!再执行以下命令确认:

\# 验证当前激活的环境(带 \* 号)

conda info --envs

\# 验证 Python 版本(应为 3.10.x)

python --version

六、第五步:消除 SSL 警告(可选)

第四步配置镜像时设置了 ssl_verify false,可能出现 InsecureRequestWarning,恢复 SSL 验证即可消除:

\# 恢复 Conda 的 SSL 证书验证(推荐)

conda config --set ssl\_verify true

⚠️ 若恢复后下载报错(极少情况),可重新设置 ssl_verify false(国内清华镜像可放心使用)。


七、常用 Conda 命令汇总(快速参考)

功能描述 命令
查看 Conda 版本 conda --version
查看所有环境 conda info --envsconda env list
创建环境 conda create -n 环境名 python=版本 -y(例:conda create -n data_analysis python=3.10 -y
激活环境 conda activate 环境名
退出环境 conda deactivate
安装包(Conda 源) conda install 包名 -y(例:conda install numpy -y
卸载包 conda remove 包名 -y
删除环境(谨慎!) conda remove -n 环境名 --all -y
升级 Conda conda update -n base conda -y
清空缓存(解决下载缓存问题) conda clean --all -y
恢复默认镜像源 conda config --remove-key channels

八、常见问题排查(新手必看)

1. 安装包时提示「PackageNotFoundError」

conda install 包名 -c defaults -y

2. Conda 命令提示「不是内部或外部命令」

  1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」;

  2. 在「用户变量→Path」中添加以下两个路径(替换 17482 为你的用户名):

  1. 重启终端生效。

3. 激活环境后 Python 版本不是 3.10

\# 先删除错误环境

conda remove -n yolo\_test --all -y

\# 重新创建 Python3.10 环境

conda create -n yolo\_test python=3.10 -y

4. 执行 conda init powershell 后终端报错

\# 删除 PowerShell 配置文件(管理员身份执行)

Remove-Item -Path \$PROFILE -Force

\# 重新初始化 Conda

conda init powershell

九、总结

本文覆盖 Windows 系统下 Python3.10 环境搭建全流程,核心避坑要点:

  1. 旧版 Conda(≤4.5.x)兼容差,直接重装最新版是最高效选择;

  2. 清华镜像源是国内下载加速的关键,配置后可避免官方源卡顿;

  3. 「激活不显示前缀」的核心是 PowerShell 初始化 + 执行策略配置,按步骤操作 100% 解决;

  4. 始终在用户目录执行 Conda 命令,避免系统目录权限问题。

    按照本文步骤操作后,你将获得一个稳定的 Python3.10 隔离环境,可直接用于 YOLO 训练、数据分析、爬虫开发等场景。若遇到其他未覆盖的问题,欢迎留言交流!

(注:文档部分内容可能由 AI 生成)


扫描二维码,在手机上阅读
文章目录


    收藏
    还没收到回复
    请先 登录 再回复