文章目录前言一、为什么要在 WSL 里安装 Miniconda1.1 Windows 和 WSL 是两套环境1.2 为什么选择 Miniconda二、安装 Miniconda2.1 进入 WSL2.2 安装 wget2.3 下载 Miniconda 安装脚本三、让 conda 命令生效3.1 重新加载终端配置3.1.1 理解~/.bashrc3.1.2 理解~3.1.2 source 是什么意思3.2 检查是否安装成功四、创建项目环境4.1 回到项目目录4.2 创建 Conda 环境4.3 激活环境4.4 安装项目依赖五、常见问题5.1 conda: command not found5.2 终端前面出现 (base)5.3 Windows 已经安装 CondaWSL 还需要安装吗5.4 Terms of Service服务条款总结前言在 WSL 中运行 GitHub 项目时经常需要创建独立的 Python 环境。如果直接执行conda create-nlocagentpython3.12-y出现conda:commandnot found说明当前 WSL 里还没有安装 Conda。Windows 中安装过 Anaconda 或 Miniconda并不代表 WSL 里也能直接使用因为 WSL 是一套独立的 Linux 环境。一、为什么要在 WSL 里安装 Miniconda1.1 Windows 和 WSL 是两套环境Windows 里的 Python、Conda、pip 包和 WSL 里的 Python、Conda、pip 包不是同一套。所以要在 WSL 中运行 Linux 项目就需要在 WSL 中单独安装一套 Miniconda。1.2 为什么选择 MinicondaMiniconda 比 Anaconda 更轻量只提供 Conda、Python 和少量基础工具。后续项目需要什么包再通过conda install或pip install安装即可。可以理解为Anaconda 装修好的大房子东西很多Miniconda 简洁毛坯房需要什么再装什么二、安装 Miniconda2.1 进入 WSL先进入 WSL 终端wsl然后回到用户家目录cd~2.2 安装 wget如果系统里没有wget先安装sudoaptupdatesudoaptinstallwget-ywget的作用是从网络下载文件。含义是wget web get从网络上获取文件作用类似于你在浏览器里点击“下载”只不过它是在终端里完成下载。比如浏览器里访问https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh会下载一个 Miniconda 安装脚本。在 WSL 里可以用wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh效果就是把这个链接对应的文件下载到当前目录。2.3 下载 Miniconda 安装脚本执行wgethttps://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh这会把 Miniconda 的 Linux 安装脚本下载到当前目录。安装过程中会让你按回车、输入yes。安装路径默认是/home/你的用户名/miniconda3直接默认即可。官方文档也建议不确定时接受默认安装位置。最后它会问类似Do you wish to initialize Miniconda3 by running conda init?这里输入yes这个操作会让以后打开 WSL 终端时能识别conda命令。三、让 conda 命令生效3.1 重新加载终端配置安装完成后执行source~/.bashrc这一步的作用是让刚才写入.bashrc的 conda 配置立即生效。也可以关闭 WSL 终端后重新打开。3.1.1 理解~/.bashrc你在 WSL 里的~打开终端其实用的是一个 shell一般是bash。每次打开 bash 终端时它都会读取一个配置文件~/.bashrc这个文件里面会放一些终端启动时需要加载的配置比如环境变量命令别名conda 初始化配置PATH 路径配置可以理解为.bashrc是 WSL 终端启动时自动读取的配置清单3.1.2 理解~~表示当前用户的家目录。比如你的用户名是like那么~就等于/home/like所以~/.bashrc其实就是/home/like/.bashrc3.1.2source是什么意思source意思是在当前终端里执行某个配置文件让里面的配置立刻生效。所以source ~/.bashrc完整意思是在当前终端里重新执行 /home/like/.bashrc 这个配置文件让里面的新配置马上生效。3.2 检查是否安装成功执行conda--version果能看到类似说明 Miniconda 已经安装成功。也可以执行conda list查看当前 base 环境中的包。四、创建项目环境4.1 回到项目目录例如 LocAgent 项目在~/Code/javatest进入项目目录cd~/Code/javatest4.2 创建 Conda 环境创建一个名为locagent的环境conda create-ntestpython3.12-y其中-n test环境名字叫 test python3.12指定 Python 版本 -y自动确认安装4.3 激活环境执行conda activatetest激活成功后终端前面会出现(test)例如(test)likelikerhood:~/Code/javatest$这说明当前已经进入test环境。4.4 安装项目依赖一般根据项目 README 操作。常见命令是pipinstall-rrequirements.txt如果项目使用其他依赖文件就按照项目说明执行。五、常见问题5.1conda: command not found说明 WSL 中没有安装 Miniconda或者安装后没有执行source~/.bashrc可以先重新加载配置source~/.bashrc再检查conda--version5.2 终端前面出现(base)安装 Miniconda 后有时终端前面会自动出现(base)这表示当前进入了 Conda 的基础环境。一般不建议直接在base里安装项目依赖最好为每个项目单独创建环境。例如conda create-n环境名python3.12-yconda activate 环境名5.3 Windows 已经安装 CondaWSL 还需要安装吗需要。Windows 和 WSL 是两套环境。Windows 里的 Conda 不能直接当作 WSL 的 Linux Conda 使用。可以理解为Windows 的 Conda Windows 房间里的工具箱 WSL 的 Conda Linux 工作间里的工具箱运行 Linux 项目时应该使用 WSL 里的 Conda。5.4 Terms of Service服务条款创建虚拟环境是报错如下(base)likelikerhood:~/javatest$ conda create-ntestpython3.12-yCondaToSNonInteractiveError: Terms of Service have not been acceptedforthe following channels. Please accept or remove them before proceeding: - https://repo.anaconda.com/pkgs/main - https://repo.anaconda.com/pkgs/r To accept these channels Terms of Service, run the following commands: conda tos accept --override-channels--channelhttps://repo.anaconda.com/pkgs/main conda tos accept --override-channels--channelhttps://repo.anaconda.com/pkgs/r For information on safely removing channels from your conda configuration, please see the official documentation: https://www.anaconda.com/docs/tools/working-with-conda/channels创建环境时Conda 要从这两个默认源下载包https://repo.anaconda.com/pkgs/main https://repo.anaconda.com/pkgs/r但你还没有接受它们的条款所以 Conda 拦住了。Anaconda 官方文档也说明可以用conda tos accept --override-channels --channel ...来接受指定 channel 的 Terms of Service。直接按它提示执行这两条conda tos accept --override-channels--channelhttps://repo.anaconda.com/pkgs/main conda tos accept --override-channels--channelhttps://repo.anaconda.com/pkgs/r然后重新创建环境conda create-ntestpython3.12-y成功后激活conda activate test如果你不想用 Anaconda 默认源也可以改用社区源conda-forge但你现在最简单的做法就是先接受这两个默认源条款。总结在 WSL 中出现conda: command not found说明当前 Linux 环境里还没有配置 Conda。解决方法是在 WSL 中单独安装 Miniconda然后通过conda create创建项目环境。推荐流程是cd~sudoaptupdatesudoaptinstallwget-ywgethttps://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.shbashMiniconda3-latest-Linux-x86_64.shsource~/.bashrc conda--version之后再进入项目目录创建并激活环境cd~/Code/javatest conda create-ntestpython3.12-yconda activatetestpipinstall-rrequirements.txt简单来说WSL 运行 Linux 项目就需要在 WSL 中准备 Linux 版本的 Conda 和 Python 环境。这样项目依赖更清晰也更符合 GitHub 项目的原始运行环境。