零基础Python入门：环境配置、VSCode搭建与海龟绘图实战

很多零基础朋友刚开始学 Python最容易卡住的不是语法本身而是“不知道代码在哪里写、写完怎么运行”。有人下载了 Python 却双击不了脚本有人装好了 VSCode 但代码一直报“没有解释器”还有人只会用 Python 打印字符串学了几天觉得枯燥就放弃了。这篇文章就把 Python 入门第一课需要的东西一次性整理清楚从 Python 环境配置到 VSCode 开发环境搭建再到用海龟绘图写出第一个可视化程序。整个流程全部动手实操每一步都有命令、代码和运行结果说明按顺序做一遍基本就能解决环境层面的拦路虎。文章主要面向三类读者完全没接触过编程的零基础新手学过一点语法、但环境一直没配顺的同学想用有趣方式带学生入门编程的老师和家长。学完之后你不仅能在电脑上正常运行 Python 脚本还会用 VSCode 编写、调试代码并通过海龟绘图画出正方形、五角星、彩色花瓣等图案对 Python 的基础语法也有一个直观认识。1. 前言为什么建议按“环境 → 编辑器 → 画图”的顺序入门很多人学编程一上来就啃语法书变量、列表、字典、循环学了一遍回头却发现自己连一个完整程序都跑不起来。这种挫败感很容易让人放弃。我建议的入门顺序是先把 Python 解释器装好再搭配一个趁手的编辑器然后用一个“看得见反馈”的案例来理解语法。海龟绘图就是非常合适的第一个案例它让代码执行结果以窗口画面的形式直接呈现画一条线、转一个角度、换一种颜色立刻就能看到变化。这种即时反馈对建立编程兴趣非常重要。对于零基础来说“能运行出结果”带来的成就感比“背熟了语法”有用得多。这篇文章不止教你怎么安装还会解释每一步为什么需要这样做帮你在脑子里建立一条完整的知识线。2. Python 环境配置让电脑拥有运行 Python 的能力Python 是一门解释型语言它的源代码不能直接被电脑执行需要由 Python 解释器逐行读取并运行。“配置 Python 环境”本质上就是安装解释器并让操作系统能找到它。2.1 Windows 系统下安装 PythonWindows 用户建议直接到 Python 官网下载安装包。安装时有两个关键点第一在安装向导第一个页面记得勾选底部的 “Add Python to PATH”。如果这一步忘了勾选安装完后在命令行输入 python 会提示“不是内部或外部命令”后面还要手动配置环境变量比较麻烦。第二安装路径可以保持默认也可以自定义到简单目录例如D:\Python312。自定义路径时建议不要包含中文和空格否则部分工具按路径解析程序时可能出现奇怪的问题。一个典型的安装流程是打开 Python 官网进入 Downloads 页面点击 Windows 安装包。运行安装包。勾选 “Add Python to PATH”。点击 “Install Now” 等待安装完成。安装完成后点击 “Disable path length limit” 选项如果出现这个选项可以解除 Windows 对长路径的限制建议开启。这里要说明一点Python 版本更新速度较快具体版本号以官网最新稳定版为准。教程中的代码绝大部分在 Python 3.8 以上都可以正常运行。2.2 macOS 系统下安装 PythonmacOS 自带的 Python 版本通常比较旧不建议直接用于开发。推荐两种安装方式。第一种是去官网下载 macOS 安装包双击安装流程和 Windows 大同小异。安装完成后在终端输入 python3 进入交互式环境。第二种是使用 Homebrew 安装。如果你已经安装了 Homebrew终端执行brew install python安装完成后使用python3 --version查看版本号。macOS 下默认python命令可能指向系统自带版本为了避免冲突大部分项目习惯使用python3命令。2.3 验证安装是否成功安装完成后按对应按键打开终端Windows 按Win R输入 cmd回车。macOS 按Command 空格输入 Terminal回车。在终端输入python --version如果输出类似Python 3.12.x说明安装成功。接着输入python会进入 Python 交互式环境此时终端提示符变成。输入print(Hello, Python)回车后如果输出Hello, Python就说明解释器可以正常使用。输入exit()退出交互式环境。验证这一步很容易忽略但非常重要。很多同学装完不知道装没装上直接去编辑器里写代码等到编辑器报错才回头检查环境反而浪费时间。2.4 环境变量的作用与常见问题“Add Python to PATH”中的 PATH 是操作系统查找可执行程序的路径列表。当我们输入 python 这个命令时系统会依次在 PATH 包含的目录中查找名为 python.exe或 python的程序文件找到就执行。如果安装时忘了勾选有几种补救办法重新运行安装包选择 Modify勾选 “Add Python to PATH”。手动把 Python 安装目录和Scripts子目录添加到系统环境变量。在命令行中使用完整路径例如C:\Users\你的用户名\AppData\Local\Programs\Python\Python312\python.exe。不推荐长期使用完整路径运行 Python因为每次敲命令都很啰嗦而且不同工具调用解释器时也可能找不到。3. VSCode轻量又好用的 Python 编辑器Python 代码可以用任何文本编辑器编写但为了提高效率推荐使用 VSCodeVisual Studio Code。它免费、轻量、跨平台插件生态丰富尤其适合 Python 开发。3.1 下载与安装 VSCode打开 VSCode 官网点击 Download选择对应操作系统的安装包。Windows 用户安装时可以把以下两个选项勾上“添加到 PATH”“通过 Code 打开操作” 相关选项这两个选项能让你在文件夹右键菜单里直接打开 VSCode非常符合后续开发习惯。安装完成后打开软件界面默认是英文。如果你希望用中文界面可以在左侧扩展商店搜索 “Chinese (Simplified) Language Pack for Visual Studio Code”安装后重启即可。3.2 安装 Python 扩展VSCode 本身只是编辑器要让它支持 Python 语法高亮、代码补全、调试等功能需要安装 Python 扩展。点击 VSCode 左侧的扩展图标方块图标搜索 “Python”选择由 Microsoft 发布的扩展并安装。这个扩展还会自动推荐安装 Pylance用于提供更强大的智能提示。安装扩展后Python 代码的体验会有质的提升语法错误会用波浪线标红。输入print时会有补全提示。函数名、变量名会统一高亮。按住Ctrl点击函数名可以跳转到定义。这一步是很多新手容易漏掉的关键环节。有人装完 VSCode 直接写代码发现没有提示、没有高亮以为软件坏了其实只是没装扩展。3.3 新建项目与第一个 Python 文件在电脑上新建一个文件夹例如python-study。打开 VSCode选择菜单 “文件 → 打开文件夹”选中python-study。在资源管理器中新建文件命名为hello.py。输入print(Hello, Python)此时编辑器右下角会显示当前解释器版本。如果是第一次使用可能需要手动选择解释器按快捷键Ctrl Shift P输入 “Python: Select Interpreter”从列表中选择刚安装的 Python 版本。为什么要选择解释器因为 VSCode 是一个平台它要依赖你安装好的 Python 解释器来运行代码。没有选择解释器代码运行时就会提示找不到 Python。3.4 运行 Python 代码的几种方式在 VSCode 中运行代码常见方式有三种第一种点击编辑器右上角的三角形运行按钮代码会输出到终端面板。第二种在终端手动执行。打开 VSCode 终端快捷键Ctrl 输入python hello.py第三种右键代码编辑区选择 “在终端中运行 Python 文件”。推荐新手先掌握第二种方式。因为手动输入命令运行代码能帮助你理解“脚本文件”和“解释器”之间的关系也更容易看清程序报错时的路径信息。4. Python 基础语法快速热身在海龟绘图之前我们需要掌握少量最基础的 Python 语法。不需要一次学完只需要理解以下几个部分就足够开始画图了。4.1 变量与基本数据类型变量可以理解为一个“贴了标签的盒子”用来存放数据。Python 中不需要声明类型直接赋值即可。name 小明 age 12 height 1.65 is_student True print(name) print(age) print(height) print(is_student)这里定义了四个变量字符串、整数、浮点数、布尔值。print()函数将内容输出到终端。变量名建议使用有意义的英文单词多个单词用下划线连接例如user_name、total_count。不要使用中文拼音或字母缩写过几天你自己都可能看不懂。4.2 条件语句条件语句根据条件是否成立决定程序走哪个分支。score 85 if score 90: print(优秀) elif score 60: print(合格) else: print(需要加油)Python 使用缩进来表示代码块所以if下面的语句必须缩进。很多新手一开始总忘记缩进或者混用空格和 Tab 键导致报错。建议在 VSCode 设置中将缩进统一为 4 个空格并且开启“检测缩进”相关选项。4.3 循环循环就是重复执行一段代码。for循环适合遍历序列while循环适合在条件满足时持续执行。for i in range(5): print(第, i, 次循环)上面的代码会输出 0 到 4 五次。注意range(5)生成的是0,1,2,3,4默认从 0 开始不包含 5。这是新手刚接触时最容易懵的地方。4.4 函数函数把一段可复用的代码包装起来需要时调用即可。def draw_square(): print(开始画正方形) draw_square() draw_square()def是 define 的缩写表示定义一个函数。函数名的命名规则和变量类似多个单词之间可以用下划线连接。掌握以上这些基础内容后就具备了看海龟绘图代码的基本能力。海龟绘图代码中大量使用循环和函数学起来会起到“巩固语法”的作用。5. 海龟绘图入门用代码画图把乐趣还给你海龟绘图Turtle Graphics是 Python 内置的一个绘图模块不需要额外安装。它模拟一只小乌龟在画布上爬行乌龟移动时身后留下痕迹通过控制移动方向和距离就能画出各种图案。海龟绘图非常适合入门因为它能直观体现“顺序执行”“循环”“函数调用”这些编程概念。5.1 导入 turtle 模块在 Python 文件中输入import turtle导入模块后就可以调用其中的函数和方法。为了让画图窗口显示后不会立即闪退在代码结尾加上turtle.done()turtle.done()可以让窗口保持打开直到你手动关闭。少了这行程序运行完窗口可能一闪而过很多新手以为是代码错了其实只是窗口关闭太快。5.2 第一只“小海龟”先做一个最简单的动作让海龟画一条直线。import turtle turtle.forward(100) turtle.done()forward(100)让海龟向前移动 100 像素。运行程序后你应该能看到一个窗口里面有一条水平线段。默认情况下海龟的初始方向是向右。如果想调整方向可以使用left()或right()方法。5.3 画一个正方形正方形需要四条长度相等的边每条边之间夹角 90 度。用循环写最简洁import turtle for _ in range(4): turtle.forward(100) turtle.right(90) turtle.done()解释一下这段代码range(4)表示循环 4 次。每次循环画一条 100 像素的边。画完后右转 90 度为下一条边准备方向。这里用_作为循环变量因为循环体内不需要使用具体数字Python 社区习惯用下划线表示“临时变量不关心它的值”。5.4 画三角形和五角星等边三角形有三条边每个外角是 120 度。import turtle for _ in range(3): turtle.forward(120) turtle.left(120) turtle.done()五角星有 5 个角每个角的外角是 144 度。import turtle for _ in range(5): turtle.forward(150) turtle.right(144) turtle.done()五角星是一个很经典的入门案例很多刚接触循环的人第一次画出五角星时都会有一种“原来编程这么好玩”的感觉。5.5 设置画笔颜色和填充默认画笔是黑色的可以通过color()方法修改。begin_fill()和end_fill()配合使用可以在封闭图形中填充颜色。import turtle turtle.color(red) turtle.begin_fill() for _ in range(4): turtle.forward(100) turtle.right(90) turtle.end_fill() turtle.done()color(red)会把画笔颜色设为红色。begin_fill()通知程序接下来要绘制一个封闭区域end_fill()会在结束位置将区域填充为当前颜色。turtle模块支持常见的英文颜色名比如blue、green、yellow、orange、purple也支持十六进制颜色值比如#FF6600。后者可以表示更丰富的颜色。5.6 画笔粗细与速度通过pensize()可以设置画笔粗细speed()可以控制绘制速度。import turtle turtle.pensize(5) turtle.speed(3) turtle.color(green) turtle.forward(120) turtle.right(90) turtle.forward(120) turtle.done()speed(0)是最快速度speed(1)最慢speed(10)很快。实际练习时可以先用慢速观察海龟的移动轨迹理解每一步的方向变化。6. 海龟绘图综合案例画一朵七色花把前面学到的循环、函数、颜色、填充结合起来画一朵七色花。这段代码稍微复杂一点但每一部分我们都已经学过。import turtle def draw_petal(): 画一片花瓣 turtle.color(red) turtle.begin_fill() for _ in range(2): turtle.circle(50, 60) turtle.left(120) turtle.end_fill() def draw_flower(): 画七片花瓣组成的花朵 for _ in range(7): draw_petal() turtle.left(360 / 7) turtle.speed(6) turtle.penup() turtle.goto(0, -100) turtle.pendown() draw_flower() turtle.hideturtle() turtle.done()这段代码有几个新增知识点turtle.circle(50, 60)表示画半径为 50 的圆但只画 60 度的圆弧。通过两段圆弧组合出花瓣形状。turtle.penup()让海龟移动时不留下痕迹turtle.goto(0, -100)将海龟移动到指定坐标。turtle.pendown()恢复画线状态。turtle.hideturtle()隐藏海龟图标让画面更干净。运行后你会看到一朵由七片红色花瓣组成的花朵。把color(red)改成yellow整朵花就会变成黄色。这里也可以进一步思考如何让每一片花瓣颜色不同这个留作练习。如果你觉得代码跑得慢可以把turtle.speed(6)改成turtle.speed(10)或turtle.speed(0)如果想让窗口自动关闭把turtle.done()换成turtle.exitonclick()这样点击窗口才会关闭。7. 常见问题与排查思路初学阶段环境问题和画图问题是最主要的拦路虎。下面整理了几类高频问题按表格形式给出排查思路。问题现象常见原因解决思路输入 python 提示“不是内部或外部命令”安装时未勾选 Add Python to PATH重新运行安装包勾选或手动配置环境变量VSCode 中代码没有语法高亮未安装 Python 扩展在扩展商店搜索 Python 并安装运行代码提示“No module named turtle”turtle 是内置模块一般不会缺少可能是解释器选择错误检查 VSCode 右下角解释器路径确认选择的是已安装的 Python画图窗口一闪而过缺少 turtle.done() 或 turtle.exitonclick()在程序末尾加上维持窗口的语句缩进错误 IndentationError混用 Tab 和空格在 VSCode 设置中统一使用 4 个空格并开启自动转换海龟画图形状不对循环次数和外角角度不匹配用公式外角 360 / 图形边数代入循环测试双击 .py 文件没有反应Windows 默认没有把 Python 文件关联到解释器在文件上右键选择打开方式或通过命令行运行这里补充一个很常见但容易被忽略的点VSCode 终端和 Windows 自带的 cmd 是不同的如果在 VSCode 终端输入 python 提示找不到但系统 cmd 却可以说明 VSCode 的终端环境变量没有刷新。解决方法是重启 VSCode或者完全关闭后重新打开。另一个高频问题是路径问题。如果.py文件保存在中文目录个别组件解析路径时可能出错。建议把你的练习文件夹放在纯英文目录下例如D:\python-study或~/python-study这是一个成本很低却能减少很多麻烦的习惯。8. 最佳实践与工程建议环境配置完成、第一个程序跑通之后建议从第一天开始就建立良好的开发习惯。以下几条建议适用于刚入门 Python 的开发者也适用于后续深入学习。第一项目文件不要随便堆在桌面。建议每个项目单独建文件夹项目内文件按功能命名例如hello.py、draw_flower.py。这样做的好处是后续写多文件项目时你已经有分类意识。第二认真读懂报错信息。Python 的报错信息通常包含错误类型、出错文件、出错行号和具体原因例如File hello.py, line 3 print(Hello ^ SyntaxError: ( was never closed这段报错告诉我们第 3 行有一个左括号没有闭合。很多新手看到英文报错就慌其实它已经给出了很明确的定位和提示。第三坚持写注释。用#写单行注释用三引号写多行注释。注释不是写给计算机看的是写给未来的自己看的。函数内部第一行可以写文档字符串描述函数的作用。第四先画草稿再写代码。海龟绘图中尤其重要。画一个图形之前先拿笔在纸上画出方向变化标注角度再用代码描述这个过程。编程本质上就是把“做事情的过程”翻译成代码。第五安全使用命令行。Python 入门阶段的命令基本只有python、cd、dirWindows或lsmacOS/Linux几种。不要随意复制来源不明的命令执行尤其是涉及删除文件、修改系统配置的命令一定要先搞清楚作用再执行。第六谨慎对待网上资料。Python 社区非常活跃网上有大量教程但也存在版本过时的问题。例如某些教程还在使用 Python 2 的语法和 Python 3 不兼容。看到新语法时可以优先查官方文档或者搜索时加上 “Python 3” 关键词。9. 下一步学习路线当你完成环境配置、VSCode 配置和海龟绘图三个环节后你已经具备独立运行 Python 程序的能力。接下来可以按照以下顺序继续推进继续用海龟绘图练习基础语法例如用循环画螺旋线、用列表存储颜色实现彩色花瓣。学习标准输入输出通过input()实现简单交互程序。学习字符串操作和列表处理更复杂的数据。学习读写文件把运行结果保存到文本文件中。了解函数的高级用法参数、返回值、默认参数。选择一个小项目练手例如命令行计算器、猜数字游戏、简易通讯录。如果你想通过书籍系统学习经典的《Python 编程从入门到实践》是一本不错的起点它前半部分覆盖基础语法后半部分用项目来串联知识点适合新手。需要提醒的是工具和版本会持续更新但“先配环境、再选编辑器、最后动手跑代码”这个流程基本不变。遇到报错时先读错误信息、再搜索关键词、最后对照自己的代码基本上能解决绝大多数入门阶段的问题。