ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

新手学Python必装9款工具:环境搭建完整避坑指南

新手学Python必装9款工具:环境搭建完整避坑指南 想学Python十有八九会先在装软件这件事上卡壳。去Python官网下了安装包装完双击.py文件发现只是用记事本打开了在命令行里跑脚本又提示python不是内部或外部命令想按教程装个requests库结果迎面一堆红字报错。这些场景我太熟了刚入行时每一个坑都踩过。所以这篇不聊虚的直接讲清楚新手学Python到底该装哪些软件、每个软件承担什么角色、装的时候要避开哪些坑。我写Python十几年下面这9个软件是按最小必要原则加未来发展空间挑出来的不是为了凑数每一个都有它的用处。1. 先搞懂一件事学Python为什么光装Python不够Python本身是一个解释器它的职责是把人写的代码翻译成计算机能执行的指令。但你要在这个解释器上舒服地写代码、跑代码、调代码背后还需要一整套配套工具。打个比方买车不能只买一台发动机还得有方向盘、仪表盘、导航甚至一套备用轮胎。Python的工具链也是这个道理解释器解决的是代码在哪里运行编辑器解决的是代码怎么写才顺手包管理器解决的是第三方库怎么装、怎么隔离版本控制解决的是改坏了怎么回退浏览器开发者工具则帮你理解网页请求是玩爬虫的瞭望台。1.1 我见过太多新手倒在环境这道门槛上我带过不少完全零基础的朋友学Python发现一个规律真正劝退他们的往往不是语法而是环境配置。有人装完Python不知道在哪里写代码有人跟着教程配置了vscode python环境配置结果切换项目时解释器又跑偏了有人在群里问pip不是内部或外部命令一查是安装时没勾选Add Python to PATH。这些问题的根源都是只把Python当成了一个孤立的软件而忽略了它背后那条依赖链。热词里有一条特别典型python was not found; run without arguments to install from the microsoft st...。这是Windows商店版Python闹出的乌龙。系统里多了一个微软商店预置的Python入口看着装了但命令行里根本找不到可用的解释器。这个报错我每隔一段时间就会被朋友截图问一次场面既好笑又辛酸。所以环境搭建不是装一个软件那么简单它是一条完整的工具链。九件套里的每一件都在链条上扮演一个角色。少装一件可能暂时没什么感觉但等需求出现时它就会变成一道坎卡住你半天甚至一天。1.2 三组工具定位运行、编写、管理我的推荐逻辑很简单把工具按用途分成三组。第一组是让Python跑起来的包括Python官方解释器、Anaconda、Jupyter Notebook。解释器是地基Anaconda帮你管理多个互不干扰的Python环境Jupyter让代码可以一小段一小段地边写边跑特别适合学习阶段试错。第二组是让你写代码有趁手的兵器包括PyCharm和VS Code。这两个看着功能重叠但我建议都装因为场景完全不同。PyCharm适合在一个大型项目里专心地写PythonVS Code则轻巧灵活打开单个文件快以后就算不写Python了拿来写前端、写配置文件都能继续用。第三组是帮你管代码、管依赖、管调试的包括pip、Git、Windows Terminal、Chrome开发者工具。pip管理第三方包Git管代码版本Windows Terminal给你一个现代好用的命令行Chrome开发者工具则是学爬虫、看网页请求时最好的助手。这三组工具各司其职基本覆盖了新手未来半年会踩到的所有场景。下面一个一个拆开讲。2. 九件套逐一说透从安装到上手全流程2.1 Python官方解释器地基先打牢第一件要装的是Python官方解释器也就是从python.org下载的安装包。这一步看着简单很多人的坑就从这里开始。版本怎么选我建议装当前最新的稳定版现在这个时间点建议3.12或3.13。别跟着网上老教程下3.8太老版本的语法和标准库特性跟不上后面写新代码容易踩坑。如果你确实要跑旧项目那就交给Anaconda里的conda去管理这也是为什么我把Anaconda排在第二位。Windows安装时有几个细节。安装向导第一页最下面有一个Add Python to PATH复选框很多人不知道它是什么意思。如果你确定只用官网这个Python建议勾上后面用命令行方便很多如果计划装Anaconda或Miniconda这个选项可以先不勾以免两个Python的路径在PATH里互相抢优先级。安装类型建议选Install Now保持默认路径路径里不要带中文和空格否则一些老库会出莫名其妙的问题。装完的验证方法很简单打开终端输入python --version如果输出了Python 3.12.x说明装好了。如果提示python不是内部或外部命令多半是PATH没配好如果输入后什么都没输出那就是Windows应用执行别名拦截了去应用执行别名里把python.exe和python3.exe关掉。macOS和Linux用户一般系统自带Python但版本可能偏老我建议用Homebrew或apt装一份较新的版本再明确绑定。2.2 Anaconda新手最省心的环境管家如果说官网Python是一把瑞士军刀Anaconda就是一套组合工具箱。Anaconda是一个Python发行版装完自带numpy、pandas、matplotlib、scikit-learn这些数据科学常用库还内置了conda包管理器和Jupyter Notebook。对于走数据分析、机器学习方向的新手来说它能省掉大量逐个装库的时间。但Anaconda真正的杀手锏是conda的虚拟环境能力。你可以用一行命令创建出一个独立的Python环境里面装任意版本的Python和任意版本的库跟外面的系统环境完全隔离conda create -n myenv python3.12 -y conda activate myenv为什么要这么折腾举个例子项目A要用Python 3.9加Django 3.2项目B要用Python 3.12加Django 5.0。如果全装在一个环境里库和版本会互相打架解Debug的时间比写代码还多。有了虚拟环境每个项目都有自己的小房间互不打扰。这在真实开发中几乎是每天都会用到的基础操作。安装Anaconda时有一个关键选项安装向导里那个Add Anaconda to PATH默认不勾选我建议你也别勾。一旦勾上Anaconda会把Python路径优先级顶到最前面你在命令行输python调用的就会变成Anaconda自带的解释器跟官网解释器产生冲突排查起来非常头大。平时用Anaconda Prompt这个专用终端就行它会自动处理好conda环境。如果嫌完整版Anaconda太大下载要两三个G可以装Miniconda它只有几百兆不带预装库只提供一个conda加一个极简Python。需要什么库再自己装更干净。我给新手的实际建议是先装官网Python再装Miniconda这样既不浪费磁盘也随时能创建需要的环境。2.3 PyCharm写Python最顺手的专业IDEPyCharm是JetBrains出品的Python专用IDE分社区版Community和专业版Professional。专业版支持Django、Flask等Web框架但收费新手和绝大多数独立开发者用社区版完全够了代码提示、调试、重构这些核心功能一个不少关键是免费。为什么Python圈里PyCharm口碑这么好因为它就是为Python量身定做的新建项目时会自动帮你创建虚拟环境venv不用自己敲命令建目录写代码时对标准库和第三方库的智能提示做得特别细按一下ShiftF9就能断点调试能看到每一步变量值的变化。对新手来说调试时可视化地观察代码执行过程比单纯靠print输出感受要直观得多。首次启动PyCharm会让你选择解释器这一步容易踩坑。新手最常见的错误是新建项目时一路默认最后跑代码提示ModuleNotFoundError因为根本没把项目指到正确的Python上。正确做法是File Settings Project Python Interpreter点齿轮添加解释器指向你想用的那个Python。如果是conda环境就在这里选Existing Environment找到对应环境的python.exe路径。有人可能会问我已经装了VS Code还需要PyCharm吗我的看法是两个都装但要有主次。PyCharm适合写课设、写中型项目项目结构清晰、重构工具强大VS Code更适合日常快速打开单个.py文件改个功能或者混着做前端和脚本的时候。成年人不做选择两个都拿下。2.4 VS Code轻量编辑器中的全能选手VS Code已经是目前社区里使用人数最多的编辑器之一了。它本质是一个底座装什么插件就变成什么工具。对Python来说装好微软官方出的Python扩展后它就能提供代码高亮、智能提示、格式化、调试、Jupyter支持等功能完全能满足日常需求。配置vscode python环境配置其实不复杂。装好插件后按CtrlShiftP输入Python: Select Interpreter选择你刚才安装的解释器。这个步骤特别关键很多人插件装了一堆但忘了选解释器结果代码能看懂、就是运行不了就是因为VS Code不知道该用哪个Python。我还建议新手提前在VS Code里设置两个小地方。一是开启保存时自动格式化设置里搜索Format on Save勾上代码会自动变得整齐二是把代码检查工具选为mypy或pylint这样很多类型错误和不规范写法会在写的时候冒波浪线提示而不是等运行才报错。如果你是数据科学方向VS Code里直接打开.ipynb文件就能像Jupyter Notebook一样交互式执行还能连远端服务器改代码。这也是我为什么经常说PyCharm和VS Code不用硬选一个它们一个像工兵铲、一个像瑞士军刀各有各的顺手场景。2.5 Jupyter Notebook交互式学习的独门利器Jupyter Notebook是许多新手迈过敢下手这道坎的最强帮手。它把代码和文字说明混在同一个文档里每个小格子都能单独运行运行结果直接显示在下面。你写一行、跑一行、看一行这种即时反馈对学习曲线非常友好。比如你学matplotlib画图遇到python画图横坐标太密集这种问题搜到一个设置坐标刻度的示例。想验证效果打开Jupyter粘贴代码ShiftEnter运行图形立刻出现在下方改一个参数再跑一次马上看到变化。这种边写边试的节奏比在IDE里反复跑整个脚本要方便得多。安装Jupyter有两种方式装Anaconda的话conda已经帮你带上了如果用官网Python直接执行pip install jupyterlab jupyter lab浏览器会自动打开一个工作台界面。这里提醒一下老版叫Notebook新版叫JupyterLab建议直接用Lab它界面更现代支持多标签、拖拽布局文件管理也更顺手。别在老版导航里纠结。2.6 pip和虚拟环境包管理的必修课热词里那些python安装numpy库的方法、python下载cv2本质都在问同一个工具pip。pip是Python官方自带的包管理工具装好解释器后就有。有了它一条命令可以安装几乎所有第三方库pip install numpy pip install requests pip install opencv-python但新手用pip最常见的两个痛点是下载慢、安装失败。慢是因为默认源在国外解决办法是换国内镜像源。我一直在用清华源一条命令永久生效pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple换完之后再装库速度提升非常明显。如果个别库安装时在编译源码报错可以试试升级pip或者找对应的wheel预编译包。另一个和pip紧密相关的概念是虚拟环境。前文提过conda是Anaconda家的环境管理而官网Python用户更常用venv它是Python 3.3以后内置的模块用法也很简单python -m venv myvenv myvenv\Scripts\activate # Windows # source myvenv/bin/activate # macOS/Linux激活之后你执行的pip install只会装进当前虚拟环境不会污染全局。我自己的习惯是每开一个项目第一件事就是创建虚拟环境并激活。这个卫生习惯能省掉未来数不清的为什么我的环境里多了这个包为什么别人跑不起来的麻烦。2.7 Git给代码上个后悔药Git要不要现在学我的回答很明确要越早越好。它不是等你写了几万行代码才需要的工具新手写作业的时候就应该用上。Git最大的价值是应对这个场景今天改了一下午代码项目完全跑通了第二天早上改了两行结果跑不起来了。没有Git你得靠记忆往回改有Git一条命令回到昨天那个能跑的版本毫无压力。Windows上安装Git很简单去官网下载安装包一路Next即可。装完在文件夹里右键就能看到Git Bash Here打开后运行git init git add . git commit -m 我的第一个Python项目这三条命令已经覆盖日常大部分需求。后面学深了再接触分支、合并、回滚这些高级操作。我还建议新手把代码托管到GitHub或国内的Gitee上一方面是异地备份另一方面这些平台本身就是最大的开源社区你能看到无数优秀项目是怎么组织代码的。如果命令行还不熟可以再装一个GitHub Desktop之类的图形客户端把拉取、提交、推送变成点按钮。工具不是越高级越好先把保存历史版本这件事养成习惯比熟练敲命令重要得多。2.8 Windows Terminal现代终端体验如果你在Windows上写Python还对着那个蓝底白字的旧版cmd我强烈建议换成Windows Terminal。它支持多标签页、自定义主题、快捷键还能同时打开PowerShell、CMD、WSL多个终端在一个窗口里来回切换。虽然很多新手觉得终端是高手才用的东西但pip、conda、git这些命令全要在终端里输入一个舒服的终端能明显改善学习体验。之前有位朋友按我的步骤走到python --version那一步在cmd里敲完发现中文乱码。因为老cmd默认编码是GBK而Python输出的是UTF-8。换成Windows Terminal后配合PowerShell默认就是UTF-8乱码问题基本消失。这类细节点文章里通常不会写但碰上一次就很耽误时间。macOS用户不用额外装自带的Terminal就能用想要体验更好可以试试iTerm2Linux用户一般对终端已经很熟了各发行版自带的终端也都够用。终端是程序员绕不开的工位舒适度很影响长期写代码的心情。2.9 Chrome开发者工具爬虫与调试的隐形助手很多新手入门Python就是被爬虫吸引的python爬虫这个热词的搜索量一直居高不下。爬虫的本质是模拟浏览器向服务器发起请求再解析返回的数据。而Chrome以及同样内核的Edge开发者工具就是帮你看懂网页到底干了什么的神器。打开一个网页按F12会看到详细的调试面板。对爬虫新手来说最常用的三个面板是Elements查看网页的HTML结构方便确定你该用什么选择器或XPath去定位元素。Network记录页面发起的每个网络请求点开任意一条能看到请求的URL、请求头、响应体Requests库该填什么参数一目了然。Console可以执行JavaScript、查看网页报错调试一些反爬相关逻辑时很有用。配合Requests或Scrapy写爬虫时我会先在Network里确认目标接口再用Python去请求成功率要高很多。有人喜欢靠猜接口地址浪费一整天而DevTools十秒钟就能把真实地址摆到你面前。工具用对了爬虫这件事的难度直接降一个档次。3. 新手安装避坑指南这些细节决定成败前面9个软件逐个讲完了接下来集中聊避坑。这些坑是我在带新手过程中反复看到的踩一次就要耽误大半天写出来帮大家提前绕开。3.1 环境变量与PATH的坑PATH这个变量简单理解就是操作系统找命令时要搜索的目录清单。你在命令行里输入python系统会在PATH列出的目录里逐个找python.exe找不到就报python不是内部或外部命令。这是新手最常遇到的报错没有之一。如果你安装官网Python时勾选了Add Python to PATH一般不会出问题。如果装完才发现没勾有两个补救办法。一是手动改环境变量右键此电脑 属性 高级系统设置 环境变量在Path中追加Python的安装目录和Scripts子目录比如C:\Users\你的用户名\AppData\Local\Programs\Python\Python312\和它的Scripts子目录。二是直接卸载重装这次记得勾上。从省事的角度我更推荐卸载重装因为手动编辑PATH对新手容易出错万一改错变量名影响的是整个系统。改完环境变量后必须重新打开终端才生效因为环境变量只在会话启动时读取一次。再用python --version验证。这里有个排查技巧输入where pythonWindows会列出所有匹配路径你一眼就能看出当前调用的是哪个解释器这对定位版本不对的诡异问题非常有帮助。3.2 多版本Python共存怎么处理实际上很多新手电脑里并存的Python版本多到吓人官网装了一个Anaconda带了一个Windows商店又塞了一个结果命令行输python时跑的是哪个版本完全不可控各种谜之报错此起彼伏。我推荐的方案是系统里最多留两个入口。第一个是官网Python作为默认全局解释器路径配置好第二个是Miniconda作为环境管理工具用它创建项目专属环境。其他所有Python全部卸掉尤其是Windows商店版干净利落。如果确实需要同时用多个PythonWindows上可以用官方自带的py启动器来指定版本py -3.12 test.py py -3.11 test.py但在虚拟环境普及之后这种按版本切换的需求已经很少了。每个项目一个独立的venvPython版本锁在虚拟环境里才是现在的主流做法。记住一句话不要跟全局环境较劲用虚拟环境隔离一切。3.3 常见安装报错与解决方案我把平时最常看到的新手报错整理成了一个速查表大家可以对号入座。报错内容常见原因解决办法python不是内部或外部命令PATH未配置或配置错误重装并勾选Add Python to PATH或手动追加环境变量pip不是内部或外部命令Python的Scripts目录不在PATH检查Scripts路径是否加入PATH或先执行python -m pip install --upgrade pipReadTimeoutError / 下载速度慢默认源在国外网络不稳定换成清华或阿里云等国内镜像源ModuleNotFoundError: No module named xxx模块没安装或装到了其他环境先确认当前虚拟环境再执行pip install xxxERROR: Could not find a version that satisfies the requirement库名拼错或当前Python版本过老检查拼写升级Python版本后重试Failed to build xxx本地缺少编译依赖安装Visual C Build Tools或找对应的wheel预编译包还有一个被很多人忽略的细节在虚拟环境里用conda管理包时pip和conda混用可能造成依赖冲突。建好环境后尽量固定用同一个包管理器。查看当前环境里装了哪些包用pip list查看当前解释器路径用python -c import sys; print(sys.executable)这条命令能最快告诉你到底是谁在执行。4. 我的建议从零开始的一套标准配置流程说了九件套也说了坑最后给一套我每次配置新电脑时都会走的流程。新手完全可以照着抄照着一路做下来环境基本就顺了。4.1 完整安装顺序与验证三步法第一步先装官网Python选最新稳定版。如果后面准备用Anaconda就不用勾Add Python to PATH如果不打算用勾上更省事。装完打开终端验证python --version。如果输入python --version没输出优先去检查应用执行别名里是不是被Windows商店版占了坑。第二步装Miniconda。下载对应系统的安装包一路Next注意别勾Add Anaconda to PATH。装完打开Anaconda Prompt输入conda -V验证。然后用conda create -n base熟悉一下环境创建命令先不急着装任何库。第三步装编辑器。建议先装PyCharm Community作为主力装完在Settings里把解释器指到官网Python或conda环境跑一个print验证。再装VS Code装好Python扩展后CtrlShiftP选择解释器同样跑一个简单脚本。第四步装Git和Windows Terminal。Git一路NextWindows Terminal在微软商店搜索安装。打开Windows Terminal输入git --version验证。第五步配置pip镜像源和Jupyter。执行pip config set global.index-url加上清华源地址再pip install jupyterlab之后随时可以在项目里用jupyter lab打开交互式笔记本。第六步Chrome或Edge装好后不用多配置养成按F12的习惯就行。这六步走完你就有了一个很干净的Python环境全局Python跑系统任务Miniconda管项目环境PyCharm和VS Code负责写代码Jupyter负责试验Git负责留后路浏览器负责调试网络。之后遇到任何环境问题都可以按这套结构去定位不用东查西查。4.2 关于免费Python源码大全的正确使用姿势热词里有一个免费python源码大全我估计很多人的网盘里都躺着几个G的源码包。这些资源本身没错错的是使用方式。我的态度是可以看但不要照抄更不能只看不练。编程这项技能本质上跟游泳、开车一样是手上的功夫。你看别人写的爱心代码、小游戏、爬虫脚本第一反应是哇好厉害我也要写但如果只是复制粘贴跑一遍收获其实非常小。真正涨功力的做法是选一个源码包里的项目从头到尾读懂每一行然后关掉源码自己重新实现一遍。卡住了回头看一眼再继续写。这个过程虽然慢但每完成一个项目能力和自信都会上一个台阶。我更推荐新手去GitHub上找star多、文档全的开源项目挑一个跟自己兴趣相关的比如小游戏、数据分析、命令行工具先读代码、再改代码、最后重写。与其躺在几百个大全里迷失方向不如把一个精挑细选的小项目啃透。散乱的代码堆不会自动变成你的能力。5. 写在最后工具是死的人是活的5.1 关于9个的一点个人补充我说说清楚9个软件从来不是硬性标准它是按新手学Python最常见的学习路径推出来的。如果你确定自己要走数据分析方向Anaconda和Jupyter的地位可以再往前排如果打算以后做Web后端Postman和Docker得提前补上如果只想写点小工具自娱自乐PyCharm和Git暂时简化掉也没问题。我的核心原则始终只有一条工具是为你未来三个月的目标服务的。装软件前先想想我接下来到底要做什么方向按方向选工具比一次性把网上所有推荐装齐更聪明。很多新手喜欢照单全收装完一整套全家桶最后打开电脑都不知道该点哪个图标反而徒增学习焦虑。5.2 一个小习惯让我少踩三年坑最后分享一个我自己的真实习惯每次拿到一台新电脑我不会急着写代码而是先花半小时把环境完整配好再跑一个最小验证程序打印一句Hello Python读一个CSV文件发送一个HTTP请求再建一个Git仓库并提交一次。这四步能确保解释器、第三方库、网络请求、版本控制四条主线全部通畅。这套环境先于代码的习惯帮我省掉了无数次代码写到一半才发现环境有问题的崩溃时刻。新手也一样先别急着进攻复杂语法先把这套地基打牢。所谓磨刀不误砍柴工环境理顺了后面学什么都快。你真要碰到配置问题把报错信息原样复制到搜索引擎搜一遍八成能搜到答案因为这些坑早被无数前辈踩过了。解决问题的过程本身就是最好的学习。
RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进