01_Python学习路线与开发环境搭建：从安装到运行第一个程序 Python学习路线与开发环境搭建从安装到运行第一个程序学编程最劝退的时刻是什么不是写不出代码而是连环境都装不上。你兴冲冲地下载了 Python双击安装打开一个黑框框输了一行python结果蹦出来一句python 不是内部或外部命令。反复装了卸、卸了装一个小时过去了屏幕上还是一片空白——这种挫败感不少人都经历过。别急这篇文章就是让你一次性把环境跑通而且搞清楚每一步背后的原因。跑通之后你还能顺手写出一个带交互的小程序给自己一点正反馈。一、Python 解释器、编辑器、终端——这三个东西到底什么关系很多教程一上来就让下载安装但如果不先弄明白三个工具的分工后面很容易装是装上了但不知道哪个是哪个。你可以把写 Python 程序理解成开一家奶茶店Python 解释器是那台封口机。它负责执行你写好的指令。没有它你写的.py文件就是一份无人理会的配方。**VS Code编辑器**是你的操作台。你在上面写配方、调整顺序、标注注意事项。它让你写得舒服但它本身不会制作奶茶。**终端Terminal**是你和服务员之间的对讲机。你通过它向 Python 发号施令Python 也通过它告诉你结果。所以完整的流程是在 VS Code 里写代码编辑配方→ 保存成.py文件 → 在终端里调用 Python 去执行它。图1-1 Python 学习路线图全景展示本专栏 5 个阶段 20 篇内容的学习路径从入门基础到综合项目的递进关系一目了然。了解了角色分工之后我们开始动手。二、安装 Python 解释器第一步去哪里下载直接在浏览器搜索Python download或者打开python.org点首页那个黄色 Download 按钮。网站会自动识别你的操作系统——Windows 用户会得到一个.exe安装包。一个重要提醒不要从各种软件园下载站下载 Python。那些网站经常捆绑旧版本、加料安装器轻则版本不对重则电脑里多出一堆全家桶。Python 官网是唯一推荐的来源。第二步安装时必勾的一项双击安装包后会看到安装界面下面有一个复选框叫 “Add Python to PATH”一定要勾上。这个选项是什么意思把 Python 加入 PATH等于告诉 Windows“以后我在终端打python的时候你就去 Python 的安装目录找这个程序”。如果不勾每次想用 Python 都只能输入一长串完整路径比如C:\Users\你的用户名\AppData\Local\Programs\Python\Python312\python.exe——光看这一行就已经劝退了。勾上之后一路点 Next 就行。安装路径建议用默认的不要改。第三步验证安装安装完成后按Win R输入powershell回车打开 PowerShell。输入python--version如果看到类似Python 3.12.3的输出安装成功。如果看到python 不是内部或外部命令重新运行安装包选 “Modify”修改把 “Add Python to PATH” 勾上。接下来再试一个更有意思的python-cimport this你会看到一首英文小诗——Python 之禅The Zen of Python。这是 Python 社区的精神纲领以后你会慢慢理解每一句的含义。现在能看到它就说明一切就绪了。三、安装 VS Code 并配置好 Python 环境为什么选 VS Code写代码可以用记事本吗当然可以。但你很快会发现没有代码高亮、没有自动提示、没有错误标红写 50 行以上就开始眼睛疼。VS Code 是目前最流行的轻量级代码编辑器免费、启动快、插件丰富。Python 官方也推荐用它。下载和安装从code.visualstudio.com下载安装包一路下一步就行。安装过程中建议勾上这两个选项“将 Code 添加到右键菜单”——之后右键文件夹就能直接用 VS Code 打开“将 Code 注册为支持的编辑器”——双击.py文件可以直接打开安装 Python 插件打开 VS Code 后左侧竖排工具栏里有一个扩展图标四个小方块点它在搜索框输入 “Python”。找到微软官方出品、下载量上亿的那个 Python 扩展安装。这个插件会给你带来代码补全打前两个字后面自动提示错误检测语法错误直接红色波浪线标出不用等到运行才报错调试支持设置断点、单步执行、查看变量智能提示鼠标悬停在函数名上就能看到用法说明正确的打开方式打开文件夹而不是单个文件这一步初学者特别容易踩坑。VS Code 的正确用法是先建一个专门放代码的文件夹然后在 VS Code 里打开这个文件夹。比如你在 D 盘创建一个D:\PythonLearning文件夹然后在 VS Code 里点 “File → Open Folder”选这个文件夹。为什么因为后面你会学到导入模块——如果一个.py文件不在当前工作目录里Python 找不到它。打开文件夹等于告诉 VS Code“这是我的工作区所有文件都在这里”。你的终端路径也会自动切换到文件夹位置后面用python xxx.py时就省去了来回切换目录的麻烦。调整一个关键设置VS Code 默认的终端可能是 PowerShell 或 CMD都可以用。但如果你在终端里打python报错可能是 VS Code 没有识别到你安装 Python 时的 PATH 配置。最快的检查方法在 VS Code 里按Ctrl 反引号在 Esc 下面打开内置终端输入python --version。如果能输出版本号万事大吉如果不能重启一下 VS Code 一般就会自动识别——因为 VS Code 启动时会在系统 PATH 里搜索 Python。四、你的第一个 Python 程序——不只 print 一行字好环境全部就绪我们来写代码。在 VS Code 左侧文件列表里右键 → New File命名为hello.py。注意后缀必须是.py它是 Python 文件的身份证。很多教程的第一个程序是这样print(Hello, Python!)这当然没错但你刚开始的热情不应该只输出一行字就结束。来写一个真正跟你对话的小程序print(*40)print( 欢迎来到 Python 的世界)print(*40)print()nameinput(你叫什么名字)ageinput(今年多大了)hobbyinput(平时喜欢做什么)print()print(f你好{name})print(f{age}岁正是学编程的好时候。)print(f喜欢{hobby}的人学起代码来往往很有耐心。)print()print(从今天起你就是一名 Python 程序员了。)保存后在终端里运行python hello.py程序会逐行问你问题然后给出回应。看十几行代码你就写出了一个能和用户对话的程序——这不是比只输出一句Hello, Python!有意思多了吗图1-2 Python 开发环境组成展示 Python 解释器、VS Code 编辑器、终端和 .py 文件四者之间的协作关系。代码解读看不懂代码完全没关系我们简单过一遍每行在干什么print( * 40) * 40是把等号这个字符重复 40 遍然后用print()打印出来。效果就是一串横线用来做分隔。print()空print()等于打一个空行让输出看起来更清爽。name input(你叫什么名字)input()先显示括号里的提示文字然后等着你输入。你输入的内容会被存到name这个变量里。f你好{name}这是 f-string花括号里的name会被替换成你刚才输入的内容。后面会有专门的篇幅详细讲它。现在你不需要理解每一个细节。重点是你写了一段代码它运行了屏幕上有输出了——这个循环已经跑通。接下来 19 篇的所有内容都建立在这个基础之上。五、终端与交互模式终端生存指南新手的几个救命命令写代码免不了和终端打交道。你不需要成为命令行高手但下面这几个命令能在关键时刻救你一命。# 看看当前在哪个目录pwd# 列出当前目录有哪些文件ls# Windows 上也可以用 dir# 进入某个目录cd目录名# 返回上一级目录cd..# 清屏屏幕太乱时用clear# Windows 上用 cls# 强制中断正在运行的程序死循环时救命# 按 Ctrl C最常用的是cd和ls。比如你的代码放在D:\PythonLearning但你打开终端后默认在用户目录。这时候cdD:\PythonLearninglspython hello.py三步就能找到你的文件并运行它。熟练之后你会在 VS Code 内置终端里完成这些操作——按Ctrl 打开终端它默认就在你打开的项目文件夹里省去了cd 的步骤。善用 Python 交互模式最好的草稿纸你不需要每次都新建文件、写代码、保存、运行。Python 提供了一个即时对话模式——在终端直接输入python回车你会看到提示符。接下来你每敲一行代码Python 立刻给你结果。123hello.upper()HELLOlen(Python)6[1,2,3][4,5][1,2,3,4,5]这叫什么草稿纸。想验证一个函数怎么用、测试某行代码会不会报错、快速算个结果——直接丢进交互模式试试不用新建文件。要退出交互模式输入exit()或按Ctrl Z再回车。我个人的习惯是看教程看到一个不认识的函数或语法马上切到交互模式试一下。这种边看边试的效率比看完全文再写代码高得多。六、常见问题与进阶知识常见的安装问题自救手册下面这些是安装阶段最容易碰到的问题。建议你先扫一眼碰到问题时再回来翻阅——不用一次记住但也别出了事再慌张乱搜。python 不是内部或外部命令这是出现频率最高的问题。原因是安装时没勾 “Add Python to PATH”。两个方案方案 A推荐重新运行 Python 安装包选 “Modify”修改勾上 “Add Python to PATH”点 Install重启 VS Code。方案 B手动添加 PATH在 Windows 搜索框输入环境变量 → “编辑系统环境变量” → “环境变量” → 在系统变量中找到Path→ 双击 → 新建 → 添加 Python 的安装路径通常是C:\Users\你的用户名\AppData\Local\Programs\Python\Python312\和Scripts子目录。完成后重启 VS Code。pip 不是内部或外部命令pip 是 Python 的包管理工具后面会大量使用。如果python --version正常但pip --version报错在安装时确保勾选了 pip 组件。也可以手动运行python-mpip--version如果这样能正常显示说明 pip 能用只是没加 PATH。以后每次用 pip 时加python -m前缀即可。安装包时提示SSL 证书错误通常是公司网络或校园网做了代理拦截。尝试pipinstall包名 --trusted-host pypi.org --trusted-host files.pythonhosted.org装完 Python 后 VS Code 终端里还是找不到 python重启 VS Code。VS Code 启动时会扫描系统 PATH如果你刚装好 Python 就打开 VS Code它可能还没感知到 Python 的存在。关掉再开一般就能识别。图1-3 第一个 Python 程序运行流程从编写代码到终端输出结果的完整步骤示意包括常见的排错循环。Python 能干什么——给你一个全景地图在第一篇就给出全景是为了让你知道我现在在学什么、学完之后能做什么、每个阶段的目标是什么。不要被这张地图吓到——你不需要一次性学会全部按顺序走就行。本专栏 20 篇文章分为 5 个阶段第一阶段入门基础第 1~4 篇 环境搭建 → 数据类型 → 输入输出 → 运算符 目标能独立编写 20 行以内的计算程序 第二阶段流程控制与容器第 5~9 篇 分支结构 → 循环 → 列表元组 → 字典集合 → 字符串处理 目标能处理批量数据写出有逻辑判断的程序 第三阶段函数与工程基础第 10~12 篇 函数调试 → 模块包虚拟环境 → 文件操作异常处理 目标能把代码拆成可复用的模块读写文件不慌 第四阶段面向对象与进阶语法第 13~16 篇 类对象 → 继承多态 → 迭代器生成器 → 装饰器闭包作用域 目标能看懂并设计面向对象的代码结构 第五阶段标准库、第三方库与项目第 17~20 篇 常用标准库 → pip 和第三方库 → 数据处理实战 → 综合项目 目标能独立完成一个小型 Python 项目零基础读者建议老老实实按顺序来。Python 确实容易上手——但这不意味着可以跳着学。基础不打牢到了函数、模块、面向对象的地方一定会反复卡住然后回头翻基础——那时花的时间比老老实实按顺序学多得多。我该安装哪个 Python 版本这个问题初学者经常纠结。简单回答装最新的 3.x 稳定版就行目前是 3.12.x。你可能会在网上的老教程里看到Python 2.7——注意Python 2 在 2020 年已经停止维护了。如果你在 2024 年以后还在学 Python 2相当于买了部不能上网的手机。Python 2 和 Python 3 语法有差异最明显的是print在 2 里不需要括号3 里必须加括号现在所有的库和框架都用 Python 3没有任何理由再从 Python 2 开始。至于 Python 3.10、3.11、3.12 之间的选择——对你目前的学习来说差别微乎其微。新版本更快、报错信息更友好。装 3.12不会错。安装完成后在你电脑里 Python 实际上装了这几样东西python.exe解释器本体pip.exe包管理器装第三方库用的IDLEPython 自带的简易编辑器有了 VS Code 基本可以不用它标准库一套内置的工具箱后面第 17 篇会详讲VS Code 配置进阶让编码更舒服的几个小设置VS Code 装了 Python 插件后已经很能打了但你还可以做几件事让体验更上一层楼。打开自动保存VS Code 默认需要手动保存Ctrl S。初学者经常改了代码忘记保存就运行结果终端里跑的还是旧版本一脸困惑地瞪着屏幕“我明明改了啊”在 VS Code 里点File → Auto Save文件 → 自动保存打上勾。以后每次切到其他窗口VS Code 会自动帮你保存。注意自动保存不是一打字就保存而是当你失去焦点时比如切到终端窗口才触发。调整字体大小默认字体对有些人来说偏小。Ctrl 放大Ctrl -缩小。或者直接改设置File → Preferences → Settings搜索Font Size把Editor: Font Size改到你看着舒服的数字——14 或 16 是常见选择。中文用户特别注意如果你用的字体对中英文混排不友好比如英文等宽但中文不等宽代码里的中文注释会对不齐。推荐在设置里搜索Font Family在最前面加上Microsoft YaHei Mono, Cascadia Code,——这是微软雅黑等宽版中英文混排效果很好。装两个好用的辅助插件在扩展商店搜索安装Chinese (Simplified) Language Pack微软官方的中文语言包。装了之后 VS Code 菜单变成中文对英文不太好的同学友好很多。Code Runner安装后在代码编辑区右上角会出现一个三角形 Run 按钮点一下直接运行代码不用每次切到终端手动输python xxx.py。不过要注意Code Runner 适合快速预览正式的带input()交互的程序还是建议在终端里跑。理解 VS Code 的左侧工具栏几个你需要认识的面板资源管理器第一个图标看文件列表新建/删除/重命名文件都在这里搜索放大镜在项目中搜索文字后面查变量名、找报错位置很好用扩展四个方块安装和管理插件运行和调试三角形带虫子后面学断点调试时会用上其他的图标先不用管用到的时候自然会认识。Python 交互模式的更多玩法前面提到了交互模式是草稿纸这里再展开几个实用的用法。查看帮助文档在交互模式里对任何函数输入help()都能看到官方说明help(print)# 会显示出 print 函数的全部参数说明help(str)# 显示出字符串类型的所有方法按q退出帮助页面。以后你看到不认识的函数第一反应应该是help()一下而不是切到浏览器去搜——前者更快更准。查看对象有哪些方法namePythondir(name)# 列出字符串对象的所有可用方法和属性dir()函数像是一个工具清单——你想知道某样东西能做什么先dir()看一眼。快速测试一小段逻辑不确定一段代码逻辑对不对不用写完整文件交互模式直接试scores[85,92,78,95,88]sum(scores)/len(scores)87.6max(scores)95sorted(scores)[78,85,88,92,95]当计算器用2**101024100*(10.03)**5115.92740743000005最后一个结果是不是和你预期差了那么一点点这就是浮点数精度问题——下一篇会专门展开讲。养成一个习惯看教程学到新的函数或语法不要光看切到交互模式敲一遍。眼睛看三遍不如手指敲一遍。为什么不推荐一开始就用 PyCharm你可能会在知乎或 B 站看到有人推荐 PyCharm。PyCharm 确实是全宇宙最好的 Python IDE 之一但对初学者来说它的重量级可能适得其反。PyCharm 启动慢打开要等十几秒、界面复杂密密麻麻的按钮和面板、创建项目时需要选解释器、虚拟环境、项目类型……这些对有经验的开发者来说很方便但对刚入门的你来说每一步都可能是一个困惑的来源。VS Code 的优势在于轻、快、界面清爽不会用一堆高级功能把你淹没。等你把 Python 基础学扎实了如果想尝试 PyCharm迁移成本很低——代码还是那些代码换个编辑器打开就行。如果暂时不想装环境有时候你用的是学校机房电脑、别人的电脑或者暂时不方便安装软件。没关系有几个在线平台可以让你直接在浏览器里写 PythonGoogle Colab需科学上网免费的云端 Python 环境自带 GPU后面学数据分析时很好用Python 官方在线交互环境在python.org的 shell 页面可以直接写代码这些在线环境适合临时用、快速验证想法但不适合长期学习——因为代码不会保存到本地网速不好时会卡而且没有 VS Code 那些辅助功能。建议把在线环境当成替补方案。主力还是老老实实在自己电脑上装好 Python VS Code这是学好编程的必要投资。学会读报错信息——你能自己解决 80% 的问题编程中最常看到的不是运行成功而是满屏红字。很多新手看到报错就慌直接截图发群里问人。但如果你能学会自己读报错信息80% 的问题根本不用问别人。Python 的报错信息其实写得很友好。来看一个例子# 故意写错的代码name小明print(你好name你今年age岁了)运行后你会看到Traceback (most recent call last): File D:\PythonLearning\hello.py, line 3, in module print(你好 name 你今年 age 岁了) NameError: name age is not defined别看红了一片其实只有三行关键信息第一行Traceback (most recent call last)这是一个调用回溯告诉你错误发生在哪里。初学阶段你只需要知道它是来报信的就够了。第二行File ..., line 3告诉你错误在哪个文件的第 3 行。这就是你需要检查的位置。最后一行NameError: name age is not defined告诉你错误类型和原因——NameError是名字错误后面的说明是变量age没有被定义过。翻译成人话就是你用了一个不存在的变量。所以读报错的正确姿势是先看最后一行——那是最直接的错误描述再看上面的行号——定位到具体哪行出了问题把英文描述翻译一下——大部分报错类型都是自解释的下面列出初学者最常遇到的几个报错类型先混个眼熟以后碰到了就心里有数报错类型翻译一般是什么原因SyntaxError语法错误少写了冒号、括号没配对、引号用了中文全角NameError名字错误变量没定义就用了或者打错了变量名TypeError类型错误把不同类型的数据混在一起做了不合法的操作IndentationError缩进错误该缩进的地方没缩进或者缩进空格数不一致现在你可能还看不太懂这些错误没关系。重要的是树立一个意识报错不是惩罚是线索。Python 花了很大力气告诉你哪里不对、为什么不对如果你能养成读报错信息的习惯你解决问题的速度会比那些看到红字就截图问人的学习者快好几倍。一个实用小技巧VS Code 在你写代码的过程中就会用红色波浪线标出语法错误不用等到运行就能发现。这个功能叫静态检查是你学习过程中的隐形老师。关于学习方法——一个老程序员的建议在正式开始 20 篇的学习之前我想给你几条实用建议。这些建议来自我自己和身边程序员学习过程中踩过的坑。每天写 30 分钟好过周末突击 4 小时。编程是一种技能和弹钢琴、学外语本质上一样——每天练一点肌肉记忆慢慢形成一周不练回头发现全忘光了。建议每天至少打开 VS Code 敲 30 分钟哪怕只是把前一天的内容复习一遍。卡住了先自己查15 分钟还没解决再问人。碰到报错第一反应不是截图发群而是自己读报错信息、搜报错关键词。给你一个搜索技巧把报错的最后一行去掉你的文件名等个人信息直接复制到百度或 Google大概率前几条结果就是答案。这个技能比学会任何一个函数都重要。做笔记但不是照抄。学每个知识点的时候用自己的话总结一句话。比如学完input()你的笔记可以是“input 会把用户输入的任何东西当成字符串要算数得先转成数字”。这句话比抄十行代码有用。接受不理解的感觉。刚开始学的时候有些概念你就是没法完全理解——这是正常的。就像你第一次学骑自行车别人跟你讲保持平衡你听了也做不到。编程中的很多概念需要你在不同的场景里反复遇见四五次才会突然哦原来是这样。所以如果某个地方没完全懂先继续往下走。学到后面回头看你会发现之前纠结的东西豁然开朗。现在深呼吸打开 VS Code开始写你的第一行代码吧。最后说一个重要习惯从今天开始每一行代码都亲手敲。看教程的时候很容易产生我看懂了的错觉。但看懂和能写之间隔着一个太平洋。你能看懂一篇菜谱不代表你站在厨房里能炒出同样的菜。编程更是如此——很多错误只有在你亲手敲的时候才会暴露出来少了个冒号、缩进不对、引号用了中文全角……所以这篇里的示例代码不要复制粘贴。敲一遍运行看到结果然后再改一改——把欢迎来到 Python 的世界换成你想说的话多加几个input()试试不输入直接回车会怎样。编程是在犯错中学会的。现在多犯错以后就少踩坑。要点回顾Python 解释器、VS Code 编辑器、终端三者分工明确缺一不可安装 Python 时必须勾选 “Add Python to PATH”VS Code 的正确打开方式是打开文件夹而不是打开单个文件交互模式python回车是最趁手的草稿纸和计算器报错信息是你的朋友——先看最后一行再看行号把英文翻译一下就懂了每天敲 30 分钟碰到问题先自己查 15 分钟用自己话做笔记动手练习新建一个D:\PythonLearning文件夹在 VS Code 中打开它新建hello.py写出带三个input()的交互程序并成功运行。故意把python写成pythn观察终端报错信息——找到不是内部或外部命令那句确认你知道它是什么意思。在终端输入python进入交互模式把今天学的print()、input()、f-string 各试一遍。然后试试1 2、len(Python)、type(42)。卸载 Python控制面板 → 程序和功能然后重新安装——这次一定勾上 “Add Python to PATH”。装完后打开终端输python --version确认。这个装→卸→装的经历会让你以后帮别人装 Python 时胸有成竹。下篇预告下一篇我们将学习 Python 的数据类型——搞清楚整数、小数、字符串、布尔值到底怎么用以及那个让无数初学者踩坑的浮点精度问题究竟是怎么回事。