Python入门第一课：环境配置、VSCode与turtle绘图完整指南

如果你准备学 Python第一道坎往往不是语法本身而是“把环境跑起来”。很多新手把时间全浪费在安装、配置、报错排查上结果一周过去连第一行 print 都没看到。这篇文章把 Python 入门第一课要遇到的事情一次性讲清楚Python 环境配置、VSCode 编辑器配置、海龟绘图 turtle 基础教程。全部是零基础可以直接照着做的路径不需要提前掌握任何编程概念。本合集适合四类读者刚接触编程的在校生、准备转行做数据或自动化办公的职场人、想给小朋友做编程启蒙的家长老师以及之前装过 Python 但始终没跑通 VSCode 的“半入门选手”。内容覆盖从安装到运行、再到画图验证的完整闭环重点解决“装完了不知道下一步干嘛”和“环境变量报错不知道怎么修”这两个高频问题。下面直接进入正文。1. Python 入门第一课内容速览项目说明教程主题Python 环境配置、VSCode 开发环境、海龟绘图入门核心工具Python 3.x、VSCode、turtle 标准库适用人群零基础编程新手、Python 初学者、少儿编程老师操作系统Windows 10/11、macOS、主流 Linux 发行版是否需要 GPU不需要普通办公电脑即可是否需要付费软件不需要Python 与 VSCode 均为免费重点能力环境变量配置、插件安装、解释器选择、断点调试、turtle 绘图最终成果能用 VSCode 运行 Python 程序并用 turtle 画出正方形、五角星、螺旋线和花朵学习耗时约 1 到 2 小时这一课不涉及框架、不涉及人工智能模型、不涉及复杂的 Web 开发。它只解决一件事让一台干净的电脑具备运行 Python 程序的能力并且用视觉化的 turtle 绘图让你直观感受到代码的执行过程。先跑通小闭环再谈后续进阶这是最稳妥的学习顺序。2. Python 环境配置安装前准备与版本选择很多新手卡在环境配置环节原因是安装 Python 时没有理解两个关键概念解释器和环境变量。简单说Python 解释器是真正执行代码的程序环境变量则是告诉你的电脑“到哪里去找这个解释器”。这两个概念理解了后续绝大多数报错都能自己解决。2.1 先检查本机是否已安装 Python在安装之前先打开终端检查一下电脑是否已经存在 Python。Windows 用户按 Win R 输入 cmd 回车macOS 用户按 Command 空格搜索“终端”Linux 用户打开任意终端。python --version如果提示找不到命令再试一下python3 --version如果两条命令都提示未找到说明电脑还没有安装 Python可以跳到 2.2 节。如果已经输出版本号比如 Python 3.12.4说明环境里已经有 Python可以跳过安装步骤直接进入 VSCode 配置。这里要特别提醒看到python3有版本不代表python命令一定能用很多 macOS 和 Linux 系统默认只注册python3这是正常现象后续选择解释器时注意区分即可。2.2 下载与安装 PythonWindows 示例Windows 用户直接去 Python 官网下载安装包建议选择 Python 3.10 或更高的稳定版本。这里以通用安装流程为例安装时有两个勾选项至关重要勾选Add Python to PATH这个选项会自动帮你把 Python 写入系统环境变量不加这一步后面在终端里会反复出现python 不是内部或外部命令。选择Install Now采用默认安装路径即可不要为了省空间改到带中文或空格的目录比如C:\Program Files (x86)\Python312这类路径也能用但新手建议使用默认路径减少手动配置的出错概率。安装完成后重新打开一个新的 cmd 窗口再执行一次python --version如果输出正常说明环境变量配置成功。如果仍然提示找不到命令大概率是安装时没有勾选 Add to PATH可以手动添加 Python 安装目录到系统环境变量也可以直接卸载重装重装时记得勾选。对新手来说卸载重装反而更快。2.3 macOS / Linux 的安装方式macOS 用户可以直接从官网下载 macOS 安装器双击安装后默认会安装到/Library/Frameworks/Python.framework/Versions/目录安装器本身会处理环境变量。安装完成后在终端执行python3 --version如果希望让python命令直接可用可以在 shell 配置文件中添加别名。注意不同 shell 的配置文件不同zsh 用户修改~/.zshrcbash 用户修改~/.bashrcalias pythonpython3 alias pippip3Linux 用户优先使用系统包管理器安装。以 Ubuntu/Debian 为例sudo apt update sudo apt install python3 python3-pip -y无论哪种系统安装完成后都建议确认python3 --version和pip3 --version能正常输出。这里需要区分pip是 Python 的包管理工具后面安装第三方库时要用到它。2.4 验证安装python 命令与 PATH环境配置是否成功看三个信息Python 版本、pip 版本、当前解释器路径。执行以下命令python --version pip --version where python # Windows 显示 python.exe 所在路径macOS 和 Linux 用户可以用which python3查看路径。看到这些信息后环境配置这一步就算完成了。如果 pip 提示版本过旧可以用python -m pip install --upgrade pip更新不影响整体环境。3. VSCode 安装与 Python 开发环境配置Python 本身提供的是命令行运行环境但直接写代码需要一个编辑器。推荐使用 VSCode因为它免费、跨平台、插件生态成熟而且对 Python 的支持非常完善几乎可以做到开箱即用。3.1 安装 VSCode在 VSCode 官网下载对应系统的安装包即可。Windows 用户安装时会遇到一个“选择附加任务”的界面建议把创建桌面快捷方式、添加到 PATH、注册为代码文件编辑器这几个选项选上尤其是添加到 PATH这样以后可以在任意终端里直接输入code命令打开编辑器。macOS 用户安装后将应用拖入“应用程序”目录首次打开时如果提示“无法验证开发者”右键点击图标选择“打开”即可这是 macOS 对未签名应用的常规提醒。Linux 用户可以使用发行版自带的软件中心安装也可以下载 .deb 或 .rpm 安装包。安装完成后打开 VSCode左侧边栏默认显示文件资源管理器、搜索、源代码管理、运行和调试等图标。如果界面是英文按 Ctrl Shift PmacOS 是 Command Shift P打开命令面板输入Configure Display Language安装中文语言包并切换。切换后重启 VSCode 即可显示中文界面。3.2 安装 Python 扩展Python 扩展是 VSCode 支持 Python 开发的核心插件安装它之后才会获得语法高亮、智能提示、代码补全、调试等功能。在 VSCode 左侧点击扩展图标四个方块图标搜索Python选择由 Microsoft 发布的插件进行安装。这一步通常会连带安装两个辅助插件Pylance 和 Python Debugger。Pylance 负责类型检查和智能补全Python Debugger 负责断点调试。完整安装后扩展栏里应该能看到这三个组件都处于启用状态。安装完成并不代表配置结束还需要让 VSCode 知道你使用哪一个 Python 解释器。按 Ctrl Shift P 打开命令面板输入Python: Select Interpreter选择之前步骤里安装好的 Python 版本。如果命令面板里找不到这个命令说明 Python 扩展没有加载成功检查扩展是否禁用或者重启 VSCode 后再试。选中解释器后VSCode 左下角状态栏会显示当前解释器版本这一步是绝大多数新手遗漏的环节许多“代码写好了但运行报错”的问题都是因为解释器没有选对。3.3 插件市场加载失败的备选方案部分网络环境下VSCode 插件市场可能加载缓慢或无法显示插件列表。这时有几个备选方案。第一种是在命令面板中输入Install Extensions from VSIX从本地安装插件文件第二种是直接从 VSCode 官网的插件市场页面手动下载 .vsix 文件再拖入编辑器窗口安装第三种是为 VSCode 配置国内镜像源但涉及修改 settings.json 文件新手操作时需要谨慎。实际上更常见的问题是插件列表能看到但点击安装后长时间卡住。此时可以检查网络连接或者把插件安装源切换到镜像站在 VSCode 的settings.json中配置extensionsGallery相关参数。这里不展开详细配置代码因为不同 VSCode 版本字段会有差异。最稳妥的做法是下载离线安装包。安装离线 .vsix 包的流程为下载插件文件后打开 VSCode点击扩展图标点击右上角三个点选择Install from VSIX找到下载的 .vsix 文件完成安装。Python 扩展、Pylance、Python Debugger 都支持这种方式。3.4 选择 Python 解释器解释器选择是 VSCode 配置 Python 环境的核心动作。同一个电脑上可能安装多个 Python 版本比如系统自带的 Python、官网安装的 Python、Anaconda 内置的 Python。如果选了错误的解释器代码可能无法运行或者安装了某些包却提示 ModuleNotFoundError。在 VSCode 中打开一个.py文件后点击右下角状态栏的解释器名称也可以快速切换解释器。建议新建一个项目文件夹在项目文件夹根目录下创建.vscode/settings.json手动指定解释器路径。例如 Windows 用户可能这样写{ python.defaultInterpreterPath: C:/Python312/python.exe, python.terminal.activateEnvironment: true }这里一定要按你的实际安装路径修改不同版本号路径不同。如果不知道安装在哪在终端执行where pythonWindows或which python3macOS/Linux获取路径。3.5 可选的辅助插件除了官方 Python 扩展这几个插件对新手写 Python 也有帮助插件名称作用Python Indent自动处理缩进减少 Tab 和空格混用产生的报错Code Runner一键运行多种语言脚本支持右键运行 Python 文件Prettier代码格式化工具团队协作时保持风格统一Error Lens在代码行内直接显示错误信息不用等运行时报错GitLens查看代码提交历史和多人修改信息后期协作时很有用注意这些插件不是必须的第一课先装官方 Python 扩展即可。Code Runner 虽然方便但它在运行时使用的 Python 版本可能和你在命令面板里选的不一致如果遇到版本不一致的问题优先使用 VSCode 自带的运行按钮减少变量干扰。4. 第一个 Python 程序运行、调试与常见报错环境配置完成以后就可以开始写第一行代码了。这个阶段的目标是跑通一个最简程序并理解 VSCode 中运行 Python 的几种方式。4.1 创建项目目录在电脑任意位置新建一个文件夹命名为python-first-lesson然后用 VSCode 打开这个文件夹。可以通过菜单栏“文件 - 打开文件夹”完成也可以在终端中执行cd python-first-lesson code .code .命令需要 VSCode 安装时勾选了“添加到 PATH”如果提示找不到命令说明没有添加手动打开 VSCode 后选择文件夹即可。在项目根目录下新建文件hello.py注意文件名不要用中文不要和 Python 内置模块重名比如turtle.py、random.py都不适合作为自己的文件名否则会遮蔽标准库导致导入异常。4.2 编写第一个脚本在hello.py中输入以下代码print(Hello, Python!)这段代码的含义是向控制台输出一行文本。写完后按 Ctrl S 保存VSCode 对未保存的文件会在标签页上显示一个圆点。4.3 三种运行方式VSCode 中运行 Python 脚本有三种方式方式一点击编辑器右上角的三角形运行按钮这是最推荐的方式它会自动使用当前选择的解释器执行当前文件。方式二在终端中手动运行。python hello.py方式三右键点击代码编辑区选择Run Python File in Terminal效果和方式一类似。运行后下方集成终端应该显示Hello, Python!到这里第一个程序就算跑通了。如果终端没有任何输出先判断是不是运行了错误的文件如果提示No Python interpreter selected回到第 3.2 节选择解释器。4.4 使用断点调试先了解一个最基础的调试概念——断点。断点就是一个暂停标记代码运行到这一行时会停下来让你观察当前变量的值。这一能力在后续写复杂逻辑时非常关键。在hello.py的左侧行号位置单击可以在某一行添加红色圆点断点。然后按 F5 启动调试选择Python Debugger或Python File调试配置。程序会在断点处暂停左侧“运行和调试”面板会显示 Locals局部变量、Watch监视变量等内容。按 F10 执行下一行按 F11 进入当前函数内部按 Shift F5 结束调试。如果 F5 弹出选择配置的菜单说明项目里还没有调试配置文件。可以在“运行和调试”面板点击create a launch.json file选择PythonVSCode 会自动生成一个基础调试配置。5. 海龟绘图用 turtle 画出第一张图环境配置和基础运行解决了接下来用一个视觉化项目加深理解海龟绘图。turtle 是 Python 自带的标准库不需要额外安装它的设计思路是“一只小海龟在画布上爬行爬过的地方留下笔迹”非常适合用来理解顺序、循环、函数这些编程基础概念。5.1 turtle 是标准库不需要额外安装先明确一点turtle 不需要执行 pip install。任何正常安装的 Python 3 都自带 turtle 模块。如果遇到ModuleNotFoundError: No module named turtle说明当前解释器不是标准的 CPython比如某些精简版 Python 环境或虚拟环境裁剪过标准库这时需要切换到完整的 Python 解释器。在海龟绘图中最常用的函数有函数作用turtle.forward(n)海龟向前移动 n 像素turtle.backward(n)海龟向后移动 n 像素turtle.left(angle)海龟向左旋转 angle 度turtle.right(angle)海龟向右旋转 angle 度turtle.penup()抬起画笔移动时不画线turtle.pendown()落下画笔移动时画线turtle.color(c)设置画笔颜色turtle.pensize(n)设置画笔粗细turtle.speed(n)设置绘图速度turtle.done()启动事件循环保持窗口不关闭5.2 画正方形画一个正方形是最基础的入门案例。先建立顺序执行的思维前进、转弯、再前进重复四次。新建一个square.py文件输入如下代码import turtle t turtle.Turtle() for _ in range(4): t.forward(100) t.left(90) turtle.done()运行后会出现一个独立的图形窗口一只小箭头模样的“海龟”沿直线前进 100 像素左转 90 度再前进如此循环四次。代码中的range(4)控制循环次数_表示循环变量此时不需要使用。如果窗口打开后一闪而过说明事件循环没有启动参考第 5.5 节解决。5.3 用循环画五角星画出五角星的关键在于确定每一次旋转的角度。五角星的每个角对应的外转角度是 144 度所以循环 5 次每次前进 150 像素后右转 144 度。import turtle t turtle.Turtle() t.color(red) t.pensize(2) for _ in range(5): t.forward(150) t.right(144) turtle.done()你可以对比正方形和五角星的代码差异会发现两者的结构完全相同只是循环次数和旋转角度不同。这就是循环控制的魅力通过改变参数可以得到完全不同的图形。5.4 螺旋线与花朵感受循环的魅力掌握循环后可以进一步画出更复杂的图形。螺旋线通过让每段前进距离递增实现import turtle t turtle.Turtle() t.speed(10) for distance in range(0, 200, 5): t.forward(distance) t.left(91) turtle.done()花朵图案则通过嵌套循环实现外层循环控制每个花瓣的旋转内层循环画正方形import turtle t turtle.Turtle() t.speed(10) for _ in range(36): for _ in range(4): t.forward(100) t.left(90) t.left(10) turtle.done()运行这个文件你会看到 36 个正方形组成的圆形花朵。相比死记硬背语法这种立刻看到反馈的学习方式更容易理解循环嵌套的作用。建议你修改外层循环次数和旋转角度观察图形变化这会帮助你建立“预估结果 - 运行验证 - 调整参数”的思维习惯。一次画太多图形时窗口可能有点卡顿这是正常的因为 turtle 使用 Tkinter 绘制逐条画线需要时间。可以降低speed值或减少循环次数来加速。5.5 窗口闪退与事件循环在 Windows 上运行 turtle 程序时最常遇到的问题就是窗口闪退。原因是代码执行完毕后进程退出图形窗口随进程一起被关闭。解决方案有几种方案一在代码结尾使用turtle.done()它会启动 Tkinter 的事件循环让窗口保持打开直到你手动关闭。方案二使用turtle.exitonclick()窗口会一直打开直到点击画布任意位置才关闭。方案三在程序最后加一个input()阻塞进程但推荐使用前两种更规范的方式。如果使用在线编辑器或远程服务器运行 turtle通常看不到图形界面需要考虑本地运行。6. 运行调试进阶launch.json 与终端命令当程序从简单的打印和画图逐渐扩展到多个文件、命令行传参、读取数据文件时单纯点击右侧运行按钮就不够用了。这时需要理解 VSCode 的调试配置机制。6.1 使用 Python Debugger打开“运行和调试”面板如果项目中没有配置文件点击create a launch.json file选择PythonVSCode 会生成一个基础配置{ version: 0.2.0, configurations: [ { name: Python: 当前文件, type: debugpy, request: launch, program: ${file}, console: integratedTerminal } ] }这个配置的含义是使用 debugpy 调试器启动运行当前打开的文件默认输出到 VSCode 集成终端。${file}是 VSCode 的变量表示当前激活文件路径。之后按 F5 会直接使用这个配置启动调试不再弹出选择菜单。6.2 自定义 launch.json当项目有多个文件时可能需要固定运行入口文件而不是当前文件。可以把program改为固定路径{ name: Python: 运行 main.py, type: debugpy, request: launch, program: ${workspaceFolder}/main.py, console: integratedTerminal, args: [--input, data.txt] }其中args数组表示启动时传入的命令行参数会在运行main.py时自动附加到命令末尾。这种配置在做文件处理、批量任务、参数化实验时非常实用。在launch.json中可以同时配置多个调试方案通过面板下拉框切换。6.3 终端运行与传入参数除了调试配置终端手动运行也常用。假设你写了一个接收参数的海龟绘图脚本import sys import turtle steps int(sys.argv[1]) t turtle.Turtle() for _ in range(4): t.forward(steps) t.left(90) turtle.done()在终端中执行python square_with_args.py 200sys.argv是一个列表sys.argv[0]是脚本文件名sys.argv[1]是传入的第一个参数。这种方式可以把脚本接到其他工具或批量任务中是后续学习自动化处理的重要基础。7. Python 学习常见问题排查问题现象可能原因排查方式解决方案终端提示 python 不是内部或外部命令安装 Python 时未勾选 Add to PATH检查环境变量中是否存在 Python 路径重装 Python 并勾选添加到 PATH或手动添加环境变量VSCode 左下角提示未选择解释器Python 扩展未加载或未执行选择命令按 CtrlShiftP 输入 Select Interpreter安装官方 Python 扩展然后选择解释器插件市场列表加载失败网络原因或插件源异常检查网络尝试安装离线 vsix从官网下载 .vsix 文件使用 Install from VSIX 安装运行 Python 文件提示 No module named turtle使用了精简版解释器或当前虚拟环境没有标准库在终端执行python -m turtle验证切换完整版 Python 解释器重新选择解释器turtle 绘图窗口一闪而过程序执行完进程退出窗口未保持检查代码末尾是否有 done()在代码末尾加turtle.done()或turtle.exitonclick()代码报错 IndentationErrorTab 和空格混用或缩进层级不一致查看报错行号和行首空白统一使用 4 个空格缩进关闭 VSCode 自动 Tab 替换中文输出乱码文件编码与控制台编码不一致检查终端编码格式在 Python 文件首行不建议处理优先在 VSCode 中设置终端编码为 UTF-8pip 安装第三方库速度很慢默认下载源在国外观察下载进度使用国内镜像源如pip install -i https://pypi.tuna.tsinghua.edu.cn/simple 包名右键菜单找不到 Run Python FilePython 扩展未正确加载检查扩展是否禁用重新打开 VSCode确认 Python 扩展已启用调试时提示 debugpy 未安装调试器组件缺失查看扩展列表在扩展市场安装 Python Debugger 扩展以上问题覆盖了新手第一周学习时最常遇到的十种情况。遇到报错不要直接搜索代码片段本身先看报错信息最后一行提示的位置和错误类型再做针对性修改。8. 最佳实践与后续学习建议8.1 给新手的环境管理建议环境配置完成后建议尽快上手虚拟环境。虚拟环境可以理解成一个独立的 Python 空间不同项目使用不同的包版本避免互相冲突。在项目目录中执行python -m venv .venv激活虚拟环境。Windows 用户执行.venv\Scripts\activatemacOS 和 Linux 用户执行source .venv/bin/activate创建项目时先建虚拟环境再安装项目依赖这一习惯从一开始就养成后期会省掉大量依赖冲突的麻烦。8.2 目录结构与命名规范建议把所有 Python 学习项目按学期或模块分目录存放例如python-learning/ lesson01-env/ hello.py square.py star.py lesson02-control/ ... notes/ README.md文件名一律小写英文字母和下划线不要使用空格和中文。每个项目文件夹内放一个README.md一句话说明这个项目做什么。这样一个学期后你的笔记就是一套完整的学习索引。8.3 学习路径参考第一课学完环境配置、VSCode 操作和 turtle 绘图后后续可以按这个顺序推进变量与数据类型 - 字符串操作 - 条件语句 - 循环进阶 - 列表和字典 - 函数 - 文件读写 - 第三方库安装与使用。学完这些基础后再根据自己的方向切入爬虫、数据分析或自动化办公。不要一上来就学框架也不要跳过基础直接看人工智能相关课程。9. 总结先跑通最小闭环再谈进阶这次教程的核心目标是让零基础读者掌握三个能力独立安装并配置 Python 环境、在 VSCode 中编写和调试 Python 程序、使用 turtle 库完成可视化绘图练习。这三件事跑通后你对“编程”的感知就不再是模糊的概念而是可以随时运行的小程序。建议你按顺序动手做一遍先安装 Python 并确认版本号再安装 VSCode 和 Python 扩展接着运行 hello.py最后修改 turtle 参数画出自己的图形。最容易踩的坑集中在环境变量、解释器选择和窗口闪退这三个环节遇到问题回到第 7 章的表格检查即可。环境配置完成后下一阶段可以把精力集中在语法和逻辑训练上。祝学习顺利。