Python 入门教程其实多到看不完但真正把环境配置 代码编辑器 第一个能看得到的程序串成一堂完整课的并不多。很多零基础同学第一次接触 Python 时不是被语法劝退而是被环境折腾到崩溃下载了 Python 安装包装完却提示python 不是内部或外部命令装了 PyCharm一堆配置看不懂写好了第一行print(hello world)又不知道在哪里运行。这篇文章就不绕弯子了直接解决三个问题Python 解释器应该怎么装装完怎么验证VSCode 为什么适合做 Python 入门工具插件怎么配怎么用 Python 内置的 turtle 海龟绘图写出会动的画面快速获得编程的正反馈。我的判断是Python 第一课的目标不是背语法而是让代码在屏幕上留下痕迹。环境搞通、海龟跑起来你已经击败了 50% 卡在第一步的人。下文会按完整流程操作建议配合电脑边看边做。1. 环境配置为什么是 Python 入门的第一座山很多人以为 Python 入门是从print()开始的实际并不是。第一关永远是你的电脑上有没有一个能运行 Python 代码的运行时环境。这里的核心概念是解释器。Python 是一门解释型语言代码写完之后需要由 Python 解释器一句一句地读入并执行。如果电脑上根本没有安装解释器那么无论代码写得多正确双击运行都会报错。新手容易踩的误区有三个以为写了 .py 文件就能跑实际上需要安装解释器以为安装好了就能全局使用实际上还需要处理 PATH 环境变量以为必须用 PyCharm 这种大型 IDE 才能学实际上轻量编辑器更适合第一课。有一个很典型的场景能说明问题一个同学在 Windows 上装完 Python 后打开命令行输入python结果跳出了微软商店。这不是他没装好而是系统把python命令指向了 Windows 的应用执行别名。这种问题是环境配置里最常见的坑后文会专门讲解。从大量新手反馈来看环境配置阶段消耗的时间甚至超过学习前两周语法的时间。因此第一课应该先把环境彻底打通再谈写代码。环境配置的本质不是安装下一步下一步,而是搞清楚你的代码将会被哪个程序执行以及系统如何找到这个程序。2. 先搞懂解释器、PATH 和 IDE 之间的关系在下载安装包之前先花两分钟理解几个基础概念。这些概念是后续所有操作的基石也是网上许多教程默认你已经知道、但新手往往不清楚的部分。2.1 Python 解释器Python 解释器是一个可执行程序它的职责是读取我们写的 .py 文件把源代码逐行翻译成计算机能执行的指令。常见的解释器实现是 CPython也就是 python.org 官方发布的版本。安装 Python本质就是把这个解释器放到你的电脑上。2.2 PATH 环境变量PATH 是操作系统维护的一个路径列表。当你在终端里输入python时系统会按 PATH 里记录的目录顺序去查找是否存在名为python的可执行文件。如果安装 Python 时没有把解释器所在目录加入 PATH那么输入python就会提示找不到命令。这是整个配置过程里最值得关注的步骤。2.3 编辑器和 IDE编辑器负责高亮语法、补全代码、管理文件比如 VSCodeIDE除了编辑功能还集成了调试、项目管理、版本控制等完整工具链比如 PyCharm。对入门者来说PyCharm 功能强大但界面复杂VSCode 轻量且插件生态成熟更适合作为第一课工具。VSCode 本身不是 Python 环境它只是编辑器真正的运行仍然依赖 Python 解释器。2.4 turtle 库turtle 是 Python 内置标准库之一不需要额外安装只要 Python 环境正常import turtle就能用。它模拟了一只海龟在画布上爬行通过前进、后退、左转、右转绘制线条和图形。因为反馈直观它非常适合作为 Python 第一课的练习工具。下面用一个表格总结这些概念的关系概念角色是否会单独安装Python 解释器负责执行代码是下载安装包PATH 环境变量操作系统寻找命令的路径列表安装时配置VSCode代码编辑与运行入口独立安装Python 插件VSCode 识别 Python 代码的桥梁插件市场安装turtle绘图标准库无需安装内置3. Python 环境安装与验证3.1 Windows 安装步骤在 Windows 上安装 Python 的第一原则是一定要勾选 Add Python to PATH。这个选项在安装向导的第一屏底部很多人因为没注意或不理解而跳过导致后患无穷。完整步骤打开 python.org 官网 Downloads 页面下载 Windows 安装包双击运行安装包底部勾选 Add Python to PATH点击 Install Now等待安装完成点击 Close。安装完成之后按下Win R输入cmd打开命令提示符执行python --version如果输出类似Python 3.x.x说明安装成功。如果输出的是不是内部或外部命令则说明 PATH 配置出了问题需要手动将 Python 安装目录加入系统环境变量或者重新运行安装包并勾选 PATH 选项。还有一个常见情况输入python后弹出微软商店。这是因为 Windows 的应用执行别名拦截了python命令。解决方法是打开设置 - 应用 - 高级应用设置 - 应用执行别名关闭python.exe和python3.exe两个开关。3.2 macOS 安装步骤macOS 系统自带的 Python 版本通常比较旧不建议直接用系统 Python 跑项目。推荐从 python.org 下载 macOS 安装包或者使用 Homebrew 安装。使用 Homebrew 的方式brew install python3安装完成后在终端验证python3 --versionmacOS 上执行python3而不是python。如果希望输入python也能识别可以在 shell 配置文件中做别名不过对入门阶段来说python3已经够用。3.3 验证 pip 是否可用Python 安装包通常自带 pip 包管理器。在终端执行pip --version如果提示找不到 pip在 Windows 上可以尝试python -m pip --versionpython -m pip的意思是用 python 解释器运行 pip 这个模块这种方式能绕过 PATH 找不到 pip 的问题也是后文排查依赖问题的常用手段。4. 为什么第一课推荐 VSCode 而不是 PyCharm环境配置好后下一步是选编辑器。这里直接给出结论Python 第一课首选 VSCode。原因有三个启动快、体积小PyCharm 是完整的 IDE启动和索引时间较长对入门机器的性能要求更高插件生态灵活VSCode 最核心的是 Python 插件和 Pylance 语言服务功能上已经足够支撑日常学习前端、后端、脚本都能写VSCode 不仅支持 Python以后学 JavaScript、Java、Go 也能继续用迁移成本低。有人会担心 VSCode 配置复杂。实际上你只需要安装一个扩展剩下的工作就是选择解释器这一个动作。VSCode 的 Python 插件会主动扫描电脑中的 Python 环境省去手动填路径的麻烦。4.1 安装 VSCode打开 VSCode 官网下载对应操作系统的安装包Windows 用户选择 User Installer 即可macOS 用户选择 Apple Silicon 或 Intel 版本安装时按默认选项即可。安装完成后左侧就是扩展市场。4.2 必装插件清单至少安装以下插件插件名称作用Python微软官方扩展提供运行、调试、代码补全PylancePython 语言服务器提供类型检查和代码提示Python Debugger断点调试支持在扩展市场分别搜索上面名称点击 Install。安装 Python 插件时VSCode 通常会自动提示安装 Pylance可以一并确认。5. VSCode Python 开发环境具体配置插件装好后还需要完成两项配置创建项目文件夹以及选择 Python 解释器。5.1 创建项目文件夹建议在电脑上单独建一个python-learn文件夹后续所有代码都放在里面。在 VSCode 中点击文件 - 打开文件夹选择这个目录。这样每个项目隔离不会出现文件乱放找不到的问题。5.2 选择 Python 解释器按下Ctrl Shift PmacOS 为Cmd Shift P输入Python: Select Interpreter回车后选择之前安装的 Python 版本。如果前面只有系统 Python 或没有识别到环境可以点击输入解释器路径手动选择 python 可执行文件。这一步做对之后VSCode 右下角状态栏会显示当前解释器版本例如Python 3.12.x。5.3 创建虚拟环境推荐虽然入门阶段直接用全局环境也能跑但更规范的做法是给每个项目建一个虚拟环境。虚拟环境的含义是为当前项目单独隔离出一份 Python 运行空间避免多个项目之间依赖互相污染。在 VSCode 中打开终端执行python -m venv venvWindows 下激活虚拟环境venv\Scripts\activatemacOS / Linux 下激活虚拟环境source venv/bin/activate激活后命令行提示符前面会出现(venv)字样表示现在正处于虚拟环境中。之后安装的任何包都只属于该项目。5.4 可选配置 settings.jsonVSCode 的 Python 插件会在用户设置中生成默认配置。如果你希望保存代码时自动格式化可以在项目根目录的.vscode/settings.json中写入{ python.defaultInterpreterPath: ./venv/bin/python, editor.formatOnSave: true, editor.tabSize: 4 }注意Windows 下python.defaultInterpreterPath需要写成./venv/Scripts/python.exe。这不是必做步骤但对后续编写更正式的项目有帮助。6. 第一个 Python 程序Hello World 与运行验证环境全部就绪后来跑第一个程序。在项目文件夹下新建hello.py写入# 文件路径hello.py print(Hello, Python!) name input(请输入你的名字) print(欢迎你 name 开始 Python 之旅)保存后点击 VSCode 右上角的三角形运行按钮或者直接在终端执行python hello.py预期效果控制台先输出Hello, Python!然后等待你输入名字回车后输出欢迎语。如果你在运行按钮下拉菜单里看到了多个 Python 环境务必确认选中了当前虚拟环境。一个高频错误是VSCode 里选择了解释器 A终端却激活的是解释器 B导致ModuleNotFoundError。判断方式很简单运行前先看终端提示符前面有没有(venv)。7. turtle 海龟绘图用图形化方式理解编程三要素环境问题和基础运行都打通之后接下来是本文最有意思的部分海龟绘图。turtle 能帮你在第一课就建立代码控制计算机的直观感受。它天然覆盖了编程入门最重要三个要素顺序、循环、函数。turtle 的核心模型是画布上有一只海龟它手里拿着一支笔。你可以指挥它前进、后退、转弯、抬笔、落笔。海龟走过的路线会留下痕迹。这个概念看起来简单却蕴含了图形学里的坐标和状态思想。7.1 画一个正方形理解顺序执行新建turtle_square.py# 文件路径turtle_square.py import turtle t turtle.Turtle() # 创建海龟对象 t.pencolor(blue) # 设置画笔颜色 t.pensize(3) # 设置画笔粗细 t.forward(100) # 向前移动 100 像素 t.right(90) # 右转 90 度 t.forward(100) t.right(90) t.forward(100) t.right(90) t.forward(100) t.right(90) turtle.done() # 保持窗口不关闭运行后一个蓝色正方形会出现在窗口中。这段代码展示了顺序执行从上到下、逐行运行。right(90)是让海龟顺时针转身 90 度四次移动加四次转弯刚好回到起点。在 Windows 上如果运行后窗口一闪而过多半是因为最后没有写turtle.done()。它相当于告诉 turtle画完了但先不要关闭窗口。7.2 用循环画彩色螺旋理解循环和取模重复代码可以用循环简化。把四段移动代码改成for循环并加入颜色变化# 文件路径turtle_spiral.py import turtle t turtle.Turtle() t.speed(10) # 提高绘图速度 colors [red, orange, yellow, green, blue, purple] for i in range(36): t.pencolor(colors[i % len(colors)]) # 轮流切换颜色 t.forward(i * 5) # 边长逐渐增加 t.right(95) # 转弯角度 turtle.done()运行后你会看到一个彩色螺旋线。这里的核心是for i in range(36)它让海龟执行 36 次循环每次前进的距离从 0、5、10、15……逐渐变大转弯 95 度。因为长期转弯角度不是 90 度海龟不会回到原点而是画出一个美丽的螺旋。colors[i % len(colors)]用取模运算让颜色索引在 0 到 5 之间循环这是代码中相当常用的技巧用取模把一组值循环起来。7.3 画五角星理解角度和图形规律五角星是一个经典练习。很多人下意识觉得五角星内角是 36 度但海龟转弯需要的是外角 144 度。# 文件路径turtle_star.py import turtle t turtle.Turtle() t.pencolor(red) t.pensize(2) for _ in range(5): t.forward(150) t.right(144) turtle.done()如果用 72 度五边形的外角画出来的是正五边形用 144 度画出来的是五角星。这是一个很好的思考题为什么两个角度相差一倍图形从五边形变成了五角星答案在于 144 度让海龟每次转向超过了 90 度于是会走向内凹方向形成星形。7.4 指定画布和背景默认画布尺寸和背景可能不够美观可以在绘图前设置import turtle turtle.setup(800, 600) # 画布宽 800高 600 turtle.bgcolor(black) # 背景色 t turtle.Turtle() t.pencolor(cyan) t.speed(6) t.circle(100) # 画半径为 100 的圆 turtle.done()turtle.setup()设置窗口大小turtle.bgcolor()设置背景色t.circle(100)直接绘制圆形。这段代码综合了窗口管理、颜色设置和曲线绘制。从第一课的角度看turtle 最大的价值是把看不见的代码执行过程变成看得见的图形变化。当你理解了前进、转弯、循环、颜色这套组合再回去学变量、条件判断、函数会轻松很多。8. 常见问题与排查思路新手阶段报错和环境问题会反复出现。我把最常见的问题整理成一张排查表遇到问题时按顺序检查。问题现象可能原因排查方式解决方案命令提示符输入 python 提示不是内部或外部命令安装时未勾选 Add Python to PATH检查系统环境变量中是否有 Python 路径重装安装包并勾选 PATH或手动添加目录输入 python 后弹出微软商店Windows 应用执行别名未关闭打开设置 - 应用执行别名关闭 python.exe 和 python3.exe 开关VSCode 运行代码提示 ModuleNotFoundError当前运行环境不是项目虚拟环境查看终端是否显示 (venv)激活虚拟环境或重新选择解释器turtle 运行后窗口一闪而过缺少 turtle.done()查看代码末尾在代码最后加 turtle.done()macOS 上 import turtle 报 No module named tkinter系统缺少 tkinter 支持检查 Python 安装来源安装官方 Python 包或通过 Homebrew 安装 python-tkpip 安装包提示外部管理环境使用了系统自带 Python执行 python -m pip使用虚拟环境后安装VSCode 中中文输出乱码文件编码与终端编码不一致查看右下角编码格式统一使用 UTF-8 编码保存一个更通用的排错思路是遇到报错先读最后一行大部分问题在最后一行已经指出原因然后再用搜索引擎搜索该报错信息。很多新手一看到红色英文就慌实际上 Python 的报错已经非常友好了它会告诉你哪一行出了什么类型的错误。9. 最佳实践与工程建议环境配置只是起点但这里的一些习惯会直接影响你后面学 Python 能走多远。9.1 每个项目单独建虚拟环境哪怕现在只写一个画正方形的脚本也建议先建venv。等以后用到requests、flask、pandas这些第三方库时你不会因为全局环境被各种包搅乱而痛苦。虚拟环境的使用成本极低收益却很高。9.2 命名要规范文件名不要用中文和空格也不要叫test.py这种没有辨识度的名字。建议用turtle_square.py这种模块_功能的命名风格。变量名同样如此用t表示海龟没问题但用my_turtle更清楚。9.3 善用print()调试新手写代码最容易犯的错误是觉得代码对了但跑起来不是预期结果。这时候不用急着改代码先在有疑问的位置插入print()把变量值打出来。例如查看循环中i和颜色值是否正确for i in range(36): print(i, i % len(colors), colors[i % len(colors)])看到输出的一瞬间很多问题就清晰了。这是最朴素也最有效的调试手段。9.4 先看清楚报错再搜索很多同学一报错就复制整段英文去搜索结果翻了几页也没找到答案。推荐做法是先看报错信息的类型比如SyntaxError、NameError、TypeError再看具体是哪一行最后把核心报错信息复制到搜索框。这样命中率远高于整段粘贴。9.5 从小项目里找正反馈环境配置完成之后不建议一上来就啃大部头语法书。可以给自己定几个小目标画一面五星红旗、画一个彩色棋盘、写一个猜数字游戏、用小海龟模拟简单的路径动画。每个项目控制在半小时到一小时做完一个就总结一次。这种即时可见的反馈比背十个概念更有用。9.6 注意保存与版本管理虽然现在还是入门阶段但建议尽早将代码放在一个独立目录中结合 Git 做版本管理。哪怕只做本地提交也能让你看清楚自己每一步写了什么、改了什么。等到项目变大这个习惯会帮你避免灾难性的文件丢失。9.7 后续学习路线参考环境、编辑器、turtle 都掌握后可以按下面顺序继续深入变量和数据类型整数、浮点数、字符串、布尔值条件判断if / elif / else循环for / while与嵌套循环函数def和模块化编程字符串常用方法和列表、字典文件读写异常处理try / except第三方库安装与使用。这个顺序不建议乱跳。很多同学学了两个星期就急着做爬虫结果连列表切片都没搞懂遇到报错完全无法招架。基础语法阶段稳扎稳打后面才会快。本文到这里核心流程已经完整呈现安装 Python、配置 PATH、装好 VSCode、安装插件、创建虚拟环境、运行 Hello World、用 turtle 画出第一张图。从零开始做一遍大概一两个小时就能完成。如果你在某一环节卡住了回看对应章节的排查表大多数问题都能在那里找到答案。环境配置不是编程里最有趣的部分但它决定你是把时间花在写代码上还是耗在环境上。把这张基础打好后面的 Python 学习会顺利很多。
Python入门实战：环境配置、VSCode设置与turtle绘图完整教程
Python 入门教程其实多到看不完但真正把环境配置 代码编辑器 第一个能看得到的程序串成一堂完整课的并不多。很多零基础同学第一次接触 Python 时不是被语法劝退而是被环境折腾到崩溃下载了 Python 安装包装完却提示python 不是内部或外部命令装了 PyCharm一堆配置看不懂写好了第一行print(hello world)又不知道在哪里运行。这篇文章就不绕弯子了直接解决三个问题Python 解释器应该怎么装装完怎么验证VSCode 为什么适合做 Python 入门工具插件怎么配怎么用 Python 内置的 turtle 海龟绘图写出会动的画面快速获得编程的正反馈。我的判断是Python 第一课的目标不是背语法而是让代码在屏幕上留下痕迹。环境搞通、海龟跑起来你已经击败了 50% 卡在第一步的人。下文会按完整流程操作建议配合电脑边看边做。1. 环境配置为什么是 Python 入门的第一座山很多人以为 Python 入门是从print()开始的实际并不是。第一关永远是你的电脑上有没有一个能运行 Python 代码的运行时环境。这里的核心概念是解释器。Python 是一门解释型语言代码写完之后需要由 Python 解释器一句一句地读入并执行。如果电脑上根本没有安装解释器那么无论代码写得多正确双击运行都会报错。新手容易踩的误区有三个以为写了 .py 文件就能跑实际上需要安装解释器以为安装好了就能全局使用实际上还需要处理 PATH 环境变量以为必须用 PyCharm 这种大型 IDE 才能学实际上轻量编辑器更适合第一课。有一个很典型的场景能说明问题一个同学在 Windows 上装完 Python 后打开命令行输入python结果跳出了微软商店。这不是他没装好而是系统把python命令指向了 Windows 的应用执行别名。这种问题是环境配置里最常见的坑后文会专门讲解。从大量新手反馈来看环境配置阶段消耗的时间甚至超过学习前两周语法的时间。因此第一课应该先把环境彻底打通再谈写代码。环境配置的本质不是安装下一步下一步,而是搞清楚你的代码将会被哪个程序执行以及系统如何找到这个程序。2. 先搞懂解释器、PATH 和 IDE 之间的关系在下载安装包之前先花两分钟理解几个基础概念。这些概念是后续所有操作的基石也是网上许多教程默认你已经知道、但新手往往不清楚的部分。2.1 Python 解释器Python 解释器是一个可执行程序它的职责是读取我们写的 .py 文件把源代码逐行翻译成计算机能执行的指令。常见的解释器实现是 CPython也就是 python.org 官方发布的版本。安装 Python本质就是把这个解释器放到你的电脑上。2.2 PATH 环境变量PATH 是操作系统维护的一个路径列表。当你在终端里输入python时系统会按 PATH 里记录的目录顺序去查找是否存在名为python的可执行文件。如果安装 Python 时没有把解释器所在目录加入 PATH那么输入python就会提示找不到命令。这是整个配置过程里最值得关注的步骤。2.3 编辑器和 IDE编辑器负责高亮语法、补全代码、管理文件比如 VSCodeIDE除了编辑功能还集成了调试、项目管理、版本控制等完整工具链比如 PyCharm。对入门者来说PyCharm 功能强大但界面复杂VSCode 轻量且插件生态成熟更适合作为第一课工具。VSCode 本身不是 Python 环境它只是编辑器真正的运行仍然依赖 Python 解释器。2.4 turtle 库turtle 是 Python 内置标准库之一不需要额外安装只要 Python 环境正常import turtle就能用。它模拟了一只海龟在画布上爬行通过前进、后退、左转、右转绘制线条和图形。因为反馈直观它非常适合作为 Python 第一课的练习工具。下面用一个表格总结这些概念的关系概念角色是否会单独安装Python 解释器负责执行代码是下载安装包PATH 环境变量操作系统寻找命令的路径列表安装时配置VSCode代码编辑与运行入口独立安装Python 插件VSCode 识别 Python 代码的桥梁插件市场安装turtle绘图标准库无需安装内置3. Python 环境安装与验证3.1 Windows 安装步骤在 Windows 上安装 Python 的第一原则是一定要勾选 Add Python to PATH。这个选项在安装向导的第一屏底部很多人因为没注意或不理解而跳过导致后患无穷。完整步骤打开 python.org 官网 Downloads 页面下载 Windows 安装包双击运行安装包底部勾选 Add Python to PATH点击 Install Now等待安装完成点击 Close。安装完成之后按下Win R输入cmd打开命令提示符执行python --version如果输出类似Python 3.x.x说明安装成功。如果输出的是不是内部或外部命令则说明 PATH 配置出了问题需要手动将 Python 安装目录加入系统环境变量或者重新运行安装包并勾选 PATH 选项。还有一个常见情况输入python后弹出微软商店。这是因为 Windows 的应用执行别名拦截了python命令。解决方法是打开设置 - 应用 - 高级应用设置 - 应用执行别名关闭python.exe和python3.exe两个开关。3.2 macOS 安装步骤macOS 系统自带的 Python 版本通常比较旧不建议直接用系统 Python 跑项目。推荐从 python.org 下载 macOS 安装包或者使用 Homebrew 安装。使用 Homebrew 的方式brew install python3安装完成后在终端验证python3 --versionmacOS 上执行python3而不是python。如果希望输入python也能识别可以在 shell 配置文件中做别名不过对入门阶段来说python3已经够用。3.3 验证 pip 是否可用Python 安装包通常自带 pip 包管理器。在终端执行pip --version如果提示找不到 pip在 Windows 上可以尝试python -m pip --versionpython -m pip的意思是用 python 解释器运行 pip 这个模块这种方式能绕过 PATH 找不到 pip 的问题也是后文排查依赖问题的常用手段。4. 为什么第一课推荐 VSCode 而不是 PyCharm环境配置好后下一步是选编辑器。这里直接给出结论Python 第一课首选 VSCode。原因有三个启动快、体积小PyCharm 是完整的 IDE启动和索引时间较长对入门机器的性能要求更高插件生态灵活VSCode 最核心的是 Python 插件和 Pylance 语言服务功能上已经足够支撑日常学习前端、后端、脚本都能写VSCode 不仅支持 Python以后学 JavaScript、Java、Go 也能继续用迁移成本低。有人会担心 VSCode 配置复杂。实际上你只需要安装一个扩展剩下的工作就是选择解释器这一个动作。VSCode 的 Python 插件会主动扫描电脑中的 Python 环境省去手动填路径的麻烦。4.1 安装 VSCode打开 VSCode 官网下载对应操作系统的安装包Windows 用户选择 User Installer 即可macOS 用户选择 Apple Silicon 或 Intel 版本安装时按默认选项即可。安装完成后左侧就是扩展市场。4.2 必装插件清单至少安装以下插件插件名称作用Python微软官方扩展提供运行、调试、代码补全PylancePython 语言服务器提供类型检查和代码提示Python Debugger断点调试支持在扩展市场分别搜索上面名称点击 Install。安装 Python 插件时VSCode 通常会自动提示安装 Pylance可以一并确认。5. VSCode Python 开发环境具体配置插件装好后还需要完成两项配置创建项目文件夹以及选择 Python 解释器。5.1 创建项目文件夹建议在电脑上单独建一个python-learn文件夹后续所有代码都放在里面。在 VSCode 中点击文件 - 打开文件夹选择这个目录。这样每个项目隔离不会出现文件乱放找不到的问题。5.2 选择 Python 解释器按下Ctrl Shift PmacOS 为Cmd Shift P输入Python: Select Interpreter回车后选择之前安装的 Python 版本。如果前面只有系统 Python 或没有识别到环境可以点击输入解释器路径手动选择 python 可执行文件。这一步做对之后VSCode 右下角状态栏会显示当前解释器版本例如Python 3.12.x。5.3 创建虚拟环境推荐虽然入门阶段直接用全局环境也能跑但更规范的做法是给每个项目建一个虚拟环境。虚拟环境的含义是为当前项目单独隔离出一份 Python 运行空间避免多个项目之间依赖互相污染。在 VSCode 中打开终端执行python -m venv venvWindows 下激活虚拟环境venv\Scripts\activatemacOS / Linux 下激活虚拟环境source venv/bin/activate激活后命令行提示符前面会出现(venv)字样表示现在正处于虚拟环境中。之后安装的任何包都只属于该项目。5.4 可选配置 settings.jsonVSCode 的 Python 插件会在用户设置中生成默认配置。如果你希望保存代码时自动格式化可以在项目根目录的.vscode/settings.json中写入{ python.defaultInterpreterPath: ./venv/bin/python, editor.formatOnSave: true, editor.tabSize: 4 }注意Windows 下python.defaultInterpreterPath需要写成./venv/Scripts/python.exe。这不是必做步骤但对后续编写更正式的项目有帮助。6. 第一个 Python 程序Hello World 与运行验证环境全部就绪后来跑第一个程序。在项目文件夹下新建hello.py写入# 文件路径hello.py print(Hello, Python!) name input(请输入你的名字) print(欢迎你 name 开始 Python 之旅)保存后点击 VSCode 右上角的三角形运行按钮或者直接在终端执行python hello.py预期效果控制台先输出Hello, Python!然后等待你输入名字回车后输出欢迎语。如果你在运行按钮下拉菜单里看到了多个 Python 环境务必确认选中了当前虚拟环境。一个高频错误是VSCode 里选择了解释器 A终端却激活的是解释器 B导致ModuleNotFoundError。判断方式很简单运行前先看终端提示符前面有没有(venv)。7. turtle 海龟绘图用图形化方式理解编程三要素环境问题和基础运行都打通之后接下来是本文最有意思的部分海龟绘图。turtle 能帮你在第一课就建立代码控制计算机的直观感受。它天然覆盖了编程入门最重要三个要素顺序、循环、函数。turtle 的核心模型是画布上有一只海龟它手里拿着一支笔。你可以指挥它前进、后退、转弯、抬笔、落笔。海龟走过的路线会留下痕迹。这个概念看起来简单却蕴含了图形学里的坐标和状态思想。7.1 画一个正方形理解顺序执行新建turtle_square.py# 文件路径turtle_square.py import turtle t turtle.Turtle() # 创建海龟对象 t.pencolor(blue) # 设置画笔颜色 t.pensize(3) # 设置画笔粗细 t.forward(100) # 向前移动 100 像素 t.right(90) # 右转 90 度 t.forward(100) t.right(90) t.forward(100) t.right(90) t.forward(100) t.right(90) turtle.done() # 保持窗口不关闭运行后一个蓝色正方形会出现在窗口中。这段代码展示了顺序执行从上到下、逐行运行。right(90)是让海龟顺时针转身 90 度四次移动加四次转弯刚好回到起点。在 Windows 上如果运行后窗口一闪而过多半是因为最后没有写turtle.done()。它相当于告诉 turtle画完了但先不要关闭窗口。7.2 用循环画彩色螺旋理解循环和取模重复代码可以用循环简化。把四段移动代码改成for循环并加入颜色变化# 文件路径turtle_spiral.py import turtle t turtle.Turtle() t.speed(10) # 提高绘图速度 colors [red, orange, yellow, green, blue, purple] for i in range(36): t.pencolor(colors[i % len(colors)]) # 轮流切换颜色 t.forward(i * 5) # 边长逐渐增加 t.right(95) # 转弯角度 turtle.done()运行后你会看到一个彩色螺旋线。这里的核心是for i in range(36)它让海龟执行 36 次循环每次前进的距离从 0、5、10、15……逐渐变大转弯 95 度。因为长期转弯角度不是 90 度海龟不会回到原点而是画出一个美丽的螺旋。colors[i % len(colors)]用取模运算让颜色索引在 0 到 5 之间循环这是代码中相当常用的技巧用取模把一组值循环起来。7.3 画五角星理解角度和图形规律五角星是一个经典练习。很多人下意识觉得五角星内角是 36 度但海龟转弯需要的是外角 144 度。# 文件路径turtle_star.py import turtle t turtle.Turtle() t.pencolor(red) t.pensize(2) for _ in range(5): t.forward(150) t.right(144) turtle.done()如果用 72 度五边形的外角画出来的是正五边形用 144 度画出来的是五角星。这是一个很好的思考题为什么两个角度相差一倍图形从五边形变成了五角星答案在于 144 度让海龟每次转向超过了 90 度于是会走向内凹方向形成星形。7.4 指定画布和背景默认画布尺寸和背景可能不够美观可以在绘图前设置import turtle turtle.setup(800, 600) # 画布宽 800高 600 turtle.bgcolor(black) # 背景色 t turtle.Turtle() t.pencolor(cyan) t.speed(6) t.circle(100) # 画半径为 100 的圆 turtle.done()turtle.setup()设置窗口大小turtle.bgcolor()设置背景色t.circle(100)直接绘制圆形。这段代码综合了窗口管理、颜色设置和曲线绘制。从第一课的角度看turtle 最大的价值是把看不见的代码执行过程变成看得见的图形变化。当你理解了前进、转弯、循环、颜色这套组合再回去学变量、条件判断、函数会轻松很多。8. 常见问题与排查思路新手阶段报错和环境问题会反复出现。我把最常见的问题整理成一张排查表遇到问题时按顺序检查。问题现象可能原因排查方式解决方案命令提示符输入 python 提示不是内部或外部命令安装时未勾选 Add Python to PATH检查系统环境变量中是否有 Python 路径重装安装包并勾选 PATH或手动添加目录输入 python 后弹出微软商店Windows 应用执行别名未关闭打开设置 - 应用执行别名关闭 python.exe 和 python3.exe 开关VSCode 运行代码提示 ModuleNotFoundError当前运行环境不是项目虚拟环境查看终端是否显示 (venv)激活虚拟环境或重新选择解释器turtle 运行后窗口一闪而过缺少 turtle.done()查看代码末尾在代码最后加 turtle.done()macOS 上 import turtle 报 No module named tkinter系统缺少 tkinter 支持检查 Python 安装来源安装官方 Python 包或通过 Homebrew 安装 python-tkpip 安装包提示外部管理环境使用了系统自带 Python执行 python -m pip使用虚拟环境后安装VSCode 中中文输出乱码文件编码与终端编码不一致查看右下角编码格式统一使用 UTF-8 编码保存一个更通用的排错思路是遇到报错先读最后一行大部分问题在最后一行已经指出原因然后再用搜索引擎搜索该报错信息。很多新手一看到红色英文就慌实际上 Python 的报错已经非常友好了它会告诉你哪一行出了什么类型的错误。9. 最佳实践与工程建议环境配置只是起点但这里的一些习惯会直接影响你后面学 Python 能走多远。9.1 每个项目单独建虚拟环境哪怕现在只写一个画正方形的脚本也建议先建venv。等以后用到requests、flask、pandas这些第三方库时你不会因为全局环境被各种包搅乱而痛苦。虚拟环境的使用成本极低收益却很高。9.2 命名要规范文件名不要用中文和空格也不要叫test.py这种没有辨识度的名字。建议用turtle_square.py这种模块_功能的命名风格。变量名同样如此用t表示海龟没问题但用my_turtle更清楚。9.3 善用print()调试新手写代码最容易犯的错误是觉得代码对了但跑起来不是预期结果。这时候不用急着改代码先在有疑问的位置插入print()把变量值打出来。例如查看循环中i和颜色值是否正确for i in range(36): print(i, i % len(colors), colors[i % len(colors)])看到输出的一瞬间很多问题就清晰了。这是最朴素也最有效的调试手段。9.4 先看清楚报错再搜索很多同学一报错就复制整段英文去搜索结果翻了几页也没找到答案。推荐做法是先看报错信息的类型比如SyntaxError、NameError、TypeError再看具体是哪一行最后把核心报错信息复制到搜索框。这样命中率远高于整段粘贴。9.5 从小项目里找正反馈环境配置完成之后不建议一上来就啃大部头语法书。可以给自己定几个小目标画一面五星红旗、画一个彩色棋盘、写一个猜数字游戏、用小海龟模拟简单的路径动画。每个项目控制在半小时到一小时做完一个就总结一次。这种即时可见的反馈比背十个概念更有用。9.6 注意保存与版本管理虽然现在还是入门阶段但建议尽早将代码放在一个独立目录中结合 Git 做版本管理。哪怕只做本地提交也能让你看清楚自己每一步写了什么、改了什么。等到项目变大这个习惯会帮你避免灾难性的文件丢失。9.7 后续学习路线参考环境、编辑器、turtle 都掌握后可以按下面顺序继续深入变量和数据类型整数、浮点数、字符串、布尔值条件判断if / elif / else循环for / while与嵌套循环函数def和模块化编程字符串常用方法和列表、字典文件读写异常处理try / except第三方库安装与使用。这个顺序不建议乱跳。很多同学学了两个星期就急着做爬虫结果连列表切片都没搞懂遇到报错完全无法招架。基础语法阶段稳扎稳打后面才会快。本文到这里核心流程已经完整呈现安装 Python、配置 PATH、装好 VSCode、安装插件、创建虚拟环境、运行 Hello World、用 turtle 画出第一张图。从零开始做一遍大概一两个小时就能完成。如果你在某一环节卡住了回看对应章节的排查表大多数问题都能在那里找到答案。环境配置不是编程里最有趣的部分但它决定你是把时间花在写代码上还是耗在环境上。把这张基础打好后面的 Python 学习会顺利很多。