当前位置：首页 > news >正文

小白零基础教程：安装 Conda + VSCode 配置 Python 开发环境

news 2025/11/10 10:02:06

小白零基础教程：安装 Conda + VSCode 配置 Python 开发环境

前言

本教程专为电脑小白设计，全程无复杂术语，步骤详细到每一步点击，覆盖 Windows 10/11、macOS 系统（Linux 可参考 macOS 终端操作）。核心目标：安装轻量版 Conda（Miniconda）→ 配置 Conda 环境 → VSCode 关联 Conda 运行 Python，解决「环境冲突」「命令找不到」「解释器选不到」等常见问题。

一、准备工作

操作系统：Windows 10/11（64 位）或 macOS（Intel/M1/M2 均可）
网络：确保能访问官网（或用国内镜像）
清理旧环境（可选）：如果之前装过 Python 或 Anaconda，建议先卸载（避免冲突），卸载后重启电脑

二、第一步：安装 Miniconda（推荐轻量版）

Conda 是「包管理器 + 环境管理器」，Miniconda 是 Conda 的轻量版本（仅含核心功能，不预装大量冗余包），小白首选。

1. 下载 Miniconda

打开官网下载页（不用注册，直接下载）：👉 Miniconda 官网下载

根据系统选择对应安装包：

Windows 10/11：选「Miniconda3 Windows 64-bit」（.exe 文件）
macOS（Intel 芯片）：选「Miniconda3 macOS Intel x86 64-bit」（.pkg 文件）
macOS（M1/M2 芯片）：选「Miniconda3 macOS Apple M1/M2 64-bit pkg」（.pkg 文件）

国内用户如果下载慢：用清华镜像站下载（版本同步官网）👉 清华镜像 Miniconda，找到对应系统的最新版本即可。

2. 安装 Miniconda（关键步骤！）

（1）Windows 系统安装

双击下载的 .exe 安装包，点击「Next」→ 勾选「I agree」→「Next」。
选择安装类型：推荐「Just Me」（仅当前用户使用，无需管理员权限，避免后续权限问题）→「Next」。
选择安装路径：建议默认路径（如 C:\Users\你的用户名\miniconda3），不要改到中文路径（比如「我的软件」这种，会导致命令报错）→「Next」。
「Advanced Installation Options」（重点！）：
- 勾选第一个：「Add Miniconda3 to my PATH environment variable」（添加到环境变量，小白必勾！否则终端找不到 conda 命令）
- 第二个可选勾选（默认即可）：「Register Miniconda3 as my default Python 3.11」（设为默认 Python）
- 点击「Install」，等待安装完成（约 1-2 分钟）。
安装完成后，取消勾选「Learn more about Anaconda Cloud」，点击「Finish」。

（2）macOS 系统安装

双击下载的 .pkg 安装包，点击「继续」→「继续」→「同意」→「继续」。
选择安装位置：默认「Macintosh HD」→「继续」。
输入电脑开机密码（授权安装）→ 点击「安装」，等待完成（约 1 分钟）。
安装完成后点击「关闭」即可（macOS 会自动添加环境变量，无需手动操作）。

3. 验证 Conda 是否安装成功

安装完成后，需要确认 conda 能正常使用：

Windows：打开「命令提示符」（CMD）或「PowerShell」（按下 Win 键，输入 CMD 回车）
macOS：打开「终端」（启动台 → 其他 → 终端）

在终端 / CMD 中输入以下命令，按回车：

bash

conda --version

如果输出类似 conda 24.5.0（版本号可能不同），说明安装成功！如果提示「conda 不是内部或外部命令」，回到安装步骤检查是否勾选了「添加到环境变量」（Windows），或重启终端再试（macOS）。

三、第二步：配置 Conda（换源 + 创建虚拟环境）

1. 为什么要配置？

换源：默认源在国外，下载 Python 包（如 numpy、pandas）速度慢，换成国内镜像（清华源、阿里云）能提速 10 倍。
虚拟环境：隔离不同项目的依赖（比如 A 项目用 Python 3.8，B 项目用 Python 3.11，互不冲突）。

2. 换国内镜像源（复制命令直接执行）

打开终端 / CMD，依次输入以下命令（每输完一条按回车，无需修改）：

（1）添加清华镜像源（推荐）

bash

# 添加 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

（2）验证换源是否成功

输入以下命令，查看配置：

bash

conda config --show-sources

如果输出中包含刚才添加的 https://mirrors.tuna.tsinghua.edu.cn/...，说明换源成功。

3. 创建并激活 Conda 虚拟环境（核心步骤）

我们创建一个名为「python311」的环境（名字可自定义，比如「myenv」），并安装 Python 3.11（稳定版，兼容性好）。

（1）创建环境

在终端 / CMD 输入：

bash

conda create -n python311 python=3.11

conda create：创建环境的命令
-n python311：环境名（可改，比如 -n myfirstenv）
python=3.11：指定 Python 版本为 3.11

执行后会提示「是否安装依赖」，输入 y 按回车，等待安装（换源后速度很快，约 30 秒）。

（2）激活环境

环境创建后，需要「激活」才能使用（激活后终端前缀会显示环境名）：

Windows（CMD）：
bash
```
conda activate python311
```
Windows（PowerShell）：若提示「无法加载脚本」，先执行以下命令（允许执行脚本），再激活：
bash
```
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
```
按提示输入 Y 回车，再执行 conda activate python311。
macOS（终端）：
bash
```
conda activate python311
```

（3）验证环境激活成功

激活后，终端前缀会变成 (python311) C:\Users\XXX>（Windows）或 (python311) XXX@MacBook ~ %（macOS），说明当前处于「python311」环境中。

再输入以下命令，查看当前 Python 路径：

bash

where python  # Windows 用这个
# 或
which python  # macOS 用这个

输出路径应包含「miniconda3/envs/python311」（比如 C:\Users\XXX\miniconda3\envs\python311\python.exe），说明使用的是虚拟环境中的 Python，而非系统自带的。

（4）常用 Conda 命令（记 3 个就够了）

命令	作用
`conda activate 环境名`	激活指定环境
`conda deactivate`	退出当前环境
`conda env list`	查看所有已创建的环境
`conda remove -n 环境名 --all`	删除指定环境（谨慎使用）

四、第三步：安装 VSCode 并配置 Python

VSCode 是免费、轻量、强大的代码编辑器，支持 Python 开发，配合 Conda 环境使用体验极佳。

1. 安装 VSCode

打开 VSCode 官网：👉 VSCode 官网下载
下载对应系统的安装包（Windows 选 .exe，macOS 选 .dmg），默认安装即可：
- Windows：双击 .exe，勾选「添加到 PATH」（可选），点击「下一步」→「安装」。
- macOS：双击 .dmg，将「Visual Studio Code」拖到「应用程序」文件夹中。

2. 安装 Python 相关插件（必装）

打开 VSCode，点击左侧「扩展」图标（或按 Ctrl+Shift+X/Cmd+Shift+X），搜索以下插件并安装：

Python（微软官方插件，必装）：提供 Python 语法高亮、代码提示、运行调试功能。
Pylance（微软官方插件，必装）：增强 Python 代码提示，支持类型检查。
Code Runner（可选，推荐）：一键运行代码，不用手动输命令。

安装完成后，点击插件旁的「启用」（默认已启用），重启 VSCode 生效。

3. 关联 Conda 虚拟环境（关键！让 VSCode 用 Conda 的 Python）

这一步是核心：让 VSCode 识别到我们刚才创建的「python311」环境，避免用系统自带的 Python 导致依赖冲突。

步骤 1：打开一个 Python 文件

新建一个文件夹（比如「PythonProjects」），用来存放你的 Python 项目（路径不要有中文！）。
打开 VSCode，点击「文件」→「打开文件夹」，选择刚才新建的「PythonProjects」文件夹。
点击左侧「资源管理器」→ 右键文件夹 →「新建文件」，命名为 test.py（后缀必须是 .py）。

步骤 2：选择 Conda 解释器

打开 test.py 文件，点击 VSCode 左下角的「选择解释器」（或按 Ctrl+Shift+P/Cmd+Shift+P，输入「Python: 选择解释器」回车）。
在弹出的列表中，找到「Python 3.11.x ('python311')」（后面会显示 Conda 环境的路径，比如 miniconda3/envs/python311/bin/python 或 miniconda3\envs\python311\python.exe），点击选择。

若找不到 Conda 环境？解决方案：点击「输入解释器路径」→「查找」，导航到 Miniconda 安装目录下的 envs/python311/python.exe（Windows）或 envs/python311/bin/python（macOS），选中即可。

步骤 3：验证解释器是否正确

选择完成后，左下角会显示「Python 3.11.x ('python311')」，说明已关联成功！

五、第四步：测试是否能正常运行 Python 代码

现在我们写一段简单的代码，测试整个环境是否能正常工作：

在 test.py 文件中输入以下代码：

python

运行

# 测试 Python 版本和 Conda 环境
import sys
print("Python 版本：", sys.version)
print("Python 路径：", sys.executable)
# 测试安装第三方包（比如 numpy）
try:import numpyprint("numpy 版本：", numpy.__version__)
except ImportError:print("numpy 未安装，正在安装...")import subprocesssubprocess.check_call([sys.executable, "-m", "pip", "install", "numpy"])import numpyprint("numpy 安装成功，版本：", numpy.__version__)

运行代码（两种方式任选）：
- 方式 1（Code Runner 插件）：点击右上角的「运行」图标（▶️），或右键代码编辑区 →「Run Code」。
- 方式 2（VSCode 自带运行）：按 F5，或点击左侧「运行和调试」→「运行并调试」，选择「Python 文件」。

成功标志：

终端输出类似以下内容（无报错，能显示 Python 版本和 numpy 版本）：

plaintext

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 环境配置成功！

六、常见问题排查（小白必看）

1. 终端输入 `conda` 提示「不是内部或外部命令」

Windows：安装时没勾选「Add Miniconda3 to PATH」→ 重新运行安装包，到「Advanced Options」步骤勾选该选项；或手动添加环境变量（路径：C:\Users\你的用户名\miniconda3 和 C:\Users\你的用户名\miniconda3\Scripts）。
macOS：重启终端即可（安装时自动添加环境变量）。

2. VSCode 找不到 Conda 解释器

确认 Conda 环境已激活（终端前缀有环境名）。
手动指定路径：按 Ctrl+Shift+P →「Python: 选择解释器」→「输入解释器路径」→ 找到 miniconda3/envs/你的环境名/python.exe（Windows）或 miniconda3/envs/你的环境名/bin/python（macOS）。