VScode上的python环境配置与使用教程
本教程旨在为初学者提供一个清晰、高效的Python开发工作流,重点讲解如何利用Anaconda管理环境,并在VSCode中无缝使用这些环境进行编码、调试和项目管理。
建议固定工作流
- 环境管理: 始终使用 Anaconda Prompt来执行环境相关的操作,包括创建、删除环境,以及安装或卸载第三方库。
- 代码开发: 使用 VSCode 来完成所有代码相关的任务,包括编写、运行、调试代码。
第一部分:环境管理(在Anaconda Prompt中操作)
- 打开Anaconda Prompt
- 一键配置镜像源
bash
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/free/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge/
conda config --set show_channel_urls yes
验证是否添加成功:
bash
conda config --show channels
- 设置默认环境路径
为了便于管理,建议把环境统一存放在Anaconda安装目录下的envs文件夹中。
bash
# 首先,检查当前环境路径设置:
conda config --show envs_dirs
# 查看返回结果,若env路径不在第一条,可将其添加至首位:
# 注意:需要将以下路径替换为自己的Anaconda实际安装路径
conda config --add envs_dirs D:\Software\anaconda3\envs
# 检查:(此时可发现"D:\Software\anaconda3\envs"该路径出现在第一条,表示设置成功)
conda config --show envs_dirs
操作提示: 执行路径更改后,建议关闭并重新打开Anaconda Prompt,以确保设置生效。
- 创建虚拟环境
bash
conda create -n env_name python=3.11 # 此时创建虚拟环境,会被默认创建在上一步设置的env路径下,如"D:\Software\anaconda3\envs"
检查环境及其存放位置,会返回现有的环境及其存放路径:
bash
conda env list
- 激活环境
bash
conda activate env_name
- 安装所需库
bash
conda install numpy pandas matplotlib scikit-learn jupyter
- 其他常用命令:
bash
conda env list #查看环境,星号 * 标注当前激活的环境
conda deactivate #退出当前环境,回到 base
conda remove --name env_name --all #删除名为env_name的环境,慎用!
第二部分:VScode中的开发流程
- 安装VScode
- 访问 VSCode官网
- 下载Windows版本
- 运行安装程序,全部勾选
- 新建项目文件夹
新建一个存放项目代码的文件夹 - VScode操作
-
打开主文件夹: 选择"文件"------"打开文件夹",选中上一步新建好的文件夹。此时,VScode的侧边栏【资源管理器】会显示该文件夹。
-
为各个项目单独创建子文件夹: 右键点击主文件夹,选择"新建文件夹",根据需求创建各个分项目子文件夹。
-
关联python环境(关键):
- 在左侧【资源管理器】点击主文件夹。
- 按 Ctrl+Shift+P,输入并选择 "Python: Select Interpreter",然后从列表中选择你为项目创建的 env_name 环境。(这个设置会作用于整个主文件夹及其所有子文件夹。)
- 如果希望不同的项目使用不同的环境,只需要分别打开对应项目子文件夹,重复步骤2选择不同的环境即可。这会在该子文件夹创建一个局部设置,覆盖其父文件夹的设置。
- 下次只需在资源管理器中点击该子文件夹,VSCode会自动识别并切换到为它单独设置的环境。
- 可以在VSCode右下角的状态栏看到当前激活的环境名称。
-
在项目子文件中新建与运行代码:
- 在侧边栏【资源管理器】中点击进入一个子文件夹,选择"新建文件",命名为"code_name.py"。
- 在文件中输入代码,点击"运行"(右上角的三角按钮),或右键选择"在终端中运行python"。