【Python】conda镜像配置,.condarc文件详解,channel镜像

2025-08-06 01:27:44

1. conda 环境

安装miniconda即可,Miniconda 安装包可以到 http://mirrors.aliyun.com/anaconda/miniconda/ 下载。(若链接失效,可到官网下载,速度可能慢一些)

安装完后,可进入开始菜单栏中点击Anaconda Promot,通过conda命令进行使用。

.condarc是conda 应用程序的配置文件,在用户家目录(windows:C:\users\username\),用于管理镜像源。如果不存在,则打开conda的,执行一下:

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

2. conda包管理目录

anaconda安装的位置/pkgs该目录是用户指定update或install时由 Conda 下载并提取的包,都是解压后的包,可以在 conda 环境中通过link关联。

anaconda安装的位置\envs\虚拟环境\Lib\site-packages 则是启用虚拟环境后import时导入包的地方。它们来自anaconda安装的位置/pkgs。

anaconda安装的位置/Lib/site-packages 是base环境的路径。

3. 配置镜像源

3.1 通过命令配置和删除

# 查看当前conda配置

conda config --show channels

# 增加channel

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 --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud//pytorch/

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

#设置搜索是显示通道地址

conda config --set show_channel_urls yes

conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/会直接加到.condarc文件的channels下面,成为一个独立的channel:

3.2 通过修改文件添加(推荐)

直接修改.condarc文件是最方便的。

大家常搜到的配置文件如下: 阿里源(来自阿里云官方镜像配置指导):

channels:

- defaults

show_channel_urls: true

default_channels:

- http://mirrors.aliyun.com/anaconda/pkgs/main

- http://mirrors.aliyun.com/anaconda/pkgs/r

- http://mirrors.aliyun.com/anaconda/pkgs/msys2

custom_channels:

conda-forge: http://mirrors.aliyun.com/anaconda/cloud

msys2: http://mirrors.aliyun.com/anaconda/cloud

bioconda: http://mirrors.aliyun.com/anaconda/cloud

menpo: http://mirrors.aliyun.com/anaconda/cloud

pytorch: http://mirrors.aliyun.com/anaconda/cloud

simpleitk: http://mirrors.aliyun.com/anaconda/cloud

清华源:

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

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

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

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

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

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

配置完后如果不生效可清空conda缓存再试试:

conda clean -i

4. .conda文件详解

conda 配置文件.condarc是一个可选的运行时配置文件,允许用户配置 conda 的各个方面,例如在哪些channel中搜索包、代理设置和环境目录。本文仅讨论和channel相关的部分。

4.1 channels

channels下面配置的就是可访问的chennel。 修改.condarc文件的channels会覆盖 conda 搜索的默认值,导致 conda 仅按给定顺序搜索此处列出的频道。

频道有url和非url之分:

url:自定义的搜索地址,如前面的https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/非url: Anaconda.org 用户或组织名称,如conda-forge对应着https://conda.anaconda.org中的conda-forge。

如果.condarc文件如下:

channels:

- conda-forge

- http://Code_LT

- defaults

则conda搜索pandas包的时候就会按conda-forge->http://Code_LT->defaults的顺序搜索。

4.2 channels分类

conda把channel分为两类

默认channel(default channels)社区channel(community channels)

如果不修改.condarc文件,conda会默认从这两类channel中搜索需要的包:

默认channel:对应repo.anaconda.com仓,硬编码写死了对应如下三个仓库(:

https://repo.anaconda.com/pkgs/main

https://repo.anaconda.com/pkgs/r

https://repo.anaconda.com/pkgs/msys2

社区channel:对应conda.anaconda.org仓,即https://conda.anaconda.org

4.3 channels镜像修改

.condarc文件除了把url硬编码进chennels下面,还可以把非url的Anaconda.org 用户或组织名称映射到指定的仓。

根据channels分类可知道,要修改的化就涉及默认channel和社区channel的修改。

利用default_channels修改默认channel

如前面讲的阿里镜像中的:

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

则把原有的defaults对应的仓换成了上面的阿里仓。

利用channel_alias 修改社区channel

所有社区频道都会被修改,这个用得比较少,如:

channel_alias: https://my-mirror.com

则配置conda-forge频道后,conda不会再去https://conda.anaconda.org搜。

利用custom_channels修改指定社区channel

custom_channels:

conda-forge: https://Code_LT/conda-forge

这样写进.condarc文件中后,配置conda-forge就不会再去https://conda.anaconda.org搜,而是到https://Code_LT/conda-forge搜,其他社区频道不变。

这样,清华源和阿里源的配置就弄明白了。

4.4 channel_priority

频道优先级,可以通过命令

conda config --describe channel_priority

查看该字段的含义

# # Accepts values of 'strict', 'flexible', and 'disabled'. The default

# # value is 'flexible'. With strict channel priority, packages in lower

# # priority channels are not considered if a package with the same name

# # appears in a higher priority channel. With flexible channel priority,

# # the solver may reach into lower priority channels to fulfill

# # dependencies, rather than raising an unsatisfiable error. With channel

# # priority disabled, package version takes precedence, and the

# # configured priority of channels is used only to break ties. In

# # previous versions of conda, this parameter was configured as either

# # True or False. True is now an alias to 'flexible'.

默认是flexible,看不少博客推荐strict,可通过如下方式修改:

conda config --set channel_priority strict

或者直接在.condarc文件中添加:channel_priority: strict

4.5 为环境配置单独的.condarc文件

要为单个环境选择通道,请将.condarc 文件放入该环境的根目录中(或 使用conda config 时使​​用--env选项)。

示例:如果您已在主目录中安装了带有 Python 3 的 Miniconda,并且环境名为“flowers”,则路径可能为:

~/miniconda3/envs/flowers/.condarc

5. 配置文件冲突解决

conda会在如下目录中搜索.condarc文件

if on_win:

SEARCH_PATH = (

"C:/ProgramData/conda/.condarc",

"C:/ProgramData/conda/condarc",

"C:/ProgramData/conda/condarc.d",

)

else:

SEARCH_PATH = (

"/etc/conda/.condarc",

"/etc/conda/condarc",

"/etc/conda/condarc.d/",

"/var/lib/conda/.condarc",

"/var/lib/conda/condarc",

"/var/lib/conda/condarc.d/",

)

SEARCH_PATH += (

"$CONDA_ROOT/.condarc",

"$CONDA_ROOT/condarc",

"$CONDA_ROOT/condarc.d/",

"$XDG_CONFIG_HOME/conda/.condarc",

"$XDG_CONFIG_HOME/conda/condarc",

"$XDG_CONFIG_HOME/conda/condarc.d/",

"~/.config/conda/.condarc",

"~/.config/conda/condarc",

"~/.config/conda/condarc.d/",

"~/.conda/.condarc",

"~/.conda/condarc",

"~/.conda/condarc.d/",

"~/.condarc",

"$CONDA_PREFIX/.condarc",

"$CONDA_PREFIX/condarc",

"$CONDA_PREFIX/condarc.d/",

"$CONDARC",

)

多个文件之间可能会发生冲突,按照如下原则解决冲突(具体不展开了,可自行查看官网资料):

Lists - mergeDictionaries - mergePrimitive - clobber

冲突解决的优先级:

6. conda常用命令

# 获取版本号

conda -V

# 获取帮助

conda -h

# 环境管理命令帮助

conda env -h

# 列举所有环境

conda info --env

conda env list

# Python创建虚拟环境

conda create -n your_env_name python=x.x

# 复制某个环境

conda create --name new_env_name --clone old_env_name

# 彻底删除旧环境,则可以实现重命名环境

conda remove --name old_env_name --all # 注意:必须在base环境下进行以上操作,否则会出现各种莫名的问题。

# 激活或者切换虚拟环境

Windows: activate your_env_name

Linux: source activate your_env_nam

# 关闭虚拟环境(即从当前环境退出返回使用PATH环境中的默认python版本)

Windows: deactivate 或者 activate root 切回root环境

Linux:source deactivate

# 删除虚拟环境

conda remove -n your_env_name --all

# 删除环境钟的某个包

conda remove --name $your_env_name $package_name

# 列举包

conda list

conda list -n your_env_name # 列举非当前活跃环境下的所有包

# 安装包

conda install [package]

conda install -n your_env_name [package] # 安装非当前活跃环境下的包

conda install --channel https://conda.anaconda.org/anaconda tensorflow=1.8.0 # 指定版本和channel

# 升级包

conda update [package]

conda update conda # 升级conda

# 查找包

conda search -h # 查看search使用帮助信息

conda search tensorflow # 查看指定包可安装版本信息命令

conda search llama-index --channel conda-forge #指定频道搜索

# 卸载包

conda uninstall [package] # 卸载xxx文件包

# 清理包

conda clean -p //删除没有用的包 # 这个命令会检查哪些包没有在包缓存中被硬依赖到其他地方,并删除它们

conda clean -t //删除tar包

conda clean -y --all //删除所有的安装包及cache

# 分享环境

activate target_env # 进入要分享的环境

conda env export > environment.yml # 当前工作目录下生成一个environment.yml

conda env create -f environment.yml # 拿到environment.yml文件后,将该文件放在工作目录下,可以通过以下命令从该文件创建环境

7. conda install和pip install

先说结论:conda 中可以使用pip, 但conda 并不兼容pip, pip 安装的包越多, 越容易引发包版本依赖问题, 所以能用conda安装的包先用conda 安装, 不能的再到激活的虚拟环境里用pip安装.

conda install xxx:这种方式安装的库都会放在anaconda安装的位置/pkgs目录下,这样的好处就是,当在某个环境下已经下载好了某个库,再在另一个环境中还需要这个库时,就可以直接从pkgs目录下将该库复制至新环境而不用重复下载。

pip install xxx:分两种情况,一种情况就是当前conda环境的python是conda安装的,和系统的不一样,那么xxx会被安装到anaconda安装的位置/envs/current_env/lib/python3.x/site-packages文件夹中,如果当前conda环境用的是系统的python,那么xxx会通常会被安装到~/.local/lib/python3.x/site-packages文件夹中。

8. conda配置代理

.condarc文件中加入代理信息即可

channels:

- defaults

show_channel_urls: true

...

proxy_servers:

http: http://xxx.xx.com:8080

https: https://xxx.xx.com:8080

ssl_verify: false

注意把http:和https:后面的链接换成你的代理链接和端口号。

9. 常见报错与本地安装

9.1 PackagesNotFoundError

PackagesNotFoundError: The following packages are not available from current channels 两个常见原因:

镜像本身的问题(比如网络问题或者服务问题),解决方法:清华源和阿里源切换着试试要安装的包不在default频道里,从上面的配置说明可以知道,默认.condarc文件配置,只启用了default频道,如果知道某些包在其他频道,比如tiktoken就在conda-forge频道里,那就要把conda-forge在channels下面启用

channels:

- defaults

- conda-forge

show_channel_urls: true

default_channels:

- http://mirrors.aliyun.com/anaconda/pkgs/main

- http://mirrors.aliyun.com/anaconda/pkgs/r

- http://mirrors.aliyun.com/anaconda/pkgs/msys2

custom_channels:

conda-forge: http://mirrors.aliyun.com/anaconda/cloud

msys2: http://mirrors.aliyun.com/anaconda/cloud

bioconda: http://mirrors.aliyun.com/anaconda/cloud

menpo: http://mirrors.aliyun.com/anaconda/cloud

pytorch: http://mirrors.aliyun.com/anaconda/cloud

simpleitk: http://mirrors.aliyun.com/anaconda/cloud

或者不想改配置文件也可以conda命令行里带指定频道:

conda install --channel conda-forge tiktoken

本地安装 conda仓库中确实没有这个包,那就只能找到发布包下载到本地安装了。 可在pypi.org上搜索你要的包,下载到本地,如下图。 这里下载到的通常是gz包(这是给pip install用的),需要转换成bz2包(conda install用的),可以直接用cloudconvert做在线转换,得到要的包:

然后按照如下方法操作

1. 下载安装包到 anaconda安装的位置/pkgs/ 下

2. cd 到 anaconda安装的位置/pkgs/ 目录下

3. 使用命令conda install --use-local xxx.tar.bz2 安装本地包。

实在不行(比如转换文件不可用,或者执行conda install 后没反应等),回到第7节,用pip install解决。

9.2 CondaHTTPError: HTTP 000 CONNECTION FAILED for url

应该是网速的原因,因为下载时间过长,会自动断开,就会提示连接失败,设置延时1000s,如果还是不行的话就设置2000s。

conda config --set remote_read_timeout_secs 1000.0

或者在.condarc文件中添加

参考:

Anaconda安装的包所在的位置 Anaconda的包路径,终于讲清楚了 官网:安装包list和位置相关 【conda】配置国内镜像源 官网:conda目录结构介绍 官网:.condarc文件官方解释 官网:channel镜像的官方说明 阿里云官方镜像配置指导 python中的PYTHONHASHSEED pip install 和conda install有什么区别吗? 工具篇:conda and pip conda常用命令:安装,更新,创建,激活,关闭,查看,卸载,删除,清理,重命名,换源,问题 conda配置代理 CondaHTTPError: HTTP 000 CONNECTION FAILED for url解决方法