Windows 系统下为 VSCode 配置 Anaconda 环境配置全攻略

摘要：本文为 Windows 用户提供了一份从零开始、手把手配置 VSCode 与 Anaconda 开发环境的完整指南。文章详细讲解了软件下载安装、环境变量配置、虚拟环境管理、国内镜像源设置以及 VSCode 深度集成的每一步操作，并重点标注了安装路径选择、权限规避、环境变量优先级等关键细节与常见避坑点。通过遵循本指南，读者可以一次性成功搭建稳定高效的 Python 开发环境，避免配置过程中的反复折腾。

前言

在数据科学和Python开发领域，Visual Studio Code（VSCode）与Anaconda的组合已成为众多开发者的首选环境。然而，对于初学者而言，将这两者完美结合却常常充满挑战——从安装路径选择、环境变量配置到VSCode集成调试，每一步都可能遇到意想不到的“坑”。

本文旨在为Windows用户提供一份零基础、手把手的完整配置指南。我们将从最基础的软件下载安装开始，逐步深入到环境变量设置、虚拟环境管理、镜像源配置，直至VSCode的深度集成与调试验证。更重要的是，文中将重点标注那些容易被忽略的关键细节和常见避坑点，确保您能够一次性成功配置，避免反复折腾。

无论您是刚刚接触Python编程的新手，还是希望优化现有开发环境的中级开发者，本文都将为您提供清晰、实用的操作指引，助您快速搭建起稳定高效的开发环境，让技术学习之路更加顺畅。

VSCode 配置 Anaconda 环境全流程

下载并安装 VSCode

打开 VSCode 官网下载链接 Download Visual Studio Code - Free AI Code Editor for Mac, Linux, Windows，下载并安装对应电脑系统的版本（本文以 Windows 系统为例）。

下载并安装 Anaconda

1. 下载安装程序

打开 Anaconda 官网链接 Download Anaconda Distribution | Anaconda。

注册好邮箱并登录后，点击右上方的 Download，选择 Windows 版本下载。

2. 运行安装程序

在系统下载包里打开安装程序，依次点击 Next、I Agree、All Users。

下一步下载路径，重点：一定要自己在 D 盘创建一个路径文件！一定不要选择系统自动跳出的 C:\ProgramData 路径，这是系统隐藏保护文件夹，普通用户直接双击打不开、无修改权限，Windows 对 ProgramData 文件夹有权限拦截，VSCode 读取、终端调用都会受限。D 盘不受强制管控，切换和调用都会稳定很多。

图片说明：图中红框标注的是安装路径选择界面。请务必点击“Browse”按钮，手动选择或创建 D 盘下的自定义文件夹（如 D:\Anaconda3），不要使用默认的 C:\ProgramData\Anaconda3 路径。这一步是避免后续权限问题的关键操作。

之后的三个选项可以全部勾选，特别是中间的 Register Anaconda3 as my default Python 3.13 一定要勾选，Windows 系统会把 Anaconda 里的 Python 登记到系统注册表，VSCode 能自动识别到这个环境并调用，十分方便。完毕后点击下方 Install 安装。

3. 在 Windows 系统内配置环境变量

修改名称为 Path 的变量，按照 Anaconda 在电脑中的安装顺序将以下几个文件夹路径依次写入，一条路径占一行。

图片说明：图中箭头指向的是系统环境变量 Path 的编辑界面。需要依次添加以下三个路径（每行一个）：
1. D:\Anaconda3（Anaconda 安装根目录）
2. D:\Anaconda3\Scripts（包含 conda.exe 等可执行文件）
3. D:\Anaconda3\Library\bin（包含动态链接库）
添加后点击“确定”保存，确保 Anaconda 命令可以在任意命令行中调用。

用 Anaconda Prompt 做前置工作

1. 修改 Anaconda 虚拟环境的安装目录

先在 D 盘手动建好 ana_envs、ana_pkgs 两个空文件夹，在 Anaconda Prompt 依次执行下面三行：

conda config --add envs_dirs D:/ana_envs
conda config --add pkgs_dirs D:/ana_pkgs
conda config --show envs_dirs

最后一行用来校验是否写入成功，会打印你设置的 D 盘路径。

配置完成后输入：

conda info

找到 envs directories，第一条是 D:/ana_envs 即代表默认环境目录改到 D 盘。

2. 配置国内清华镜像源

Conda 默认的官方源服务器在国外，不配置国内镜像源直接使用可能会出现需要使用外网报错、超时等问题。建议配置国内镜像源以提升下载速度。

逐条运行下列命令：

conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/r
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/msys2
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/pytorch
conda config --set show_channel_urls true

完毕后执行查看命令，出现清华镜像链接就是配置成功。

conda config --show

3. 创建环境（Python 3.13 为例）

输入：

conda create -n my_python_env python=3.13

弹出确认提示输入 y 回车等待安装完成。

4. 激活环境

输入：

conda activate my_python_env

激活成功后提示符开头会变成 (my_python_env)，直接输入下面命令，从终端启动 VSCode：

code

修改 json 配置

VSCode 按 Ctrl+, 打开设置，右上角打开 settings.json，在大括号内加入这段配置：

{
  "python.defaultInterpreterPath": "D:\\ana_envs\\my_python_env\\python.exe",
  "python.condaPath": "D:\\ana\\Scripts\\conda.exe",
  "python.terminal.activateEnvironment": true,
  "terminal.integrated.inheritEnv": true
}

按 Ctrl+S 保存文件。

新建项目文件夹并调试

完成上述所有操作后，彻底关闭 VSCode，在 D 盘内新建一个项目文件夹用于调试（不添加项目的话就始终无法调用 Anaconda 环境！）。完成后再次打开 VSCode，查看右下角光标显示的环境是否为 my_python_env。

如果不是，打开命令面板，输入：Python: Select Interpreter，打开后选择 my_python_env。

如果选择后还是没有反应，那只有一个原因：系统环境变量优先级更高，导致 VSCode 优先抓它。这时只能把 C 盘的全局 Python 删除，此时电脑只剩 conda 的 Python，不会串版本。

最后，在新建的项目文件夹中添加一个测试文档，随意输入运行代码后测试。如果运行结果显示的是 D 盘的 Conda 路径，那就成功啦！

总结

通过本文的详细步骤，我们完成了在 Windows 系统下为 VSCode 配置 Anaconda 环境的全过程。关键配置点包括：1）将 Anaconda 安装到 D 盘非系统路径以避免权限问题；2）通过 Anaconda Prompt 设置虚拟环境目录和国内镜像源；3）在 VSCode 的 settings.json 中正确配置 Python 解释器和 Conda 路径；4）创建项目文件夹并验证环境切换。成功标志是：VSCode 右下角显示正确的 Conda 环境名称，且运行 Python 代码时终端输出显示 D 盘 Conda 路径。掌握这些配置技巧，能让你在数据科学和 Python 开发中拥有稳定、高效的开发环境。