【AI开发笔记】最新Miniconda+VSCode安装指南

Vivamus non augue mauris amet
2015年12月10日
Sa-Token 深度评测:本地源码构建 Docker 实测,14 项鉴权接口全过、压测 3718 QPS,九维评分 8.7
2026年11月21日
Vivamus non augue mauris amet
2015年12月10日
Sa-Token 深度评测:本地源码构建 Docker 实测,14 项鉴权接口全过、压测 3718 QPS,九维评分 8.7
2026年11月21日
Show all

【AI开发笔记】最新Miniconda+VSCode安装指南

安装 Miniconda + VS Code 是 Python 开发(尤其是数据科学、AI、机器学习)的黄金组合。下面为您提供一份 2026年最新、清晰、零基础友好 的详细安装指南,适用于 Windows / macOS / Linux 三大系统。

✅ 最终目标

  • 安装 Miniconda(轻量版 Conda,管理 Python 环境)
  • 安装 VS Code(强大的代码编辑器)
  • 在 VS Code 中正确调用 Conda 环境,实现代码高亮、调试、智能提示

第一步:安装 Miniconda

🔽 下载地址:
官方下载页:https://docs.conda.io/en/latest/miniconda.html

系统 推荐版本
Windows Miniconda3 Windows 64-bit(.exe 安装包)
macOS (Intel) Miniconda3 macOS Intel x86_64
macOS (M1/M2/M3) Miniconda3 macOS Apple M1 64-bit
Linux Miniconda3 Linux 64-bit(.sh 脚本)

🛠️ 安装步骤

▶ Windows

  1. 双击下载的 .exe 文件。
  2. 勾选 “Add Miniconda to my PATH environment variable”(虽然显示红色警告,但初学者推荐勾选,方便在命令行直接使用)。
  3. 选择 “Just Me”。
  4. 安装路径建议默认(如 C:\Users\你的用户名\miniconda3)。
  5. 点击 Install → Finish。
▶ macOS

打开终端(Terminal),运行以下命令(以 Apple Silicon 为例):

# 下载
curl -O https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-arm64.sh

# 安装
bash Miniconda3-latest-MacOSX-arm64.sh

按提示回车 → 输入 yes → 使用默认路径 → 最后输入 yes (针对 conda init) → 务必关闭并重启终端。

▶ Linux

wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
bash Miniconda3-latest-Linux-x86_64.sh
# 同样按提示操作,最后确保运行了 conda init

✅ 验证安装

打开终端(Terminal)或命令提示符(CMD/PowerShell),输入:

conda --version
python --version

应显示类似:conda 24.5.0 和 Python 3.11.9。

第二步:安装 VS Code

🔽 下载地址:https://code.visualstudio.com/Download

  • Windows/macOS:下载安装包后一路默认安装即可。
  • Linux:根据发行版选择 .deb / .rpm / tar.gz 进行安装。

第三步:配置 VS Code 使用 Miniconda

1. 安装关键插件

打开 VS Code → 点击左侧扩展商店图标(Extensions)→ 搜索并安装:

Python (by Microsoft) 必装!核心支持
Pylance (by Microsoft) 强烈推荐,提供智能补全
Jupyter (by Microsoft) 如果需要运行 .ipynb 笔记本

2. 设置 Python 解释器(关键步骤!)

  1. 打开一个 Python 项目文件夹(或新建一个 .py 文件)。
  2. 按快捷键打开命令面板:
    • Windows/Linux: Ctrl + Shift + P
    • macOS: Cmd + Shift + P
  3. 输入并选择:Python: Select Interpreter
  4. 在下拉列表中,找到类似路径并选中:
    • Windows: ~\miniconda3\python.exe
    • macOS/Linux: /Users/xxx/miniconda3/bin/python
✅ 成功标志:选中后,VS Code 底部状态栏左下角会显示当前使用的 Python 版本(如 3.11.9 (‘base’:conda))。

3. (可选)创建独立 Conda 环境

为了避免包冲突,建议为每个项目创建独立环境:

# 1. 创建名为 myproject 的环境,指定 Python 3.11
conda create -n myproject python=3.11

# 2. 激活环境
conda activate myproject

# 3. 安装需要的包
pip install numpy pandas matplotlib

创建后,记得再次按照第2步的方法,在 VS Code 中选择这个新环境的解释器(路径中会包含 envs/myproject)。

第四步:测试是否成功

在 VS Code 中新建 test.py,输入以下代码:

import sys
print("Python 路径:", sys.executable)
print("Conda 环境已成功集成!")

右键编辑区 → 选择 “Run Python File”(在终端运行)。
如果输出显示了 miniconda 的路径,恭喜你,环境搭建成功!🎉

🎯 常见问题解决 (Q&A)

问题 解决方案
VS Code 找不到 Conda 环境 重启 VS Code;或者使用 Python: Select Interpreter 手动浏览并指定 python.exe 路径。
终端中 conda 命令无效 重新运行安装时的 conda init 命令,然后必须重启终端窗口。
国内安装/下载包慢 使用清华镜像源加速:
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/

✅ 总结:你的开发环境已就绪!
现在你可以随时安装 PyTorch、TensorFlow、OpenCV 等库,开始你的 AI 之旅了。

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注