Windows配置python(anaconda+vscode方案)的主要步骤及注意事项

Windows配置python(anaconda+vscode方案)的主要步骤及注意事项

1、准备工作

  • anaconda,官网下载(直接下载最新版)
  • vscode,官网下载 (官网直接下载有可能太慢,可以考虑在国内靠谱的网站上下载)
    PS:windows上也完全可以直接使用miniforge或者miniconda,安装配置方法完全一样,并且体积明显更小。

2、安装与配置anaconda

  • 直接安装anaconda(miniforege、miniconda完全相同),除安装路径外全部默认,一直点击"下一步"直至安装完成
  • 配置环境变量:
    • 在系统设置中找到环境变量
    • 找到anaconda的安装路径
    • 将以下三个路径增加到系统路径中

注意这里 D:\Download 是你安装anaconda的路径,根据你自己安装时选择的路径去找。如果找不到,可以在"搜索"中找到 anaconda,再不断定位回anaconda的安装路径即可。

以上三个路径主要表示:python所在路径、conda命令和常用脚本的路径。

配置完成后打开cmd,输入 python --version,会看到python版本号,输入 conda -V 也能查到anaconda的版本。 此时环境变量配置成功。(一般不成功可能是忘记点确定、保存或路径填错等)。以上操作大致如下:

完成上述配置后,可直接使用 python test.py (test.pytest.py的完整路径)即可运行python脚本。并且 condapip install 等操作均可直接使用。

3、安装与配置vscode

  • 下载vscode后直接安装(同样,除安装路径外,全部选择默认即可)

  • 安装python插件:

    注意python相关的插件很多,我们只需要安装开发者为 Microsoft 的版本。

  • 新建一个python文件,打开该文件后右下角会出现以下字样:

    如果没有显示,直接点击这个位置,会在上面出现提示(通常会出现intepreter字样)。此时注意看提示的文字。

这里很重要:目前的最新版通常都会自动去搜索conda环境,所以一般在配置好anaconda(miniforge、miniconda类似)在vscode中基本根据提示就可以找到python所在路径。

  • 点击右上角三角形运行程序,即可执行python脚本。

4、关于windows下vscode里的一些坑

  • 不知道从哪个版本开始,vscode会默认让python在powershell下运行,此时有可能会提示"需要初始化powershell"等,总之就是无法运行。【如果运行python文件之后,终端里前面有 PS 字样就说明在powershell里面】。此时简便起见,直接借助另一个插件解决即可:

安装coder runner插件:

打开"setting" (中文"设置"),搜索 code runner,找到设置:run in terminal

保险起见再勾上 "save file before run"(上图倒数第二个选项)。

自此再运行python脚本就直接在cmd中显示,不需要管powershell到底有没有配置好。

5、vscode里配置jupyter notebook

  • 安装Jupyter插件
  • 【一定要仔细!】在自己需要使用的环境里,先安装好两个库:

pip install jupyter (这一个一般来说是已经装好)
pip install ipykernel (如果没装,直接运行notebook的cell时vscode也会提示并自动安装,但通常较慢,此时可考虑使用国内镜像安装)。比如:

shell 复制代码
pip install jupyter -i http://mirrors.aliyun.com/pypi/simple --trusted-host mirrors.aliyun.com
pip install ipykernel -i http://mirrors.aliyun.com/pypi/simple --trusted-host mirrors.aliyun.com

安装好之后,新建 notebook文件,比如叫 "test.ipynb",在cell中输入 print('hello world!') , 点击运行或(ctrl+enter),运行成功,则配置完成。

  • 注意:偶尔会出现一些怪象,比如

    这一问题通常是由pyzmq库的版本问题导致的,最简单的解决方法:

进入当前环境,卸载库:pip uninstall pyzmq,再重新安装该库即可:

shell 复制代码
pip install pyzmq -i https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.cn

6、其它

  • 如果选择使用anaconda,那么完全不需要再单独安装python软件。进入应用程序查看是否有 python.exepython launcher 字样的软件,全部卸载。原因是:anaconda已经直接内置了python程序,并且可以通过创建新环境安装不同版本的python。此时再单独安装python反而有可能导致更多问题。
  • vscode运行python文件时,本质上只是替我们完成 python -u [python脚本的完整路径] 这一操作。所谓配置,也只是告诉vscode python在哪里即可。
  • 了解一下anaconda的环境管理机制很有用,可以有效避免实战中常有时弄错环境而出现的"意想不到"的报错。
相关推荐
逢生博客26 分钟前
使用 Python 项目管理工具 uv 快速创建 MCP 服务(Cherry Studio、Trae 添加 MCP 服务)
python·sqlite·uv·deepseek·trae·cherry studio·mcp服务
堕落似梦32 分钟前
Pydantic增强SQLALchemy序列化(FastAPI直接输出SQLALchemy查询集)
python
李菠菜35 分钟前
解决Windows系统下Git克隆时报错“unable to checkout working tree”的方法详解
windows·git
坐吃山猪1 小时前
Python-Agent调用多个Server-FastAPI版本
开发语言·python·fastapi
Bruce-li__2 小时前
使用Django REST Framework快速开发API接口
python·django·sqlite
小兜全糖(xdqt)2 小时前
python 脚本引用django中的数据库model
python·django
Arenaschi2 小时前
SQLite 是什么?
开发语言·网络·python·网络协议·tcp/ip
纪元A梦2 小时前
华为OD机试真题——推荐多样性(2025A卷:200分)Java/python/JavaScript/C++/C语言/GO六种最佳实现
java·javascript·c++·python·华为od·go·华为od机试题
仙人掌_lz2 小时前
人工智能与机器学习:Python从零实现性回归模型
人工智能·python·机器学习·线性回归
Zww08912 小时前
出现delete CR eslint错误
vscode