
Vivamus non augue mauris amet
2015年12月10日
Sa-Token 深度评测:本地源码构建 Docker 实测,14 项鉴权接口全过、压测 3718 QPS,九维评分 8.7
2026年11月21日安装 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
- 双击下载的
.exe文件。 - 勾选 “Add Miniconda to my PATH environment variable”(虽然显示红色警告,但初学者推荐勾选,方便在命令行直接使用)。
- 选择 “Just Me”。
- 安装路径建议默认(如
C:\Users\你的用户名\miniconda3)。 - 点击 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 解释器(关键步骤!)
- 打开一个 Python 项目文件夹(或新建一个
.py文件)。 - 按快捷键打开命令面板:
- Windows/Linux:
Ctrl + Shift + P - macOS:
Cmd + Shift + P
- Windows/Linux:
- 输入并选择:
Python: Select Interpreter - 在下拉列表中,找到类似路径并选中:
- Windows:
~\miniconda3\python.exe - macOS/Linux:
/Users/xxx/miniconda3/bin/python
- Windows:
✅ 成功标志:选中后,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 之旅了。

