Skip to content

Python environment in Windows

1. Install Anaconda/Miniconda

Anaconda 和 Miniconda 均内置python,搭配conda包管理。

Anaconda 自带科学计算常用库(如 numpy, scipy),有图形化管理界面。

Miniconda 相当于最小化安装,需要自己手动安装各种库(推荐使用)。

下载地址:

官网:https://www.anaconda.com/download/

也可在清华镜像站下载,速度更快,适用于没有科学上网时: https://mirrors.tuna.tsinghua.edu.cn/anaconda/miniconda/Miniconda3-latest-Windows-x86_64.exe

安装过程可全默认,注意勾选“添加环境变量”。

以笔者为例,安装路径为:

Text Only
E:\miniconda3

安装完成之后注意打开“设置”——“系统”——“高级系统设置”——“环境变量”——“系统变量”——“PATH”,查看是否已经添加下面三个变量,若没有可手动添加:

Text Only
E:\miniconda3
E:\miniconda3\Scripts
E:\miniconda3\Library\bin

安装完成之后,“开始”界面一般会出现Anaconda Prompt,打开后自动进入base环境,请保持base环境纯净,不安装任何库,平时使用请创建不同的conda虚拟环境满足不同需要。

首先编辑conda配置文件,命令行输入(注意有点号):

Bash
notepad .condarc

将以下内容复制粘贴进去(注意空格,格式不要乱):

Text Only
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
  pytorch-lts: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
  simpleitk: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud

然后命令行输入(换清华源):

Bash
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
pip config set global.trusted-host pypi.tuna.tsinghua.edu.cn
pip config set global.timeout 6000

这个步骤也可以直接创建配置文件来实现:

一般情况下,进入目录C:\Users\ASUS\AppData\Roaming\pip,然后创建txt文件,输入以下内容:

Text Only
[global]
timeout = 6000
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn

保存文件,重命名并修改扩展名,最后命名为pip.ini

仍在上述Anaconda Prompt,conda常用环境命令如下:

Bash
conda create -n test python=3.9 # 指定python版本,-n等同于--name
conda activate test # 激活test虚拟环境
conda deactivate # 退出当前环境,回到base
conda env list
conda info -e
conda info --envs # 上面3个均为查看环境信息,输出中带星号*的为当前所在环境
conda remove -n test --all # 删除test环境
conda config --show # 显示conda配置
conda update conda # 更新conda
conda update Anaconda

注意:除了使用 conda 创建环境以外,后续建议使用 pip 安装和更新软件包,避免 pip 和 conda 混用。

2. Configure VS Code

下载插件:python,jupyter(必需),ruff(可选)。

打开设置,转到setting.json,添加如下配置(注意修改路径为自己的python路径):

JSON
  //python解释器和设置
  "python.defaultInterpreterPath": "E:\\miniconda3\\envs\\py3901\\python.exe",
  "python.condaPath": "E:\\miniconda3\\Scripts\\conda.exe",
  "python.venvPath": "E:\\miniconda3\\envs",
  "python.venvFolders": ["envs", ".pyenv", ".direnv", ".env"],

  "[python]": {
    "editor.tabSize": 4,
    // "editor.defaultFormatter": "ms-python.black-formatter", // 需要下载 black 插件
    "editor.defaultFormatter": "charliermarsh.ruff", // 需要下载 ruff 插件
    "editor.formatOnPaste": true,
    "editor.formatOnSaveMode": "file",
    "editor.formatOnSave": true,
    "editor.formatOnType": true,
    "editor.codeActionsOnSave": {
      "source.fixAll": "explicit",
      "source.organizeImports": "explicit"
    }
  },
  "notebook.formatOnSave.enabled": true,
  "notebook.codeActionsOnSave": {
    "notebook.source.fixAll": "explicit",
    "notebook.source.organizeImports": "explicit"
  },

3. Configure PyCharm

下载安装过程略(注意添加环境变量)。

新建python项目,选择添加本地解释器——Conda环境,在conda可执行文件中选择:(对照自己的路径)

Text Only
E:\miniconda3\Scripts\conda.exe

然后加载,你会看到base环境和自己创建的各种环境,选择一个即可,然后就可以开始愉快地运行和调试了。

4. Else

血泪教训:又遇到无论如何包都会下载到base环境的问题,无法指向虚拟环境,目前的解决办法是:

Bash
conda create -n test python=3.9 # 指定python版本,-n等同于--name

也就是一定要在创建虚拟环境时指定python的版本号,否则创建好的环境会和 base 环境混在一起。

Comments