Python 入门第一课很多人以为第一步是背语法实际最容易劝退的是环境配置。解释器、编辑器、海龟绘图这三件事分别解决不同问题装好 Python 解释器电脑才知道怎么运行 .py 文件配好 VSCode写代码、看报错、做调试才舒服跑通海龟绘图才会第一次看到图形界面反馈。这篇内容按实际操作顺序拆开讲覆盖 Python 解释器安装、VSCode 开发环境搭建、turtle 绘图入门适合零基础刚想动手跑出东西的人。我会尽量把每一步“为什么这么做”写清楚也把最容易卡住的地方标出来。1. 新手学 Python第一课先解决三件事解释器、编辑器、可视化界面1.1 这三件事各是什么为什么不能互相替代Python 是一门编程语言但电脑本身不会直接“说” Python。它需要一个翻译官也就是 Python 解释器。解释器负责读取 .py 文件把它翻译成电脑能执行的指令。没有解释器你写的代码就只是一堆保存在文件里的文字。编辑器是写代码的地方。你可以用记事本写 Python但那样没有代码高亮、没有自动补全、报错也不方便看。VSCode 就是用来解决这些问题的工具。它本身不执行 Python 代码而是通过插件调用你装好的解释器把写、跑、调这三个环节串起来。海龟绘图不太一样。它是 Python 自带的标准库 turtle不需要额外安装。它做的不是命令行输出而是打开一个图形窗口让你看到代码运行后的可视化效果。同样是写循环print 只能看到数字turtle 能看到图形一步步画出来这对初学者理解程序执行顺序很有帮助。这三件事相互独立但缺了任何一环都会让第一课变得痛苦。常见的情况是解释器装好了但 VSCode 没有选对解释器或者代码写完了但图形窗口一闪而过。每一类问题都有自己的原因不要把所有问题都归到“我不会编程”上。1.2 初学者最常见的三个卡点第一个卡点装完 Python 后在终端输入 python 没有任何反应。这不是你操作有问题多半是安装时没有把 Python 加入 PATH或者装完没有重启终端。第二个卡点VSCode 能打开但一运行就报错或者代码提示一直不出来。这通常不是代码的问题而是没有选择正确的解释器。第三个卡点turtle 代码运行后图形窗口一闪就消失。很多入门教程会忽略 turtle.done() 这一步导致窗口没有保持住。这三个卡点的共同特点是它们都不是语法问题。也就是说即使你把代码抄得完全正确环境没配好照样跑不起来。这也能解释为什么很多 Python 入门教程喜欢“先装环境再写代码”因为环境稳定了后续大量的报错会自然消失。1.3 建议的安装与学习顺序顺序建议这样安排先安装 Python 解释器再用 VSCode 打开一个项目文件夹最后用 turtle 写第一个可视化程序。不要一开始就同时装 PyCharm、Anaconda、多个 Python 版本也不要一次性安装十几个 VSCode 插件。第一课的完整闭环其实很小能写一行 print能运行它能画出一个图形。这个闭环跑通之后再考虑虚拟环境、代码格式化、第三方库、调试工具都会轻松很多。很多 python 教程喜欢一上来就讲列表、字典、类但对第一课来说真正需要掌握的只有三件事知道在哪里写代码知道怎么运行代码知道报错之后从哪儿开始看。下面就从环境配置开始。2. 安装 Python 解释器下载、安装、PATH 配置一次讲完2.1 下载 Python版本选择与安装选项安装 Python 的第一步是去 Python 官网下载安装包。选择版本时不要盲目追最新也不要掉进旧版本兼容性的坑。Python 官方会持续发布新版本但许多第三方库不一定立刻支持最新版本。入门阶段选择一个相对稳定的 Python 3.x 版本就好这个版本能覆盖绝大多数学习需求。在你的机器上下载安装包时还要关注位数。现在绝大多数电脑是 64 位系统普通用户选择 64 位安装包即可。少数老机器是 32 位系统那就得选 32 位。判断方式是在 Windows 的“关于”页面里查看系统类型或者在 macOS 的“关于本机”里看芯片和系统信息。需要提醒一点如果你使用的是 macOS 自带的 Python通常是系统工具链的一部分版本可能比较旧而且直接往系统环境里写第三方库会带来权限问题。更推荐的做法是去官网下载官方安装包或者用 Homebrew 安装 Python之后再在 VSCode 里选择这个解释器。2.2 安装时必勾的选项和 Windows / macOS 差异Windows 安装包打开后第一页最下方有一个勾选项“Add Python to PATH”。这一项非常关键最好勾上。勾选后安装程序会自动把 Python 的安装目录写入系统环境变量之后你打开终端输入 python 才能直接识别。如果不勾选装完后你打开命令提示符输入 python大概率会提示“不是内部或外部命令”。虽然可以手动配置 PATH但新手阶段能少一个坑就少一个坑。Windows 的安装界面通常还有“Install Now”和“Customize installation”两个入口。入门阶段直接点 Install Now 就行安装目录一般会在你的用户目录下比如C:\Users\你的用户名\AppData\Local\Programs\Python\Python313\。如果选择自定义路径尽量用纯英文、不包含空格的目录避免后续出现编码或路径解析问题。macOS 的安装包是 .pkg 格式双击后按提示继续即可。安装完成后需要在终端里确认 python3 是否可用。Linux 环境比较特殊很多发行版自带 python3但版本不一定满足你的需求。如果你在 Linux 上学习建议先查系统自带版本再决定要不要手动安装更新版本。2.3 验证安装python、python3、pip 到底怎么用安装完成后打开 Windows 的命令提示符或 PowerShell输入python --version如果返回 Python 3.x.x说明安装成功。如果提示找不到命令可以试试py -3 --versionWindows 上有时会把py启动器作为默认入口。macOS 或 Linux 里通常需要使用python3 --version为什么同一台机器上会同时出现 python 和 python3因为不同操作系统对 Python 命令的默认指向不同。macOS 为了兼容旧脚本常常把 python 指向 python2 或者不配置而 python3 指向 Python 3。Windows 上装了 Python 3 后如果 PATH 正确python 一般就是 Python 3。接下来还要检查 pip。pip 是 Python 的包管理工具用来安装第三方库。输入pip --version如果命令不存在在 Windows 上可以试python -m pip --version这个写法更保险它表示“用当前 Python 解释器去执行 pip 模块”。以后遇到多版本 Python 混用、pip 指向错误时python -m pip经常是更稳妥的调用方式。第一课暂时不需要安装第三方库但确认 pip 可用会让后面学习更顺畅。你可以把 python 和 pip 的验证结果记在心里之后每次安装新依赖报错时先回到这一步检查而不是直接怀疑代码写错了。2.4 PATH 与环境变量常见排查如果终端提示“不是内部或外部命令”或“command not found”按顺序排查。先重启终端。很多情况下安装已经成功但当前终端进程没有刷新环境变量关掉重新打开就能解决。再检查安装时是否真的勾选了 Add Python to PATH。如果你不确定可以到“系统设置”的“环境变量”里查看 Path 项是否包含 Python 的安装路径。手动添加 PATH 的方法虽然不难但要注意不要删除原有的 Path 项目。你只需要在 Path 中新增一条指向 Python 安装目录的记录。大部分情况下不用手动操作只有当安装时漏掉勾选项或者卸载重装后残留路径混乱时才需要处理。排查时还可以用where或which命令查看当前调用的解释器路径。Windows 下where pythonmacOS 或 Linux 下which python3这一步很重要。如果你的机器上装了好几个 Python某次运行发现莫名其妙的导入错误很可能不是你代码的问题而是编辑器或终端选中了另一个解释器。先看清路径再改参数排查效率才会高。顺便说一句同样的思路也适用于以后配置 Node.js、Java、Maven 等环境。你会发现只要命令行能识别命令编辑器能选择正确的运行环境后面大多数开发工具都是一个逻辑。3. 用 VSCode 搭一个轻量 Python 开发环境3.1 为什么入门阶段推荐 VSCode而不是一上来用 PyCharmVSCode 在入门阶段非常好用因为它的启动速度快界面比较干净插件安装也方便。Python 扩展装好之后代码高亮、代码提示、运行按钮这些功能马上就有了。PyCharm 是功能更完整的 IDE调试能力更强但第一课阶段容易把注意力浪费在项目配置上。很多新手装了 PyCharm 后被首次启动时的解释器选择、项目解释器、虚拟环境这些界面搞混反而忽略了写代码这件事本身。VSCode 更像一个“通用编辑器”。你以后写 C/C、Java、Node.js还是可以用同一个编辑器只需要换对应的插件和解释器。第一课学会这套思路后面切换语言时会少很多阻力。3.2 下载 VSCode 后优先做的三件事中文、Python 扩展、终端从 VSCode 官网下载安装包时Windows 用户要注意安装界面里的几个勾选项。建议把“添加到 PATH”和“通过右键菜单打开”勾上这样以后可以在任意文件夹里通过右键快速用 VSCode 打开项目。安装完成后打开插件市场做三件事。第一安装中文语言包。搜索“Chinese”并安装安装后会提示重启重启后界面变成中文。这一步不装也行但对英文不太熟的读者来说中文界面能减少很多困惑。第二搜索“Python”安装微软官方发布的 Python 扩展。这个扩展通常会附带 Pylance提供代码补全、类型检查、跳转定义等功能。这是 VSCode 配置 Python 开发环境的核心步骤没有它VSCode 只是一个带高亮的高级记事本。第三打开终端面板确认 VSCode 内部的终端能识别 python 命令。如果刚刚装完 Python但 VSCode 是在安装之前打开的需要完全关闭 VSCode 再重新打开否则终端可能还没有加载新的 PATH。安装插件时不要贪多。插件市场里满天都是热门扩展但很多并不需要在第一课阶段安装。装得太多启动变慢界面变复杂反而影响学习。一个 Python 扩展一个中文语言包最多再加一个 Code Runner已经足够。3.3 选择解释器、打开工作区、写第一个文件先在你方便的位置新建一个文件夹建议用英文命名比如python-learn。然后用 VSCode 打开这个文件夹。你会看到一个空的项目目录这里就是你存放第一课代码的地方。在文件管理器里点击新建文件命名为hello.py输入print(hello, python)接下来选择解释器。按CtrlShiftPmacOS 按CmdShiftP输入“Python: Select Interpreter”然后从列表里选择你在第 2 章安装的 Python。选中后VSCode 底部状态栏会显示解释器版本比如 Python 3.x.x。这一步为什么重要因为 VSCode 不会自动知道你装了哪个 Python。如果不选或者选错后面运行代码时可能会出现“Python 路径无效”“无法导入模块”的报错。这也是很多人在网上看到别人代码没问题、自己运行却各种异常的原因之一。3.4 运行、调试、代码提示和格式化运行 Python 文件有三种常见方式。第一种点击代码右上角的三角形运行按钮第二种右键代码区域选择“在终端中运行 Python 文件”第三种在终端里手动输入python hello.py。三种方式都会把程序输出显示在终端面板。新手最该养成的习惯是运行完马上看终端里的内容。如果程序正常终端会显示hello, python。如果报错终端会有一段红色的错误信息通常最后一行是核心报错原因。不要害怕红色它是你接下来学习最好的老师。VSCode 有许多提升体验的设置。我建议你在设置里搜索format on save勾选“保存时自动格式化”。这样每次保存代码VSCode 会按默认风格调整格式减少缩进不一致的问题。缩进是 Python 语法的一部分。Python 里的循环、条件、函数都靠缩进区分代码块。VSCode 默认会用 4 个空格作为缩进这个习惯贴近官方规范。要注意的是不要在同一段代码里混用 Tab 和空格哪怕肉眼看着差不多Python 解释器也可能报出缩进错误。调试功能第一课可以不用深入。你只需要知道如果后续代码逻辑复杂可以在行号左侧点击设置断点然后按 F5 进入调试模式。它允许你逐行观察变量变化比写一堆 print 更高效。现在只要能把程序跑通就已经是很好的开端。3.5 虚拟环境现在不学但要知道为什么存在虚拟环境是 Python 项目开发里非常重要的概念。简单说它能让每个项目拥有独立的第三方库环境避免 A 项目需要 requests 1.x、B 项目需要 requests 2.x 时产生冲突。创建方法很简单在终端里进入项目目录执行python -m venv .venv然后重启 VSCode再用Python: Select Interpreter选择.venv里的解释器。你会发现右下角解释器名称指向项目内部路径。第一课只使用标准库不创建虚拟环境也不会出问题。但等你开始用 pip 安装第三方库比如说安装 requests、pandas我非常建议先建虚拟环境再装。总比最后系统环境一团乱麻要好。Anaconda 里的 conda 环境也是类似思路只是它更偏向数据科学场景。第一课不需要了解那么深知道“环境隔离”这个方向就够了。4. 用海龟绘图开启第一个可视化项目turtle 模块入门4.1 turtle 是什么为什么适合第一课turtle 是 Python 标准库里的绘图模块不需要 pip install也不需要额外下载。它模拟一只小海龟在画布上爬行爬过的路径会留下线条。你可以控制它前进、后退、左转、右转、提笔、落笔、改变颜色和画笔粗细。为什么第一课适合用它因为它的反馈极其直观。你写forward(100)屏幕上的小海龟就往前走 100 像素你写left(90)它就原地转过 90 度。每一步命令都能立刻看到结果这比在终端里反复打印数字更接近“编程的真实反馈”。turtle 还适合讲解循环、函数和事件回调这些概念是后续编程的基石。很多人觉得循环抽象但如果你用来画一个正方形马上就会发现画四条边只需要重复执行“前进-左转”两次操作循环的意义便一目了然。4.2 最小运行例子画一条线和一个正方形先在 VSCode 里新建一个文件比如turtle_demo.py输入下面的代码import turtle t turtle.Turtle() t.forward(100) turtle.done()运行后会弹出一个图形窗口窗口里有一只小海龟从中心位置向前走了一段直线。这里每一行都有意义import turtle引入海龟模块turtle.Turtle()创建了一个画笔对象我们可以把它当作一个海龟t.forward(100)让海龟前进 100 个像素turtle.done()让窗口保持打开等待手动关闭。如果不写turtle.done()在大多数环境下窗口会一闪而过你根本看不清图形。这也是初学者最常见的问题之一。画一个正方形也很简单用循环写更清楚import turtle t turtle.Turtle() for _ in range(4): t.forward(100) t.left(90) turtle.done()这里的_是一个临时变量名它只表示“循环计数”但我们在循环体里不关心计数到几。循环体执行了 4 次每次前进 100 像素后左转 90 度正好走完一个闭合的正方形。可以试想如果要画五边形就把循环次数改成 5左转角度改成 72画六边形就改成 6 和 60。规律是正 n 边形的每个外角等于 360 除以 n。4.3 颜色、填充、坐标与画笔状态控制turtle 提供了一组非常直观的方法下面列几个第一课最常用的方法作用forward(distance)向前移动指定像素backward(distance)向后移动指定像素left(angle)向左旋转指定角度right(angle)向右旋转指定角度penup()抬笔移动时不画线pendown()落笔移动时画线pensize(width)设置画笔粗细color(red)设置画笔颜色fillcolor(yellow)设置填充颜色begin_fill()开始填充end_fill()结束填充goto(x, y)移动到画布上的指定坐标用这些方法可以画出更丰富的图形。比如画一个黄色填充、蓝色边框的正六边形import turtle t turtle.Turtle() t.pensize(3) t.color(blue) t.fillcolor(yellow) t.begin_fill() for _ in range(6): t.forward(80) t.left(60) t.end_fill() turtle.done()你也可以用penup()提起笔移动到某个坐标再pendown()落笔开始绘制。这样做的意义是让海龟在移动过程中不留下痕迹常用于把图形画到不同位置。turtle 的默认坐标系以画布中心为原点x 轴向右为正y 轴向上为正。4.4 用循环和函数画出重复图案循环是 turtle 学习里最值得花时间的内容。正方形只是入门组合使用循环可以画出很漂亮的图案。比如画一组绕圈排列的六边形import turtle t turtle.Turtle() t.speed(5) for i in range(12): for _ in range(6): t.forward(60) t.left(60) t.left(30) turtle.done()这里用到了循环嵌套内层循环负责画一个六边形外层循环负责转向 30 度然后画下一个六边形。外循环执行 12 次正好覆盖一圈。你会发现画布上出现了规律的图案但代码量很少。接下来可以引入函数。把绘制多边形的逻辑封装成一个函数参数是边数和边长import turtle t turtle.Turtle() def draw_polygon(sides, length): angle 360 / sides for _ in range(sides): t.forward(length) t.left(angle) draw_polygon(3, 80) draw_polygon(5, 80) draw_polygon(8, 80) turtle.done()代码里的angle是根据边数算出来的这样你不需要每次手动计算。第一次调用画出三角形第二次画五边形第三次画八边形。函数在这里起到的作用是“把重复逻辑打包”以后想画什么正多边形传两个参数就行。为什么第一课就要接触函数因为如果你只是把一段代码复制十遍代码会变得很长而且修改一个地方就要改多处。函数是最简单的抽象方式也是你从“写 Demo”走向“写程序”的第一步。4.5 窗口闪退、画布不显示的排查顺序turtle 相关的问题多半不在语法而在运行环境。我这里给一个排查顺序。第一窗口一闪而过。先看代码末尾是否有turtle.done()。没有就加上。第二点击运行后终端没有报错但图形窗口没出现。先看终端是否一直在等待如果是说明窗口可能在后台打开但被遮挡如果不是本机图形环境比如在远程服务器、容器或虚拟机里运行turtle 可能无法显示窗口。第三提示No module named turtle。turtle 是标准库正常情况下不应该缺失。如果出现这个错误八成是 VSCode 选了解释器或者当前 Python 环境不是标准环境。重新选择 Python 解释器通常能解决。还有一个隐藏坑容易被忽略你把变量命名为turtle比如import turtle turtle turtle.Turtle() turtle.forward(100) turtle.done()这样写会报错因为turtle这个变量覆盖了模块名。第一行import turtle之后turtle是一个模块但第二行当你执行turtle turtle.Turtle()时模块名被变量名覆盖后续再调用turtle.done()时Python 会认为你在用画笔画完的画笔对象调用done结果自然不对。解决办法很简单画笔变量不要直接叫turtle叫t或pen都行。这类问题看起来像功能不支持实际往往是命名和覆盖造成的。遇到类似报错先检查变量名有没有和模块名冲突再看函数名是否拼写正确最后才需要考虑环境。5. 把第一课串起来完整小项目与后续学习建议5.1 完整项目点击屏幕后画一个彩色多边形把函数、循环、随机数、事件回调放在一个项目里能更完整地体会“程序在等你操作”是什么感觉。下面这个例子点击画布上的不同位置会画出边数和颜色都随机的多边形。import turtle import random def draw_shape(x, y): t turtle.Turtle() t.penup() t.goto(x, y) t.pendown() sides random.randint(3, 8) color_list [red, blue, green, orange, purple] t.color(color_list[random.randint(0, len(color_list) - 1)]) for _ in range(sides): t.forward(50) t.left(360 / sides) turtle.onscreenclick(draw_shape) turtle.done()这里onscreenclick是 turtle 提供的事件回调机制。它不是说程序马上执行draw_shape而是告诉 turtle“当用户点击屏幕时调用这个函数并且把点击位置的坐标传给参数 x 和 y。”这是从顺序执行到事件驱动的第一个小跨越。运行后你用鼠标在画布上点几下。每点一次就会有一个新海龟移动到点击位置然后画出不同边数、不同颜色的多边形。验证成功的标准是点击多个位置都能画出图形并且终端没有报错。如果点击没反应先检查turtle.done()是否执行再检查draw_shape函数是否定义在onscreenclick之前。这个项目已经把第一课要学的知识串起来了环境配置、函数、循环、模块导入、事件回调。能独立把它跑通并且能解释代码中每一行的作用就说明第一课基本毕业了。5.2 入门阶段怎么安排练习很多人学 Python 的误区是节奏太急。第一天装环境第二天就想爬数据第三天就想做网站结果报错一个接一个很快就放弃了。第一课真正稳妥的安排是分三天完成几个小目标。第 1 天装好解释器跑通 hello.py再画出一个正方形。第 2 天用循环画正三角形、正方形、五边形、六边形再试旋转图案。第 3 天把绘图案整理成函数完成点击画多边形的交互项目再试着改颜色和边长参数。每天不用学太久30 到 60 分钟足够。学习过程中不要看到网上有“大而全的源码合集”就复制粘贴。那些项目往往涉及很多你不知道的背景知识一旦报错你很难判断是环境问题、语法问题还是依赖问题。第一课阶段代码越短越好理解越细越好。5.3 新手写代码时容易忽略的细节结合大量新手的踩坑经历下面这些细节很值得单独记一下。第一文件名后缀必须是.py不是.txt也不是无后缀。VSCode 新建文件后如果右下角显示的是纯文本需要手动把文件保存为hello.py才能激活 Python 扩展。第二代码里的括号、引号、逗号都要用英文符号。中文输入法没有切回英文时写出来的标点看起来差不多但 Python 不认。第三报错时从最后一行开始看。Python 报错信息会标记出文件路径、行号和异常类型最后一两行通常就是直接原因。第四不要复制大段代码后只改几个参数就认为成功了。你把代码跑通后建议自己删掉再重新打一遍或者尝试改改数字观察图形变化。这个过程能帮你确认自己是否真的理解。第五项目路径尽量用英文。某些情况下中文路径或特殊字符路径会引起编码问题。虽然不是所有机器都会遇到但完全没必要给自己加难度。如果你以后还要在 VSCode 里配置 C/C、Java、Node.js 环境思路和 Python 差不多先让命令行能识别对应命令再装上对应的扩展最后选择正确的解释器或编译器。只是每种语言与 VSCode 的绑定方式略有差异但排查路径是通用的。5.4 后续可以往哪个方向延伸第一课跑通之后你的 VSCode 环境已经能处理日常 Python 开发了。接下来可以根据兴趣选择方向。想做自动化办公可以接着学习 openpyxl、python-docx想做数据处理和可视化可以了解 pandas、matplotlib想做网络请求可以学习 requests 和 HTTP 接口想做 Web 开发可以用 Flask 或 FastAPI 起步想在图形和游戏方向继续可以接着玩 turtle也可以之后看 pygame。这些方向离第一课都不远但从现在开始你再安装第三方库时会开始接触 pip 和虚拟环境。我的建议是每开始一个新项目就建一个新的虚拟环境然后在里面安装依赖。刚开始会觉得很麻烦但等用到多个项目时你会感谢这个习惯。真正把第一课跑通不是抄了一段能运行的代码而是让你重新装一次环境也能独立完成遇到报错能从错误信息里找到线索。后面所有 Python 项目都是在这个基础上一点点堆起来的。