写Python教程的博主很多但大多数都犯一个毛病默认你已经知道了一大堆术语结果照着抄都抄不明白。所以我干脆用我这些年带新手踩坑的经历把Python从安装到跑起第一个Hello World这件事从头到尾捋一遍哪些地方容易出错、哪些步骤可以偷懒、哪些设置必须手动改全都说清楚。先说结论Python入门真的不难难的是把环境弄对。我见过太多人在安装这一步就被劝退其实问题往往不在他们而在教程没把关键细节讲透。这篇文章适合谁看完全零基础的编程小白想转行做数据分析或自动化办公的职场人还有那些装了Python但一直跑不起来程序的“半吊子”用户。我会从为什么选Python讲起再到Windows和Mac上的具体安装步骤、环境变量怎么配、pip是什么、怎么用命令行跑脚本最后附上我新手期踩过的那些坑。看完这一篇你不仅能顺利跑出Hello World还能看懂后续所有Python学习资料里那些绕不过去的名词。1. 为什么要装Python以及你真正需要装的是哪个版本1.1 搞清楚Python到底是什么Python是一门编程语言语言本身只是一套语法规则真正干活的是解释器——也就是把你这套语法翻译成计算机能懂的命令的那个程序。你安装Python本质上是安装这个解释器外加一堆配套工具。打个比方Python语言相当于普通话的语法规则而解释器就像一个同声传译你说一句“大家好”他马上翻译给计算机听。没有这个传译你说破天计算机也听不懂。所以后面所有教程里提到的“运行Python代码”意思就是用这个解释器去读取你写的.py文件然后逐行执行。这个概念搞清楚了后面很多操作你就能自己推理出来不用每步都查教程。1.2 Python 2和Python 3为什么我只推荐3如果你去网上搜Python安装教程可能会翻到一些老文章还在讲Python 2。这里我直接给你结论Python 2已经彻底停止维护了除非你在维护一个十年前的遗留项目否则任何情况都不要选2。我见过不少新手因为教程太老装了Python 2结果后面学列表推导式、学f-string格式化字符串的时候跟网上主流教程对不上白费一堆功夫。Python 3内部也有版本号区别比如3.8、3.10、3.11、3.12。版本越新语法特性和性能越好但有个现实问题有些第三方库的更新速度跟不上新版Python的发布节奏。我的建议是新手直接装当前最新的稳定版就行或者退而求其次选择上一年的稳定版千万别装Beta版或RC版Release Candidate预发布版本。Beta版可能本身就有Bug再加上第三方库不兼容出了问题你根本分不清是自己代码的问题还是Python本身的问题。1.3 关于Anaconda我为什么不推荐新手上来就装现在很多教程会推荐安装Anaconda它是Python的一个发行版自带了数百个常用的科学计算库比如NumPy、Pandas、Matplotlib还自带了一个叫conda的包管理工具。如果你是做数据科学或机器学习方向的Anaconda确实很方便。但我个人建议新手先别碰。原因有三个第一Anaconda体积巨大装完占好几个G的空间而纯净Python装完才一百多兆第二Anaconda的conda和pip两套包管理体系很容易让新手搞混出现包装错环境的问题第三Anaconda自带的Python版本往往不是最新的而网上教程大多基于官方Python写。先装官方版Python把基础打牢等真正需要做数据分析了再考虑Anaconda也不迟。这样你踩的坑会少很多遇到问题也好排查。2. 各平台安装过程详解以及那些教程没明说的关键设置2.1 Windows安装注意那个总是被忽略的勾选框Windows是新手最多的平台我就先详细讲它。安装包去Python官网下载网址很好记python.org进网站后鼠标悬停在Downloads菜单上它会自动识别你的操作系统并推荐一个下载按钮直接点就行。下载完成是个.msi或.exe文件双击运行。这里有个关键的坑安装向导第一页最底部有一个“Add Python to PATH”的勾选框默认是没勾上的。我在帮人远程看问题的时候十个里至少有八个毁在这一步。PATH是什么它是Windows系统里的一个环境变量记录了系统去哪些目录里寻找可执行程序的路径列表。你勾选了这个选项安装程序就会把Python的安装目录添加到PATH里之后你在命令行里输入python系统才能找到它。不勾选的话哪怕你装的是正版Python在命令行里敲python也只能看到“不是内部或外部命令”的报错。勾选Add Python to PATH之后点击Install Now等待安装完成然后再点击Disable path length limit如果这个按钮出现了的话。这个是因为早期Windows有一个260个字符的路径长度限制开启这个选项可以解除否则以后你在深目录里跑Python项目时会莫名其妙报错。安装完成后验证是否成功。打开命令行按WinR输入cmd回车输入python --version能输出版本号比如Python 3.12.5说明安装成功。再输入pip --version能输出版本号说明pip也装好了。2.2 macOS安装别用系统自带的PythonMac系统自带一个Python但那个版本是给系统工具用的非常老而且你不能随便动它否则系统某些功能会出问题。所以你要装的是你自己用的Python跟系统自带那个共存互不干扰。macOS上安装Python有两种主流方式方式一官网下载安装包。同样去python.org下载macOS版本的.pkg文件双击安装。这种方式最直观跟装其他Mac软件没区别装完后打开终端输入python3 --version就能验证。方式二用Homebrew安装。Homebrew是Mac上的包管理工具相当于手机的应用商店。如果你已经装了Homebrew可以在终端里运行brew install python它会帮你装好最新版Python和pip。我个人比较推荐这种方式因为后续安装其他开发工具时Homebrew基本都会用到。这里有个小知识在Mac上python和python3是两个不同的命令。系统自带的Python 2对应python你新装的Python 3对应python3。所以验证的时候要输python3别输python否则你看到的还是那个老版本。2.3 Linux安装一条命令搞定但要区分发行版Linux用户相对基础好一些这里简单提一下。Ubuntu和Debian系用sudo apt update sudo apt install python3 python3-pipCentOS和RHEL系默认的yum源里Python版本比较老建议用EPEL源或者从源码编译安装。新手如果用的服务器是CentOS可以直接考虑装宝塔面板之类的可视化工具然后让面板帮你装Python环境省心很多。Linux还有一种进阶选项是用pyenv来管理多个Python版本这个对于需要在多个项目间切换不同版本的人非常有用但新手阶段先不用碰知道有这个东西就行。2.4 安装后第一件事验证pip是否可用pip是Python的包管理工具官方名称叫“Pip Installs Packages”作用是下载和安装别人写好的第三方库。比如后面你想用Python处理Excel表格就需要用pip安装一个叫openpyxl的库。你可以把pip理解成手机的应用商店写好的Python库就是里面的App。你需要哪个库就用pip安装安装后就能在代码里import它。验证pip是否正常Windows在命令行里输入pip --versionMac和Linux输入pip3 --version。如果提示找不到pip先检查安装时是否勾选了Add Python to PATH或者Mac上是否用了pip3这个命令。这里的坑主要是命令不对。很多人照着教程输入pip install xxx结果报错找不到pip其实明明Python装得很好只是Windows上的pip命令可能叫pip.exe而系统查找路径里没有它的位置。把我上面说的PATH问题解决pip自然就通了。3. 编辑器选哪个从记事本到VS Code的实用建议3.1 新手该不该用记事本写代码严格来说你完全可以用Windows自带的记事本写Python代码写完把后缀改成.py就行。但我不推荐因为记事本没有语法高亮、没有自动缩进提示、没有代码补全哪怕你打错一个单词它都不会给你任何提示。写代码本身对工具的要求不高但代码可读性和排错效率严重依赖编辑器。就好比你用Word写小说它肯定比记事本舒服但写代码相比编辑器给你的帮助更直接——它可以实时告诉你这一行少了半个括号。3.2 PyCharm vs VS Code怎么选目前主流的选择有两个PyCharm和Visual Studio Code简称VS Code。PyCharm是JetBrains公司出的专业Python IDE集成开发环境分社区版和专业版。社区版免费功能对新手来说完全够用。PyCharm的特点是开箱即用——你不需要额外配置什么它自动识别Python解释器、自动管理虚拟环境、自带调试器和代码检查工具。缺点是启动比较慢、占用内存大如果你的电脑比较老跑起来会有点吃力。VS Code是微软出的轻量级编辑器本身跟Python没什么关系但你通过装插件可以把变成一台量身定做的IDE。它的优势是轻快、免费、插件生态极其丰富以后你写前端、写Go、写Shell都用得上。但代价是新手需要手动配置Python插件可能还会遇到解释器路径配置不对的问题学习成本稍微高一点。我的建议很直接如果你目的就是学Python后面两年内也不打算学其他语言那直接用PyCharm社区版省心。如果你希望一个编辑器走天下或者电脑配置不太行那就选VS Code我给你写下配置步骤。3.3 VS Code配置Python环境的完整步骤第一步去VS Code官网下载安装包安装过程一路默认。安装完打开左侧有个扩展商店的图标四个小方块搜索“Python”选择微软官方发布那个点击Install。第二步打开一个文件夹作为你的项目目录。点左上角“文件”选择“打开文件夹”新建一个比如叫python-learning的文件夹。第三步快捷键CtrlShiftP调出命令面板输入“Python: Select Interpreter”选择你刚安装的那个Python版本。这一步非常关键不选对解释器你代码跑起来可能用的是系统里另一个版本的Python。第四步建一个测试文件。在资源管理器里右键新建文件命名为hello.py写下面这段代码然后点右上角的绿色三角按钮运行print(Hello, World!)能看到输出框里打印Hello, World!说明整个链路是通的。3.4 IDLE也够用但别长期依赖其实安装Python时官方会自带一个叫IDLE的简易开发环境。它长得很简陋但功能齐全——有语法高亮、有命令行交互窗口、还能直接运行脚本。如果你实在不想折腾编辑器IDLE完全能支撑你度过前两周的学习期。但我不建议长期用IDLE因为它的自动补全和调试功能太弱了等你代码量变多、逻辑变复杂会明显感觉到效率跟不上。把它当成一个过渡工具就好。4. 手把手写出Hello World命令行、文件、交互式三种方式全跑通4.1 方式一命令行直接运行打开命令行Windows是cmdMac是终端输入pythonMac是python3你会看到类似这样的提示符这是Python的交互式解释器你在这里输入一行它就执行一行适合做快速验证。比如你输入 print(Hello, World!)它会立刻就给你打印出结果。这在验证某个小功能的时候特别方便相当于跟Python解释器直接聊天。退出这个交互模式Windows输入exit()Mac同样或者按CtrlDMac和CtrlZ再回车Windows。4.2 方式二写入文件运行交互式虽然方便但正式写程序是绝不用的——因为代码需要保存、需要复用、需要维护。正确方法是把代码写进一个.py文件然后用命令python 文件名运行。首先创建一个文本文件把后缀改成.py。比如在桌面新建一个文本文档改名为hello.py确认弹出的提示“如果改变文件扩展名可能会导致文件不可用”选择“是”。然后用编辑器记事本也行打开它输入print(Hello, World!)保存。接着打开命令行切换到你保存文件的目录输入python hello.py按下回车屏幕上就会打印出Hello, World!这一步看起来很简单但有个新手极易翻车的地方命令行当前目录跟你的py文件所在的目录不是同一个。你在命令行里看到的提示符路径比如C:\Users\你的名字命令行找文件只会去这个目录找。如果你的hello.py放在桌面而你命令行停在其他目录输入python hello.py就会报“No such file or directory”。解决办法有两个一个是先用cd命令切换到文件所在目录另一个是用绝对路径运行比如python C:\Users\你的名字\Desktop\hello.py。初学阶段我建议老老实实学会用cd命令以后用VS Code跑项目时默认就会在项目目录里执行命令算是打基础了。4.3 方式三用VS Code或PyCharm运行用VS Code时打开hello.py文件直接点右上角的Run按钮输出会显示在“终端”面板里。用PyCharm时打开文件后点击代码编辑器左侧的绿色三角形图标或者右键选择Run。之所以有了命令行方式还推荐IDE方式是因为IDE集成了调试功能。你可以打断点、单步执行、观察变量的实时值这些是定位逻辑错误的利器。命令行方式适合跑最终成品脚本IDE方式是开发调试的主体两条腿走路都要会。4.4 第一个程序多写点什么比较好一次Hello World确实很有仪式感但我建议你在第一天就多迈一步试着往代码里加入输入和变量让第一个程序长这样name input(请输入你的名字) print(Hello, name !)运行后程序会停下来等你输入你输入自己的名字回车程序就会说Hello你的名字。这个程序虽然也只多了几行但让你一次性接触了变量、字符串拼接和input输入三个基础概念比单纯打印一句话的成就感强很多。5. 新手安装和使用Python的高频报错以及我的排查方法5.1 “不是内部或外部命令也不是可运行的程序或批处理文件”这是Windows用户最眼熟的报错。原因就是我在第2节强调过的——安装时没勾选Add Python to PATH。现在教你补救办法。在系统搜索框输入“环境变量”打开编辑系统环境变量。点击下方的环境变量按钮在用户变量或系统变量里找到Path这一项并双击右右侧空白点一下把Python的安装路径加进去。Python默认安装目录一般是C:\Users\你的用户名\AppData\Local\Programs\Python\Python312\注意要把这个路径和它下面的Scripts目录都加进去一个是Python主程序所在目录一个是pip命令所在目录两个都要加。加完后必须重新打开命令行窗口配置才会生效。之后再验证python --version应该就能通了。5.2 “python不是内部命令”但明明配置好PATH了如果你确定PATH配置没问题Python也能运行但pip报错那大概率是pip这个exe文件不在PATH里面。刚才说了Scripts目录也要加进去。不信你打开Python安装目录看一下pip.exe就在Scripts文件夹里。还有一种情况是你装了多个Python版本系统找到了其中一个的python.exe但找不到这个版本对应的pip。这个问题我建议新手按步骤来完全重装一次反而省时间因为你现阶段的电脑里本来也没有需要保留的环境。5.3 中文乱码和编码错误你在代码里写了中文注释运行时却报“SyntaxError: Non-UTF-8 code”这个问题在Python 3里很少见了因为默认编码就是UTF-8。但如果你的编辑器保存文件时用了别的编码格式比如记事本的ANSI编码就会出现这个问题。解决办法很简单始终让文件和代码都以UTF-8编码保存。在VS Code里右下角有个编码提示点击它就能切换UTF-8。写Python代码这两条是铁律缩进必须一致推荐4个空格编码必须统一UTF-8。5.4 pip下载速度慢或超时默认的pip源在国外国内网络下载很慢。我建议把pip源换成国内镜像清华或阿里云的都可以。你不需要永久改配置手动指定一次就行pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple其中requests是一个网络请求库后面学爬虫一定会用到。这样做的原理是-i参数指定了本次安装使用的索引源pip会去这个镜像站查找并下载包速度通常能快上十几倍。这个问题不太需要详细了解只需记住下载Python库很慢时就加上这个镜像参数或者去查一下如何永久配置镜像源。5.5 Python装好了但在VS Code里还是报找不到解释器这通常是VS Code还没被配置好。按下CtrlShiftP搜“Python: Select Interpreter”手动找到你Python的安装路径选中即可。VS Code的Python插件默认会去找PATH里的Python但有时候它找不到虚拟环境里的Python这时手动选择最好使。5.6 Mac用户运行python显示版本是2.7前文说过Mac自带老版本你要的不是它。输入python3 --version来验证。如果python3也提示找不到说明你的安装没成功或者Homebrew安装Python后它被放在了/usr/local/bin里面而终端没找到路径。这时候可以在终端里输入source ~/.zshrc让环境变量重新加载一下。6. 装完Python之后建议你再做这三件事6.1 装一个虚拟环境工具等你学了一段时间开始频繁安装第三方库的时候就会理解我为什么在安装完成当天就让你装virtualenv或用venv建虚拟环境了。虚拟环境相当于给你的每个项目分配一个独立的小仓库这个项目里装了requests1.0那个项目里需要装requests2.0两个版本互不冲突。Python官方的venv和conda都能担此重任新手配合PyCharm使用的话PyCharm的New Project向导里会自动帮你创建虚拟环境你继续往下一步一步稳稳走就行。6.2 顺手掌握pip的几种高频用法只装Python而不学pip等于手里有把枪却没有子弹。以下四个命令用了不亏pip install numpy # 安装包 pip list # 列出已安装的包 pip show numpy # 查看某个包的详细信息 pip uninstall numpy # 卸载包配合前面说的镜像源日常使用足够了。6.3 定一个完整的小项目当练手目标Hello World只是开场白。我见过太多人止步于Hello World因为接下来不知道学什么热情迅速消退。我建议你装完环境之后立刻给自己找个具体需求比如写一个脚本自动把桌面上的截图按日期归档到不同文件夹写一个脚本批量把Excel里某些列的数据做加法求和写一个脚本自动抓取某个网站的天气信息并保存在本地不要追求一开始就做大型框架项目而是从解决眼前的小麻烦开始。这样你每敲一行代码都有实际意义学起来会非常有成就感也顺带掌握了文件操作、第三方库、异常处理这些基础技能。7. 关于安装Python这条路我个人踩过最大的一个坑说句实话我也曾是那个在安装环节就差点放弃的人。当时照着某个视频教程装Python视频里说“装好后在命令行输入python”但我怎么输都提示找不到视频评论区全是“我也是”。后面折腾一晚才搞明白就是没勾Add Python to PATH。那是我第一次意识到编程世界里一个看似细小的步骤可以造成巨大的挫败感。所以这篇教程我不敢漏掉任何一个细节尤其是安装界面上的那些选项勾选我会反复强调。现在如果你依旧遇到了这里没有覆盖到的问题我建议你靠着“报错信息”这四个字去搜索把报错原文复制到浏览器的搜索框里会出现无数跟你同病相怜的人以及他们最终解决的方式。遇到报错别慌更别怀疑是不是自己没天赋绝大多数报错都很常见修复方法基本都写在网上。最后再从实操角度给一个建议Hello World跑通之后多花十分钟把命令行与文件目录切换、pip安装库、VS Code断点调试这三样基本功练到顺手。你在接下来所有Python学习中依赖这三样东西的频率会远远超过你的想象。