安装 Conda 与 VSCode 配置 Python 开发环境
概述
本教程覆盖 Windows 10/11、macOS 系统。核心目标:安装轻量版 Conda(Miniconda)→ 配置 Conda 环境 → VSCode 关联 Conda 运行 Python,解决「环境冲突」「命令找不到」「解释器选不到」等常见问题。
一、准备工作
- 操作系统:Windows 10/11(64 位)或 macOS(Intel/M1/M2 均可)
- 网络:确保能访问官网(或用国内镜像)
介绍在 Windows 和 macOS 系统下安装 Miniconda、配置国内镜像源、创建虚拟环境,以及安装并配置 VSCode 关联 Conda 解释器的完整流程。通过验证命令和运行测试代码,确保 Python 开发环境搭建成功,解决环境冲突和依赖管理问题。
本教程覆盖 Windows 10/11、macOS 系统。核心目标:安装轻量版 Conda(Miniconda)→ 配置 Conda 环境 → VSCode 关联 Conda 运行 Python,解决「环境冲突」「命令找不到」「解释器选不到」等常见问题。
Conda 是「包管理器 + 环境管理器」,Miniconda 是 Conda 的轻量版本(仅含核心功能,不预装大量冗余包),首选。
打开官网下载页(不用注册,直接下载):Miniconda 官网下载 根据系统选择对应安装包:
国内用户如果下载慢:用清华镜像站下载(版本同步官网)清华镜像 Miniconda,找到对应系统的最新版本即可。
.exe 安装包,点击「Next」→ 勾选「I agree」→「Next」。C:\Users\你的用户名\miniconda3),不要改到中文路径(比如「我的软件」这种,会导致命令报错)→「Next」。.pkg 安装包,点击「继续」→「继续」→「同意」→「继续」。安装完成后,需要确认 conda 能正常使用:
在终端 / CMD 中输入以下命令,按回车:
conda --version
如果输出类似 conda 24.5.0(版本号可能不同),说明安装成功!如果提示「conda 不是内部或外部命令」,回到安装步骤检查是否勾选了「添加到环境变量」(Windows),或重启终端再试(macOS)。
打开终端 / CMD,依次输入以下命令(每输完一条按回车,无需修改):
# 添加 Conda 本身的镜像
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-forge)的镜像
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/msys2/
# 显示下载来源(可选,方便排查问题)
conda config --set show_channel_urls yes
输入以下命令,查看配置:
conda config --show-sources
如果输出中包含刚才添加的 https://mirrors.tuna.tsinghua.edu.cn/...,说明换源成功。
我们创建一个名为「python311」的环境(名字可自定义,比如「myenv」),并安装 Python 3.11(稳定版,兼容性好)。
在终端 / CMD 输入:
conda create -n python311 python=3.11
conda create:创建环境的命令-n python311:环境名(可改,比如 -n myfirstenv)python=3.11:指定 Python 版本为 3.11执行后会提示「是否安装依赖」,输入 y 按回车,等待安装(换源后速度很快,约 30 秒)。
环境创建后,需要「激活」才能使用(激活后终端前缀会显示环境名):
macOS(终端):
conda activate python311
Windows(PowerShell):若提示「无法加载脚本」,先执行以下命令(允许执行脚本),再激活:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
按提示输入 Y 回车,再执行 conda activate python311。
Windows(CMD):
conda activate python311
激活后,终端前缀会变成 (python311) C:\Users\XXX>(Windows)或 (python311) XXX@MacBook ~ %(macOS),说明当前处于「python311」环境中。
再输入以下命令,查看当前 Python 路径:
where python # Windows 用这个
# 或 which python # macOS 用这个
输出路径应包含「miniconda3/envs/python311」(比如 C:\Users\XXX\miniconda3\envs\python311\python.exe),说明使用的是虚拟环境中的 Python,而非系统自带的。
| 命令 | 作用 |
|---|---|
conda activate 环境名 | 激活指定环境 |
conda deactivate | 退出当前环境 |
conda env list | 查看所有已创建的环境 |
conda remove -n 环境名 --all | 删除指定环境(谨慎使用) |
VSCode 是免费、轻量、强大的代码编辑器,支持 Python 开发,配合 Conda 环境使用体验极佳。
.exe,macOS 选 .dmg),默认安装即可:
.exe,勾选「添加到 PATH」(可选),点击「下一步」→「安装」。.dmg,将「Visual Studio Code」拖到「应用程序」文件夹中。打开 VSCode,点击左侧「扩展」图标(或按 Ctrl+Shift+X/Cmd+Shift+X),搜索以下插件并安装:
安装完成后,点击插件旁的「启用」(默认已启用),重启 VSCode 生效。
这一步是核心:让 VSCode 识别到我们刚才创建的「python311」环境,避免用系统自带的 Python 导致依赖冲突。
test.py(后缀必须是 .py)。test.py 文件,点击 VSCode 左下角的「选择解释器」(或按 Ctrl+Shift+P/Cmd+Shift+P,输入「Python: 选择解释器」回车)。miniconda3/envs/python311/bin/python 或 miniconda3\envs\python311\python.exe),点击选择。若找不到 Conda 环境?解决方案:点击「输入解释器路径」→「查找」,导航到 Miniconda 安装目录下的
envs/python311/python.exe(Windows)或envs/python311/bin/python(macOS),选中即可。
选择完成后,左下角会显示「Python 3.11.x ('python311')」,说明已关联成功!
现在我们写一段简单的代码,测试整个环境是否能正常工作:
test.py 文件中输入以下代码:# 测试 Python 版本和 Conda 环境
import sys
print("Python 版本:", sys.version)
print("Python 路径:", sys.executable)
# 测试安装第三方包(比如 numpy)
try:
import numpy
print("numpy 版本:", numpy.__version__)
except ImportError:
print("numpy 未安装,正在安装...")
import subprocess
subprocess.check_call([sys.executable, "-m", "pip", "install", "numpy"])
import numpy
print("numpy 安装成功,版本:", numpy.__version__)
F5,或点击左侧「运行和调试」→「运行并调试」,选择「Python 文件」。终端输出类似以下内容(无报错,能显示 Python 版本和 numpy 版本):
Python 版本: 3.11.9 (main, Apr 19 2024, 16:39:15) [MSC v.1938 64 bit (AMD64)]
Python 路径: C:\Users\XXX\miniconda3\envs\python311\python.exe
numpy 版本: 1.26.4
如果能正常输出,说明 Conda + VSCode + Python 环境配置成功!
conda 提示「不是内部或外部命令」C:\Users\你的用户名\miniconda3 和 C:\Users\你的用户名\miniconda3\Scripts)。Ctrl+Shift+P →「Python: 选择解释器」→「输入解释器路径」→ 找到 miniconda3/envs/你的环境名/python.exe(Windows)或 miniconda3/envs/你的环境名/bin/python(macOS)。conda install pandas(优先用 conda 安装,兼容性更好)。pip install pandas(如果 conda 没有该包)。Set-ExecutionPolicy RemoteSigned -Scope CurrentUser,按提示输入 Y 回车,再重新激活环境。核心流程回顾:
按照这个步骤,初学者也能快速搭建稳定的 Python 开发环境,后续开发不同项目时,只需创建新的 Conda 环境(conda create -n 新项目名 python=3.11),即可避免依赖冲突。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
使用加密算法(如AES、TripleDES、Rabbit或RC4)加密和解密文本明文。 在线工具,加密/解密文本在线工具,online
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online