把 Python 作为第一门编程语言最大的门槛通常不在语法而在环境。很多新手卡在“装好 Python 之后命令行里找不到”或者“VSCode 装了插件还是不能运行”代码本身反而没遇到问题。这篇文章把 Python 入门前三件事一次性讲完Python 解释器环境配置、VSCode 开发环境搭建、海龟绘图实战。一路跟下来你能跑通第一个.py文件并用标准库turtle画出第一个图形。 这次内容不涉及第三方深度学习框架也不需要独立显卡只要能安装普通桌面软件、能打开命令行就能完成全部操作。文章会给出 Windows、macOS、Linux 三类系统的通用配置思路重点解决三个高频问题Python 装完为什么不能直接用、VSCode 怎么选解释器、turtle 画图窗口为什么一闪而过。1. Python 入门第一课核心能力速览项目说明学习主题Python 环境配置、VSCode 开发环境、turtle 海龟绘图适合读者零基础新手、从其他语言转 Python 的开发者系统支持Windows / macOS / LinuxPython 版本建议 Python 3.10 及以上稳定版代码编辑器Visual Studio Code必备插件Python、Pylance、Python Debugger、Code Runner图形库turtlePython 标准库自带无需 pip 安装前置知识无能打开命令行即可完成标志在 VSCode 中运行 Python 脚本并用 turtle 画出图形从这张表能看出本教程的核心不是某个复杂框架而是把 Python 入门阶段最容易踩坑的“环境”和“编辑器”两件事处理干净。后面所有操作都以这三个目标为主线解释器能运行、VSCode 能调用解释器、turtle 能稳定显示画布。2. 适用场景与学习路径2.1 适合谁这套内容适合完全没写过 Python 的人也适合以前用记事本写代码、想换到 VSCode 学习的人。Python 的初学者常见状态是看过语法书但没真正在本地跑起来或者是装过 Anaconda但不知道虚拟环境、解释器、终端、PATH 这些概念之间是什么关系。本文把这些概念放到具体操作里讲比单纯看“Python 入门教程”更容易落地。2.2 能学到什么完成本文全部步骤后你会有以下几个可量化的成果本机安装了一个可用的 Python 解释器能在终端正确执行python --version。掌握虚拟环境venv的创建和激活不污染全局 Python。使用 VSCode 打开项目选择虚拟环境解释器并能运行、调试.py文件。使用标准库turtle完成正方形、五角星、彩色螺旋线等图形绘制。这些成果覆盖了 Python 入门阶段 80% 的常见问题终端找不到命令、pip 装包装不进去、VSCode 运行按钮是灰色、画图窗口闪退。2.3 不涉及的内容本文不涉及数据分析、Web 后端、爬虫、人工智能等方向的具体实战。这些主题都需要建立在“能熟练运行 Python 脚本”的基础上。如果后续想向爬虫方向发展请先明确目标网站的授权许可和访问规则不要采集受版权保护的内容也不要对其他服务器施加访问压力如果向自动化方向发展同样需要先确认操作对象的使用协议。3. 环境准备Python 解释器与 PATH 配置3.1 下载 Python 安装包打开 Python 官网的下载页面选择稳定版即可。Windows 用户下载.exe安装包建议选择 64 位版本macOS 用户下载 universal2 安装包Linux 用户一般可以通过系统包管理器安装。具体文件名随版本更新会有变化认准官方域名即可不要从第三方下载站拿安装包。3.2 Windows 安装要点Windows 安装过程中最关键的一步是勾选 Install Now 页面底部的Add Python to PATH。这个选项默认是关闭的如果漏勾Python 不会加入系统环境变量后续在 cmd 或 PowerShell 里输入python就会提示“不是内部或外部命令”。建议勾选后直接点击 Install Now不需要进 Customize installation 做额外改动。安装完成后按Win R输入cmd打开终端执行python --version如果输出类似Python 3.12.x说明安装成功。如果提示找不到命令大概率是 PATH 没有生效解决方案见下一小节。3.3 手动添加 PATH已经装完但命令行找不到python时可以手动把 Python 安装目录和 Scripts 目录加进系统环境变量。进入“设置 - 系统 - 关于 - 高级系统设置 - 环境变量”在Path变量中新增两条C:\Users\你的用户名\AppData\Local\Programs\Python\Python312\ C:\Users\你的用户名\AppData\Local\Programs\Python\Python312\Scripts\注意把你的用户名和Python312替换成实际路径。如果安装时选择了自定义目录路径也要对应修改。保存后重新打开一个 cmd 窗口再执行python --version验证。3.4 macOS / Linux 安装macOS 可以用 Homebrew 安装brew install pythonUbuntu / Debian 系可以用 apt 安装sudo apt update sudo apt install python3 python3-pip python3-venv在这些系统里命令名可能是python3而不是python。安装后验证python3 --version3.5 用 venv 创建虚拟环境虚拟环境能为每个项目隔离依赖版本是 Python 工程化的基础操作。在项目目录中创建虚拟环境mkdir my_first_python cd my_first_python python -m venv .venvWindows 激活.venv\Scripts\activatemacOS / Linux 激活source .venv/bin/activate激活成功后命令行提示符前面会出现(.venv)字样说明当前终端已经进入虚拟环境。这样安装包时不会影响全局 Python。3.6 pip 与批量依赖安装pip是 Python 官方包管理器激活虚拟环境后直接使用pip install requests如果下载速度不理想可以指定国内镜像pip install -i https://pypi.tuna.tsinghua.edu.cn/simple requests当项目依赖变多时把包名和版本写入requirements.txtrequests2.32.3 flask3.0.3批量安装全部依赖pip install -r requirements.txt初学者建议从requirements.txt开始管理依赖这比每次手动安装更容易排查问题。4. VSCode 开发环境配置4.1 安装 VSCode从 VSCode 官网下载对应系统的安装包。Windows 用户选择 User Installer 64-bit 即可。安装完成后首次打开会看到一个欢迎页先不要急着写代码接着装插件。4.2 安装 Python 相关插件VSCode 本身是编辑器Python 支持需要扩展。点击左侧扩展图标搜索并安装以下插件PythonMicrosoft 官方扩展包含语法高亮、智能补全、运行调试等核心能力Pylance快速、类型感知的 Python 语言服务Python Debugger提供断点调试能力Code Runner可选方便一键运行多种语言的脚本。第一次打开 VSCode 时打开任意.py文件编辑器右下角可能会弹出推荐安装 Python 扩展的提示但手动安装更可控。4.3 选择 Python 解释器安装完插件后按Ctrl Shift P输入Python: Select Interpreter选择刚才创建的虚拟环境.venv路径下的 Python。如果列表里没有点击Enter interpreter path手动填写。这一步非常关键。VSCode 的运行按钮、调试器、终端、代码补全都依赖解释器路径。如果解释器选错成全局 Python项目内安装的依赖可能无法识别。4.4 基础配置 settings.json按Ctrl Shift P输入Open User Settings (JSON)可以加入以下基础配置{ python.defaultInterpreterPath: .venv/Scripts/python.exe, files.autoSave: afterDelay, editor.formatOnSave: true, files.encoding: utf8 }注意python.defaultInterpreterPath在 Windows 和 macOS 下路径不同macOS / Linux 通常是.venv/bin/python。如果这个配置写错VSCode 会回退到手动选择的解释器。4.5 使用 VSCode 内建终端按Ctrl 打开 VSCode 内建终端。如果已经在 VSCode 中打开项目目录并且激活过虚拟环境新开的终端通常会继承工作区状态。确认终端提示符前有(.venv)说明当前环境正确。5. 第一个 Python 程序运行与调试5.1 创建项目与脚本在 VSCode 中点击“文件 - 打开文件夹”选择my_first_python目录。新建文件hello.py输入print(Hello, Python!) print(1 2)建议全部使用英文路径避免中文或空格导致个别工具解析异常。5.2 运行 Python 脚本的三种方式点击 VSCode 右上角的三角运行按钮按下Ctrl F5直接运行不调试右键代码编辑器选择Run Python File in Terminal。三种方式都会在终端执行当前文件。预期输出Hello, Python! 3如果输出结果与预期一致说明 Python 解释器、VSCode 插件、虚拟环境这一套链路已经打通。5.3 增加交互输入Python 入门阶段可以尝试输入输出程序name input(请输入你的名字) print(你好, name)运行后在终端输入名字并回车程序会输出问候语。这个例子能帮助理解变量和程序执行顺序。5.4 断点调试入门调试能直观展示程序执行过程。在代码行号左侧点击会出现红色圆点这就是断点。写一个简单例子def add(a, b): result a b return result print(add(3, 4))在result a b这一行打上断点按F5选择Python Debugger。程序会停在断点处左侧调试面板可以看到变量a 3、b 4。按F10单步执行能看到result被赋值为7的整个过程。6. 海龟绘图实战从正方形到彩色螺旋6.1 turtle 的基本工作原理turtle是 Python 标准库不需要 pip 安装。它模拟一个小海龟在画布上移动小海龟移动时留下的轨迹就是图形。核心方法包括forward()前进、backward()后退、right()右转、left()左转、pencolor()设置画笔颜色、fillcolor()设置填充颜色。6.2 绘制正方形新建square.py输入import turtle t turtle.Turtle() for _ in range(4): t.forward(100) t.right(90) turtle.exitonclick()运行后屏幕会出现一个画布小海龟前进 100 像素、右转 90 度循环 4 次后回到起点形成正方形。turtle.exitonclick()表示点击画布后关闭窗口如果不写这一行很多环境下窗口会一闪而过。6.3 绘制五角星五角星的关键是每次转 144 度。新建star.pyimport turtle t turtle.Turtle() t.speed(5) for _ in range(5): t.forward(150) t.right(144) turtle.exitonclick()这个例子适合练习循环次数和角度之间的关系。如果角度不对图形要么不闭合要么画成多边形。6.4 彩色螺旋线螺旋线综合了颜色列表、取模运算和循环import turtle t turtle.Turtle() t.speed(10) colors [red, orange, gold, green, blue, purple] for i in range(60): t.pencolor(colors[i % len(colors)]) t.forward(i * 3) t.right(59) turtle.exitonclick()运行后会得到一条不断变长并旋转的彩色螺旋线。这里i % len(colors)是一个常见的取模用法保证画笔颜色在颜色列表中循环切换。6.5 颜色填充如果需要绘制填充图形用begin_fill()和end_fill()import turtle t turtle.Turtle() t.fillcolor(red) t.begin_fill() for _ in range(4): t.forward(100) t.right(90) t.end_fill() turtle.exitonclick()绘制过程中可以先fillcolor()设置填充色也可以配合pencolor()分别设置描边色。填充是 turtle 入门阶段比较直观的视觉效果。6.6 用函数封装绘图逻辑当图形变复杂可以封装成函数复用。例如画任意边数的正多边形import turtle t turtle.Turtle() def draw_polygon(sides, length): angle 360 / sides for _ in range(sides): t.forward(length) t.right(angle) draw_polygon(6, 100) turtle.exitonclick()这个例子把“边数”和“长度”抽成参数是 Python 函数概念的很好入门练习。6.7 turtle 的常见运行现象画布窗口一闪而过脚本末尾缺少turtle.exitonclick()或turtle.done()。图形画到一半停止循环内的角度计算错误程序结束后窗口仍存在但不再绘制。终端卡住turtle 的事件循环会一直等待窗口关闭这是正常现象点击画布或按Ctrl C可以中断。7. 常见问题与排查方法问题现象可能原因排查方式解决方案终端提示“python 不是内部或外部命令”Python 未加入 PATH检查环境变量 Path重装时勾选 Add Python to PATH或手动添加安装路径终端提示“pip 不是内部或外部命令”未正确安装或 Scripts 目录缺失执行where python修复 Python 安装确认 Scripts 目录在 Path 中VSCode 运行按钮是灰色未安装 Python 扩展或未选择解释器按CtrlShiftP选择解释器安装 Python 扩展并选择虚拟环境解释器import turtle 报 ModuleNotFoundError解释器异常或不是标准库环境检查当前解释器路径turtle 是标准库确认没有选错 Python 环境海龟绘图窗口一闪而过脚本末尾缺少 turtle.exitonclick()查看脚本最后一行添加turtle.exitonclick()中文代码或输出乱码文件编码不是 UTF-8查看 VSCode 右下角编码重新以 UTF-8 保存或设置files.encoding: utf8安装了第三方库但程序仍找不到使用了错误的解释器或虚拟环境未激活在 VSCode 终端执行pip list激活虚拟环境重新选择解释器遇到问题先看终端输出再检查解释器路径和环境变量。绝大多数 Python 入门问题都出在这三个位置。8. 最佳实践与学习建议8.1 保持清晰的目录结构建议从第一天开始就按项目划分目录不把所有.py文件堆在一个文件夹里my_first_python/ ├── .venv/ ├── hello.py ├── square.py ├── star.py └── requirements.txt.venv目录不需要手动修改虚拟环境坏了重建即可。输入文件、输出文件、脚本文件分开放后续做数据处理或自动化任务时会更省心。8.2 先小后大先单文件后多文件入门阶段每次只写一个小的脚本跑通之后再往里面加功能。画图时先画一条线再画正方形再扩展成多边形和螺旋线。这样出现问题可以快速定位到是哪一行逻辑出错。8.3 学习过程中的合规意识如果后续要用 Python 做自动化、爬虫或数据处理一定要提前确认数据来源的合法授权。不要采集涉及个人隐私的内容不要请求没有授权的接口不要对目标服务产生过大的访问压力。技术能力本身没有边界但使用场景必须遵守法律和服务协议。8.4 下一步学习路线完成环境配置和 turtle 绘图后可以按以下顺序继续基础语法变量、字符串、列表、字典、函数、文件读写常用标准库os、pathlib、json、datetime第三方库requests、beautifulsoup4、pandas工程化工具git、pytest、ruff。每一步都要在 VSCode 里实际运行代码只看不跑很难建立手感。9. 总结与下一步这篇文章覆盖了 Python 入门的完整链路解释器安装、PATH 配置、虚拟环境、VSCode 插件、解释器选择、第一个程序、turtle 图形绘制和常见报错排查。最值得先验证的是安装后终端能否正确打印版本号最容易踩的坑是 Windows 安装时没勾选Add Python to PATH画图时最容易被忽略的是脚本末尾的turtle.exitonclick()。把这三点处理清楚Python 入门阶段的环境问题基本就解决了。接下来你要做的不是继续看教程而是亲手新建一个hello.py和square.py依次运行通过。先完成这两个脚本再回到文章补读环境变量和虚拟环境的概念整个学习脉络就会清晰很多。建议把这篇文章收藏备用后面如果遇到 Python 环境问题直接从“常见问题与排查方法”那张表开始查。