最近项目组来了几个新人几乎每个人都在问同一个问题Anaconda和VSCode到底怎么装装完后又该怎么配置。我仔细一问发现大多数人不是不会点“下一步”而是不清楚这两个软件在Python开发里各自扮演什么角色装到一半就卡住了。这篇就把Anaconda和VSCode的安装流程从头到尾理一遍把我这几年装环境踩过的坑、总结出来的习惯一并写出来不管你是刚接触Python的大学生还是想换一套更顺畅的开发工具的职场人按着步骤走基本都能顺利搞定。1. 为什么是Anaconda加VSCode而不是其他组合先别急着下载先把这套组合的逻辑搞清楚。很多人一上来就装软件装完之后发现命令行里输什么都是“不是内部或外部命令”原因就是没理解Anaconda和VSCode的分工。简单来说Anaconda负责提供Python解释器和包管理VSCode负责让你写代码时有个好用的编辑器。两个东西各管一摊合在一起就是目前最省心、最省钱的一套Python开发方案。1.1 Anaconda到底是什么解决什么问题先说Anaconda。它不是Python本身而是一个Python发行版通俗讲就是“预装了很多常用配件的一套Python”。装上它之后你的电脑里就有了Python解释器还附带了一个叫conda的包管理工具以及numpy、pandas、matplotlib等一大堆科学计算和数据分析常用的库。如果没有Anaconda你装完官方Python之后还要一个个手动去pip install而且还会遇到各种版本冲突的问题。Anaconda最核心的价值是虚拟环境。这个可以这样理解你有三个项目项目A要用Python 3.8搭配TensorFlow 1.x项目B要用Python 3.10搭配新版PyTorch项目C只装了个requests写点爬虫。如果没有环境隔离这三个项目塞在同一个Python环境里早晚要打架。Anaconda的虚拟环境就是在你电脑里画出一个个独立的小房间每个小房间有自己的Python版本和依赖库互不干扰用哪个就激活哪个非常清爽。1.2 VSCode在Python开发里的定位VSCode一般被归到“轻量级代码编辑器”这一档和Notepad、Sublime Text是一类但它通过插件系统实际用起来已经接近IDE集成开发环境的体验。尤其是装好Python插件之后代码补全、断点调试、Git版本管理、Jupyter Notebook这些功能全都有了。为什么不是PyCharmPyCharm专业版要收费社区版虽然免费但一些功能被砍掉了VSCode完全免费启动速度也比PyCharm快不少电脑配置一般也能跑得很流畅。为什么不是自带的IDLE这个不用我多说但凡写过超过一百行代码的人都不会想回去了连个像样的调试器都没有代码补全也基本等于没有。所以我的结论很明确如果你要专心做Python开发Anaconda加VSCode是性价比最高的入门配置。Anaconda管好背后的运行环境VSCode管好写代码的前台体验分工明确、故障点少。1.3 这套组合对比其他方案的优劣势我把常见方案放在一个表格里对比方便你根据自己的情况选方案费用环境管理内存占用上手难度适用场景Anaconda VSCode全免费conda 虚拟环境很强较低中等数据分析、机器学习、日常Python开发PyCharm社区版社区版免费需要自己配解释器较高偏高有团队协作需求、喜欢完整IDE体验的人官方Python IDLE全免费无极低极低只写几十行小脚本、学习语法阶段官方Python VSCode全免费无需自己用venv较低中等不想要Anaconda巨大体积、喜欢手动管理环境的人从表里能看出来Anaconda加VSCode最大的优势是环境管理能力很强这对Python开发来说是刚需。代价是Anaconda安装包比较大占了几个G的磁盘空间而且导入依赖的时候比较慢。如果你只是偶尔写点小脚本完全可以用官方Python加VSCode但如果你要长期做项目我建议还是直接上Anaconda省得后面被环境问题折磨。2. Anaconda安装全流程从下载到环境验证这一部分是重点安装过程中的几个选择会直接影响你后面用起来顺不顺手所以我尽量把每一步背后“为什么”也讲清楚。2.1 下载前必须确认的三件事下载之前先确认你的系统情况不然装到一半发现版本不对就白忙活了。第一确定操作系统是Windows、macOS还是Linux。Windows用户最多后面的步骤主要以Windows为例macOS和Linux的差异我会在关键地方提一下。第二确认系统是64位还是32位。现在的电脑基本都是64位但如果你还在用很老的电脑右键“此电脑”属性里看一眼系统类型。Anaconda现在对32位的支持已经很少了如果发现自己是32位系统建议换台电脑或者直接装Miniconda这种更轻量的。第三确定下载哪个版本。Anaconda安装包的命名一般是Anaconda3-2024.10-1-Windows-x86_64.exe这种格式其中Anaconda3表示它对应的Python是3.x版本。现在Python 2已经停止维护了看到任何Anaconda2的包都不要下。版本号选最新的稳定版就行一般发布日期越新越好但不要选带beta、rc这类字样的测试版。2.2 官网下载与国内镜像源的正确使用方式Anaconda官网入口是anaconda.com/download但很多人打开官网找不到直接下载的按钮因为页面经常改版。我习惯直接走官网下方的“Previous builds”或者跳转到repo.anaconda.com/archive/这个目录里面按字母顺序排列了所有历史版本找Anaconda3-2024.10-1-Windows-x86_64.exe这种文件下载目录结构很清楚。但这里有个很现实的问题Anaconda的安装文件有好几百MB官网的服务器在国外很多国内用户下载速度很难受试过几次下载到一半直接断掉。遇到这种情况建议直接用清华大学开源软件镜像站地址是mirrors.tuna.tsinghua.edu.cn/anaconda/archive/进去之后同样按版本号找对应文件下载。镜像站的内容和官网是同步的版本号对得上下载体验通常好很多。下载的时候有两点提醒一是在浏览器里看清楚文件大小一般这个exe文件应该有500MB到1GB之间如果下载下来只有几十KB那肯定是下载中断或者下载到了网页而不是安装包二是不要用各种来路不明的下载站那些地方经常捆绑全家桶装了一个游戏盒子或者浏览器导航出来清理起来能让你怀疑人生。认准官网和清华镜像这两个渠道就够了。2.3 安装过程中的关键选项详解双击exe安装包之后一路Next到了几个关键弹窗这几个地方很多人迷迷糊糊就点过去了最后出了问题又来问为什么。我逐个说清楚。第一步会问License Agreement直接点I Agree。第二步会问安装给谁用一般选“Just Me”就行。选All Users需要管理员权限而且之后很多操作都容易弹UAC权限提示很烦。自己开发使用Just Me足够了。第三步是选择安装路径这一项很重要。默认路径通常是C:\Users\你的用户名\anaconda3或者C:\ProgramData\Anaconda3。我的建议是改成D:\Anaconda3这样的简单目录理由有三条一是不要带中文路径否则后续很多第三方库编译报错会让人崩溃二是路径中不要有空格像Program Files这种带空格的目录虽然现在大部分工具能处理但偶尔会踩到老库的坑三是放在D盘可以避免C盘容量不够Anaconda随随便便就能占掉好几个G。第四步是Advanced Options这里就是最容易出错的地方。界面上有两个选项Add Anaconda3 to my PATH environment variable。官方推荐不勾选我个人的习惯也是不勾。勾选之后确实在cmd里直接输入conda就能用但它会把Anaconda的Python环境注册到全局PATH里如果系统里原来装过别的Python版本很容易出现“python命令进的不知道是哪套环境”的混乱局面。不勾选的话后续用Anaconda Prompt或者VSCode里的终端一样可以正常使用conda命令而且不会污染全局环境。所以这里我的建议是不勾。Register Anaconda3 as my default Python。这个建议勾上除非你这台电脑上有老项目必须依赖原来某个指定版本的Python。勾选后系统里默认的Python就指向Anaconda自带的解释器VSCode等工具会自动识别到它省去手动配置的麻烦。选完这些点击Install就开始装了。Anaconda安装包体积大解压和写入文件需要一段时间5到10分钟都算正常耐心等进度条走完不要中途觉得卡了就强行关闭。2.4 安装完成后的环境验证安装完成后在Windows开始菜单里能找到新增的Anaconda3 (64-bit)文件夹里面有Anaconda Prompt、Anaconda Navigator、Jupyter Notebook等快捷方式。先打开Anaconda Prompt这个终端会自动初始化conda的环境变量在里面输入conda --version如果看到类似conda 24.9.2这样的版本号说明核心安装成功。再输入python --version出现Python 3.12.7之类的版本号说明Anaconda自带的解释器也可以正常工作。然后可以试一下conda env list这个命令会列出当前所有虚拟环境默认应该只有一个base环境。可以顺带创建一个测试环境练练手conda create -n test_env python3.10 conda activate test_env conda deactivate这一步如果成功说明虚拟环境功能正常。创建环境的时候conda会联网下载Python包如果速度慢或者失败后面第4部分会讲怎么换镜像源现在先不用管。另外打开Anaconda Navigator的时候有个很常见的现象窗口一直停在loading applications转圈。这通常是它在联网检查更新网络情况不好时就会卡很久。不需要干等着直接用命令行操作就够Navigator只是个图形界面入口而已。3. VSCode安装与Python环境对接Anaconda装好之后你的电脑已经有了一整套可以运行的Python环境但还没有一个好用的写代码工具。接下来装VSCode并且把两者对接起来这一步做对了写代码的体验才会顺。3.1 VSCode下载安装要点VSCode的官网是code.visualstudio.com页面顶部明显位置就是下载按钮选择Windows版本下载现在的安装包是一个几十MB的exe下载很快。安装过程中的选项我建议这样勾选“添加到PATH”这个建议勾上这样后续在命令行里输code就能直接打开VSCode。“在资源管理器目录上下文菜单中添加Open with Code”也建议勾上方便在文件夹上右键直接打开VSCode。“在桌面添加图标”看个人喜好。其他选项默认即可。安装过程很快装完第一次启动会默认打开欢迎页。如果你希望界面是中文先别急着用切换语言是需要装插件来实现的。在左侧活动栏找到扩展图标方块形状搜索Chinese找到“Chinese (Simplified) Language Pack for Visual Studio Code”这个插件安装后右下角会提示重启重启后界面就变成中文了。这一步操作很简单很多教程却放在很后面才讲我建议装完VSCode第一件事就做后面看配置项会轻松很多。3.2 必装插件清单与几个高热度插件的使用场景VSCode的精髓在插件但插件不是装得越多越好。Python开发场景下有几样是必须装的Python发行方ms-python这是Python开发的核心插件提供语法高亮、代码补全、运行调试功能。安装完Python插件后VSCode才会在运行Python代码时给出完整的交互。Pylance发行方ms-python类型检查和更强大的智能提示现在装Python插件时会默认一起装不用单独操心。Jupyter发行方ms-jupyter如果你要写Notebook这个是必装的。Anaconda里自带的Jupyter可以在VSCode里直接打开运行体验比网页版流畅不少。Chinese Language Pack刚才说的汉化包。还有一些插件属于“按需安装”的说几个最近热度比较高的。Codex插件和Trae这类AI编程助手装上之后可以在编辑器里跟AI对话让AI直接帮忙生成或者修改代码现在很多人用来做快速原型验证聊天模式和构建模式都可以在侧边栏直接用。如果你注意到现在VSCode里很多人讨论AI辅助开发基本都是这一类插件。它们不是刚需但体验一下无妨。另外如果之后要做C/C开发装C/C扩展发行方ms-vscode再配好编译器就行如果经常远程连服务器Remote - SSH插件很有用如果电脑上装了WSL子系统装WSL插件之后可以直接在VSCode里写Linux环境下的代码热词里的“在vscode中使用wsl”指的就是这个场景。3.3 把VSCode指向Anaconda的解释器装好Python插件之后VSCode默认是不知道你的Python解释器在哪里的需要手动指定一下。这个步骤的重要性我再强调一遍如果跳过了VSCode可能会去系统里找一个没装任何库的Python然后你明明用conda装了pandas运行代码却报ModuleNotFoundError到时候排查起来非常困惑。操作流程很简单打开VSCode新建一个Python文件后缀是.py。按Ctrl Shift P打开命令面板输入Python: Select Interpreter回车。在弹出的列表里会看到Anaconda相关的Python解释器通常显示为类似Python 3.12.7 (base: conda)的路径路径里包含anaconda3字样。选中它。如果列表里没有选择“Enter interpreter path”手动浏览到D:\Anaconda3\python.exe按你实际的安装路径找。选好之后VSCode底部状态栏会显示当前的Python版本。为了确认没选错可以写一行代码测试import sys print(sys.executable)运行后输出的路径如果指向Anaconda3目录说明对接成功。如果想在具体某个conda虚拟环境里开发先用命令行创建并激活环境然后在解释器选择列表里选对应环境路径下的python.exe一般在D:\Anaconda3\envs\你的环境名\python.exe。之后VSCode里运行的代码就都在这个虚拟环境里执行了项目隔离非常干净。3.4 终端与默认Shell的设置VSCode集成了终端功能快捷键是Ctrl 键盘上数字1左边的那个键不用来回切换窗口就能在编辑器里输入命令。这里有一个坑需要提前说VSCode默认的集成终端是PowerShell而PowerShell对conda命令的支持并不算好。如果你在安装Anaconda时没有勾选“Add to PATH”在VSCode的PowerShell终端里输入conda会提示“无法识别conda”然后在激活conda环境时还可能碰到一堆执行策略的警告提示。办法有两个。第一个是直接把默认终端换成Anaconda Prompt在VSCode终端右上角点下拉箭头选择“配置默认配置文件”把Anaconda Prompt设为默认重新打开终端即可。第二个是你坚持用PowerShell那就需要先解除PowerShell的执行策略限制后面常见问题部分会详细写命令。如果你平时会用WSL也可以把VSCode左下角的绿色箭头点一下选择“在WSL中重新打开”这样VSCode会连到WSL子系统里Python解释器就选Linux环境下安装的Anaconda适合项目依赖Linux环境的场景。这个用熟悉之后会很方便但新手可以先跳过。4. 常见问题与排查技巧实录环境装得多了什么问题都见过。我把读者问得最多、网上资料往往又讲不清楚的几个典型问题整理出来做成一个速查表再挑几个重点问题详细展开。这些问题如果你遇到一个按对应办法基本都能解决。4.1 常见报错速查表现象可能原因解决方法输入conda提示“不是内部或外部命令”PATH环境变量没配置用Anaconda Prompt代替cmd或手动把Anaconda相关目录加进PATHNavigator一直卡在loading applications联网检查更新被卡住断网启动、耐心等待或者直接不用Navigator用命令行pip安装包速度特别慢默认源在国外配置国内镜像源见4.2VSCode运行Python时报No interpreter没有选择解释器CtrlShiftP选择Python: Select InterpreterPowerShell激活conda环境时出现warning this p...PowerShell执行策略限制脚本运行执行Set-ExecutionPolicy命令解除限制卸载重装Anaconda后开始菜单还有旧入口卸载不彻底用anaconda-clean清理后再卸载见4.3VSCode右上角一直提示选择解释器但选了没用插件未生效或缓存重载窗口CtrlShiftP输入Reload Window4.2 conda命令找不到与PowerShell执行策略的处理“conda不是内部或外部命令”这个问题高发人群是安装时没勾Add to PATH然后在普通cmd里敲conda的人。解决办法有三种按简单到复杂排列最简单以后都用开始菜单里的Anaconda Prompt。它启动时会自动加载Anaconda环境变量输入conda一定能识别。较直接在cmd里手动执行D:\Anaconda3\Scripts\activate.bat改成你的实际路径这样当前这个cmd窗口就临时有了conda环境但关掉窗口就失效。一劳永逸手动将D:\Anaconda3、D:\Anaconda3\Scripts、D:\Anaconda3\Library\bin三个目录添加到系统环境变量Path中。右键“此电脑”-“属性”-“高级系统设置”-“环境变量”在用户的Path里新建三条路径就行。不过我不太推荐新手手动改环境变量改错了影响面很大不如直接用Anaconda Prompt更干净。再说PowerShell激活环境时的warning问题。使用conda activate激活虚拟环境时PowerShell经常弹出一段警告内容里带... this p字样大意是脚本无法运行因为系统禁止运行本地PowerShell脚本。这其实是PowerShell默认执行策略把.ps1脚本拦下来了和Anaconda本身没关系。解决办法是在PowerShell里执行一次Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser然后按提示输入Y确认再重新打开终端警告就不会再出现了。这条命令只对当前用户生效不会影响系统其他安全设置可以放心。4.3 conda与pip的国内镜像源配置技巧如果你在安装包时明显感觉速度无法忍受那大概率是默认源在国外。conda和pip都支持配置国内镜像源我通常用清华大学开源软件镜像站作为首选。给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/free/ conda config --set show_channel_urls yes配置好后创建虚拟环境或者安装包时conda会自动走镜像源下载体验会明显提升。给pip配置镜像源执行pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple这条命令会把pip的默认索引改成清华PyPI镜像之后再pip install xxx就会快很多。有一类问题也算是镜像源带来的镜像站的同步更新会有一定延迟有时候你刚发布了某个包的新版本本地仍然找不到会报404或者找不到版本。这时候不用慌临时绕开镜像装一次就行pip install 某个包 -i https://pypi.org/simple或者干脆把之前配置的conda源清理掉恢复默认conda config --remove-key channels另外强调一句如果之后要配置PyTorch环境在conda虚拟环境里直接执行pip install torch torchvision torchaudio配合国内镜像源就可以安装不需要按官网默认命令硬等。4.4 卸载与重装时的注意事项装了又卸、卸了又装是所有人都经历过的。Anaconda卸载起来比一般软件特殊如果只是跑到控制面板卸载会发现卸载完再装新版各种奇怪问题依然在甚至开始菜单里还留着旧入口。正确的卸载流程是这样的在Anaconda Prompt里执行conda install anaconda-clean安装一个清理工具。执行anaconda-clean --yes它会自动备份并清理Anaconda相关的配置文件。回到开始菜单找到Uninstall-Anaconda3按提示完成卸载。手动检查用户目录下有没有残留的.conda文件夹、.anaconda文件夹如果有直接删掉。这套流程走完Anaconda基本上才算真正从电脑上消失。直接删除安装文件夹是最差的做法很容易在注册表和系统PATH里留下无效路径导致之后装新版时一直报一些莫名其妙的错。VSCode的卸载相对简单控制面板卸载就行。但如果你希望重装后是个完全干净的状态还需要手动清理两个位置用户目录下的.vscode文件夹和AppData\Roaming\Code。这两个地方存的是插件和用户配置。如果不删重装完VSCode插件都还在也算是个“保留配置”的小技巧看个人需求。最后再分享一个我自己的习惯每次给新电脑配完这套环境我一定会先建一个常用的默认虚拟环境比如conda create -n dev python3.10然后在VSCode里把默认解释器指过去再顺手把集成终端默认配置文件换成Anaconda Prompt。这套组合固定下来之后后面写代码基本不会再被环境问题打断。如果你在安装过程中已经遇到了这上面没写到的问题别急着怀疑自己大概率就是路径、执行策略或者源这三个原因里的某一个对照表格排查一遍就能解决。