还记得我刚开始学编程那会儿光把运行环境弄明白就折腾了一晚上。问了几个朋友每个说的版本都差一点最后是看了半天的官方文档才装上战战兢兢敲下人生中第一行print(Hello, World!)屏幕上真的跳出那行字的时候激动得差点把杯子碰倒。现在回头想想Python 入门最大的阻碍从来不是语法而是那些房间里的大象——装哪个版本、要不要勾选 PATH、为什么有 python 还有 python3这些没人讲的细节会拦住你整整两个小时。这篇文章就是把那段弯路给你重新铺平。我会从零开始一步步带你装好 Python、选好编辑器、写出并运行你人生中的第一个程序顺便把新手最容易踩的坑全部提前标注出来。不管是完全没碰过代码的纯小白还是学了点 C/Java 想转 Python 的同学读完之后都可以亲手把这个从零到一的过程完整走一遍。1. 为什么第一门语言选 Python先把逻辑捋清楚1.1 Python 能干什么入门为什么选它先说清楚一个现实Python 能做的事情太多反而是它让人困惑的地方。如果你去看招聘网站爬虫岗位、数据分析岗位、自动化测试岗位、后端开发岗位甚至训练人工智能模型的岗位都有 Python 的影子。GitHub 上拿来练手的开源项目十个里面七八个跟 Python 沾边。这股生态优势在入门阶段意味着什么你遇到任何问题几乎都能在搜索引擎里找到别人已经踩过的坑和方案这种摔倒了有人扶的体验是冷门语言给不了的。更关键的是Python 的语法在所有主流语言里是最接近自然语言的。比如if a b:这一行哪怕你一行代码没写过也能猜出它是在如果 a 大于 b这个条件里做判断。相比之下写 C 语言你光理解头文件、指针和内存地址就要先掉一层头发Java 的public static void main(String[] args)对新手来说像一串咒语Python 的print(hello)就是字面意思打印 hello。对编程零基础的人这个区别意味着英语语感和逻辑思维哪个都不需要前置你只需要识字就够了。入门阶段还有一个隐形优势反馈极快。写完一行代码立刻能跑不像编译型语言要先编译、再链接、再运行中间任何一个环节报错新手都懵。Python 这种写了就能跑的即时感对维持学习耐心来说非常重要。我见过太多朋友前两周就放弃编程不是学不会是环境配置那关太劝退巨长的前置准备成本让人根本坚持不到写出第一个程序的兴奋时刻。选 Python就是把这个前置成本压到最低。1.2 版本选择下载 3.x别碰 2.x现在打开 python.org 下载页面你能看到的是 Python 3.12、3.13 这类版本号而不会再看到 Python 2.7。但你在网上搜索老教程时依然会翻到大量用 Python 2 语法写的文章它们告诉你print hello这在 Python 3 里直接报语法错误。新手看到这通常就懵了我是照着教程做的啊为什么报错我给你的建议特别简单只看和只用 Python 3。Python 2 官方在多年以前就停止了维护更新现在还在用 Python 2 的项目大多遗留在服务器角落里完全不适合作为入门学习对象。你可以在下载页面直接选择标着Latest Python 3 Release的链接点进去之后选择一个以x.x.x形式命名的版本。不用追求最新选稳定的 3.12 或 3.13 都可以它们之间的差异对新手来说几乎无感等你有经验了再研究版本变迁史也不迟。注意如果看到下载页面里同时有 64-bit 和 32-bit 的选项不要犹豫选 64-bit。现在的电脑基本都是 64 位系统32 位版本纯粹是为老旧硬件保留的。1.3 安装之前先想清楚的三个选择安装 Python 看起来是双击下一步但第一页就有个容易忽略的选项叫Add Python to PATH。我后面会专门讲它有多关键这里先记住结论一定要勾选。另外还有Install Now和Customize installation两种按钮如果只是入门学习直接点 Install Now 就行它会把必要的组件都装好不折腾。还有一个选择是安装路径。默认安装会放在C:\Users\你的用户名\AppData\Local\Programs\Python这种很长而且带空格的路径里。个人建议自定义成C:\Python312这样简洁的路径纯英文、没有空格后续你在命令行操作会少很多麻烦。别在路径里用中文也别用空格这是所有编程初学者值得从第一天就建立的整洁习惯。2. 把 Python 装进电脑Windows 和 macOS 的完整步骤2.1 Windows 安装最关键的一步是勾选 PATH打开 python.org/downloads点下载最新版本然后双击运行安装包。这里我必须放大讲一下因为无数新手都在这一步栽了跟头。安装向导第一页最下面有一句Add Python 3.x to PATH默认是没勾选的你要手动把它打上勾再点 Install Now。这个 PATH 到底是什么你可以把它理解为系统的通讯录。当你命令提示符里输入python系统需要知道去哪里找 python.exePATH 里记录了这些程序的地址它就像系统存了一份常用联系人电话簿你喊一声 python系统就去这个电话簿里查它的地址然后把它启动起来。如果没加入 PATH你想运行 Python就必须跑到安装目录里手动点那体验就别提了。装完以后怎么确定安装成功按Win R输入cmd回车打开命令提示符然后输入python --version如果看到Python 3.12.x这样的输出说明安装成功。如果系统提示python 不是内部或外部命令那多半是 PATH 没配置好。先别慌解决办法要么是重装一遍这次记得勾选 PATH要么手动配置环境变量后面第五章我会写完整的排查步骤。2.2 macOS 和 Linux 的安装差异macOS 用户要注意电脑自带的 Python 是 2.7 版本的老古董千万不要直接拿来学很多第三方库早就不支持它了。你需要去 python.org 下载 macOS 版本的安装包一路默认安装即可。装完之后在终端里输入python3 --version注意 macOS 上命令是python3而不是python。因为系统里可能存在老旧的 Python 2.7为了区分官方安装包也提供了python3这个命令。如果你发现python和python3都指向新版本那是因为你在安装时勾选了相应选项但为了保证不出岔子推荐统一用python3来运行代码。Linux 用户最省事多数发行版用包管理器就能装。比如 Ubuntu 里sudo apt update sudo apt install python3 python3-pip装完验证python3 --version即可。Linux 系统自带的 Python 3 版本可能不是最新但对入门来说完全够用不需要自己编译安装新版。2.3 验证安装三种命令姿势很多人以为验证安装就是输一遍python --version其实这里面还有门道。Windows 上同时存在python和py两个命令py是官方提供的 Python 启动器也是微软官方推荐的方式。如果你的电脑只装了一个 Python 版本python和py大多时候等价但如果装过多个版本py -3.12可以指定运行某个版本这在前者容易混淆时非常有用。新手我建议就记住两条命令python --version以及python -c print(hello)第二条是用来验证 Python 能不能正常执行代码如果它成功打印出 hello说明安装已经没问题第一个程序其实已经在你手里完成了大半。3. 写第一个程序之前先明白三种运行方式3.1 交互式命令行跟 Python 聊天安装成功后最简单的方式是打开命令行输入python你会看到这样的提示符这就进入了 Python 的交互模式。你可以在这里一行行输入代码立刻看到结果 2 3 5 print(你好) 你好这种方式非常适合做小实验、验证一个函数的行为就像跟 Python 聊天一样你说一句它回一句。我自己到现在还经常开一个交互窗口算点临时数据省得新建文件。但对完整的程序来说它有个致命缺点你关掉它所有代码就没了。你不能把这个会话保存下来下次重新运行又要敲一遍。所以正式的代码要写在文件里。3.2 脚本文件真正写程序的方式写程序的正规做法是把代码保存到一个以.py结尾的文件里然后让 Python 去执行这个文件这叫脚本模式。创建一个文本文件比如first.py在里面写print(Hello, Python!)然后在命令行进入该文件所在的目录运行python first.py你就能看到Hello, Python!打印出来。这就完成了从零到一中最经典的那个飞跃代码不再是临时输入而是一个可以反复修改、反复运行的文件它才配叫程序。3.3 编辑器怎么选IDLE、VS Code、还是记事本既然要写文件就得有个顺手的地方写。这里我直接给你对比一下几个常见选择编辑器适合人群优点缺点IDLEPython 自带绝对零基础新手装完就有零配置自带运行按钮功能简陋代码一长就难受VS Code想长期学习的人插件丰富、自动补全、调试方便需要额外装 Python 插件配置稍多Thonny教学场景专为入门设计能看到变量变化过程项目大了不够用记事本临时应急什么电脑都有没有语法高亮没有补全容易写错我的建议很直接如果你今天刚下载 Python就先打开 IDLEWindows 开始菜单里搜 IDLE它的 File → Open / New File 就能写代码按 F5 直接运行零学习成本。等写完这个第一个程序对 Python 有点感觉了再换成 VS Code。VS Code 装上 Python 官方插件之后写代码会有补全、有实时语法检查表格里写错括号它立刻用红线提示你这是避免低级错误的重要靠山。注意不要在 Word 里写代码。Word 会自动把普通引号变成弯弯的智能引号这种漂亮引号在 Python 里会导致语法错误而且你还看不出来。4. 从零到一动手写出你的第一个程序4.1 Hello, Python! 以及每一行在干嘛现在正式上手。用 IDLE 或 VS Code 新建一个文件保存为first.py输入print(Hello, Python!)然后运行它。屏幕打印出Hello, Python!的那一刻就是你程序员生涯的第一个里程碑。我们来拆开这句代码print是一个函数作用是把括号里的内容打印到屏幕上接着是左括号和右括号括号里放着我们要打印的字符串字符串要加引号这很重要——不加引号写print(Hello)Python 会认为你在引用一个叫 Hello 的变量而这个变量不存在立刻报NameError: name Hello is not defined。为什么字符串必须加引号因为不加引号Python 就无法区分一个字面文本和一个变量名。这就像在纸条上写苹果两个字如果加上引号你就是在描述苹果本身不加引号别人可能以为是让你去冰箱里拿那个叫苹果的东西。字符串在代码里是最常用的数据类型记住这个规则后面能少一半的错误。你把字符串改成自己的名字试试print(你好我是小明我写出了人生中第一个Python程序)看到自己的名字和这句话打印出来是不是有点上了手的感觉。恭喜这不仅是第一个程序还是第一个完全属于你的输出。4.2 让程序跟你对话input 的妙用只输出文字还不够通常程序还需要接收你输入的内容。Python 里用input()函数来接收输入。修改first.pyname input(请输入你的名字) print(你好 name 欢迎开始学Python。)运行一遍。程序会先停下来等你在终端里输入名字按回车然后打印出那句问候。这里有一个新概念变量。name是一个变量它像一个贴了标签的盒子你把用户输入的内容装进去后续用到name的地方Python 会取出盒子里装着的内容。input()函数有个细节要注意它返回的一定是字符串。如果你让用户输入数字然后用它做加法Python 会报错。比如age input(请输入你的年龄) print(age 1)会得到一个TypeError: can only concatenate str (not int) to str意思是字符串不能和整数加在一起。要解决你得把输入转成整数age int(input(请输入你的年龄)) print(明年你, age 1, 岁)int()就是把字符串转换成整数的函数。这种类型转换是新手接触的第一个难点但这个坑几乎必踩早见早好。4.3 第一段逻辑if 判断和缩进程序的能力在于做决定。我们把刚才的年龄输入扩展一下age int(input(请输入你的年龄)) if age 18: print(你已成年可以独立填写信息。) else: print(你还未成年需要家长陪同。)这里面有几个值得注意的地方。首先是if age 18:后面的英文冒号它表示接下来是一个条件分支代码块。更关键的是下一行代码前的缩进——四个空格。Python 用缩进来划分代码块的归属这正是它与 C/Java 用大括号{}最大的区别。缩进怎么理解可以看成一个层级if是领导缩进的代码是它的下属。满足条件时执行这些下属不满足就跳到else的下属那里。所以你不小心把缩进删了Python 就会报IndentationError: expected an indented block。解决办法就是统一用四个空格或一个 Tab但不要混用。我在 VS Code 里习惯把Tab 键插入空格打开让编辑器自动处理永远不出问题。提示代码里的冒号、括号、引号全部必须是英文半角符号。中文输入法打出的冒号和引号会被 Python 判为非法字符报SyntaxError: invalid character这种错误。这是我带新手时遇到的最高频错误之一。到这里第一个程序已经不只是print一句话了它包含输入、变量、类型转换、条件判断这些是编程最基础的地基。你可以自己动手改一改比如判断成绩是否及格score int(input(请输入你的考试成绩)) if score 60: print(及格了不错) else: print(这次没过下次加油)5. 新手必踩的坑与排查妙招5.1 python 不是内部或外部命令怎么办这是所有新手提问率最高的一条。你在 cmd 里输入python --version系统回一句python 不是内部或外部命令心都凉了半截。原因只有一个系统找不到 python.exe 在哪里也就是安装时没有把 Python 加入 PATH。解决方式按优先级排列。第一重新运行安装程序选择 Modify然后把Add Python to PATH勾上一路下一步。第二手动添加环境变量右键此电脑→ 属性 → 高级系统设置 → 环境变量 → 在系统变量里找到 Path 这一行编辑新建一条填入你 Python 安装的目录比如C:\Python312和C:\Python312\Scripts。注意填的是 Python 安装目录本身不要填到上一级。改完保存重新打开cmd 再试环境变量的修改不会自动刷新到已打开的命令行窗口。在 Windows Store 下载的 Python 还可能出现一种特殊情况输入python弹出了微软商店的页面。这是系统开了应用执行别名在设置里搜管理应用执行别名把两个 Python 相关的条目关掉就可以。5.2 中文乱码与编码问题写print(你好)运行后cmd 里显示浣犲ソ之类的乱码这是 Windows 控制台默认编码不匹配导致的。Python 3 默认用 UTF-8但老控制台用的是 GBK。比较省力的解法是在代码第一行加一个声明注释# -*- coding: utf-8 -*- print(你好)虽然 Python 3 默认支持 UTF-8 文件但这个声明对控制台识别编码仍然有积极作用。如果加了它还乱那就是控制台自身的问题在 cmd 里输入chcp 65001回车把代码页切换到 UTF-8然后再运行。还有一点容易被忽略你保存文件的编码。用记事本保存时注意右下角选UTF-8 编码确保文件本身是用 UTF-8 保存的。用 VS Code 的话右下角会显示 UTF-8不用手动设置。别小看编码问题这是中文用户特有的入门门槛但排查顺序无非就是文件编码 - 控制台编码 - Python 声明这三层。5.3 多个 Python 版本共存的处理很多新手装了一遍不行重装第二遍装完发现电脑里有 Python 3.11 又有 3.12还有环境变量里乱糟糟的路径。这时候输入python到底启动哪个完全看 PATH 列表里排在前面的是哪个特别容易搞混。更合理的方式是用官方启动器py。在 cmd 里输入py -3.12 -c print(run in 3.12)就明确用 3.12 运行避免歧义。如果你只是入门不希望陷入多版本混战的泥潭最彻底的做法是卸载重装一次只留一个版本然后专心用它。等以后理解深入了再用venv虚拟环境隔离项目那时候多版本共存才会成为一件优雅的事而不是灾难。5.4 文件保存与路径引起的诡异报错如果运行python first.py时提示无法打开文件No such file or directory但你的first.py明明就在桌面那十有八九是命令行的当前目录不对。命令行只会在当前所在目录找文件你敲的路径要对应真实的文件位置。可以在 cmd 里用cd 桌面路径切换目录或者更简单在文件管理器里按住 Shift 右键选择在此处打开命令窗口或在此处打开 PowerShell 窗口这个操作能直接定位到文件所在目录。文件路径里有中文名比如新建文件夹\first.py在某些环境下也可能出问题这是旧式命令行工具的经典坑。入门阶段直接统一用英文目录名能规避掉一大半莫名其妙的报错。6. 从第一个程序到真正的程序员习惯6.1 命名规范和写好注释把第一个程序跑通之后下一步就是开始注意代码的卫生习惯。好的变量命名有种自解释的魅力user_name比a好一万倍因为三个月后你回来看代码a是什么只有天知道。Python 社区的正式规范叫 PEP 8里面强调用user_name而不是userName用 4 个空格缩进变量名全小写、单词之间用下划线分隔。你不需要背完整本规范只要照这三条做代码就已经远超大部分新手平均水平了。注释是另一个被低估的好习惯。在代码里写#开头的内容是注释Python 不会执行它。初学者往往觉得注释是给老师检查作业用的其实它是写给你自己看的——记录为什么选这种写法或者这里参数必须是列表能极大降低后期改 code 的心智负担。我自己的习惯是代码本身回答做了什么注释回答为什么这么做。6.2 把第一个程序扩展成小工具与其反复抄别人的案例不如把自己的第一个程序改造成一个真正有趣的小项目。这里我分享一个我经常推荐给新手的扩展方向把刚才的输入输出改成猜数字游戏import random number random.randint(1, 100) while True: guess int(input(猜一个1到100之间的数字)) if guess number: print(太大了再试一次。) elif guess number: print(太小了再试一次。) else: print(恭喜你猜对了) break这个程序引入了random模块、while True无限循环、elif多分支判断和break跳出的概念。你仍然是在输入、判断、输出这三个你已经掌握的步骤里打转只不过组合方式变多了。把这个玩清楚第一个程序就不再是孤零零的print而是一个可以反复修改扩展的起点。6.3 后续学习路径建议跑通第一个程序后很多人的迷茫在于不知道下一步学什么。我的建议是按顺序吃透这几块循环和列表你会用它批量处理数据、字典用来存带名字的信息的容器、自定义函数把重复代码封装成可复用块、文件读写让程序运行结果留在硬盘上。这些基础全部掌握之后你对编程是什么已经有一个整体的理解框架再根据自己的兴趣选一个方向深入——写网站、做自动化脚本、做数据分析都行。学习资源方面官方文档里的 Tutorial 是最权威的基础教材虽然英文为主但配合翻译阅读完全够用。入门书我推荐《Python编程从入门到实践》它把语法讲解和小项目结合得很好书不厚适合边看边敲。视频教程的优点是直观但一定不要只看不练编程这个技能和游泳一样你下水扑腾比在旁边看再多的教学视频都有效。最后分享一个我实际操作中的体会带过不少人从零开始学 Python发现最容易让人半途而废的从来不是语法难而是卡在一个小细节上两个小时没人帮忙被挫败感击垮。所以你每遇到一个报错大可以把它当成一次难得的实战经验——把错误信息完整复制下来去搜索慢慢读绝大多数坑都会在意想不到的地方有人趟过。如果你把环境装好、把第一个程序跑通恭喜你入门阶段最陡的那个坡度已经过去了。手里有了第一个程序后面的路只会越走越顺。