最近在后台收到不少私信都是同一个问题Python 到底怎么学才能不掉队有人收藏了一堆视频教程结果打开两集就放弃有人买了几本厚厚的书翻到第三章就开始犯困还有人跟着视频敲代码敲完就忘根本不知道什么时候该用哪个函数。正好这段时间看到一套很火的 Python 动画视频教程用动画形式把语法、逻辑、项目一步步拆开来讲对零基础确实友好。但视频有个天然短板——信息是线性的看完容易忘想回查某个知识点还得拖着进度条来回找。所以这篇文章我把零基础入门 Python 需要掌握的核心内容整理成一套完整的文字教程从环境搭建、基础语法到实战项目、打包 exe再到常见报错排查覆盖从零小白到能独立写小工具的完整路径。无论你是完全没写过代码的纯新手还是学过一遍想系统补漏的同学都可以直接照着操作。1. Python 零基础入门先搞清楚它是什么1.1 Python 到底解决什么问题简单说Python 是一种解释型、面向对象的编程语言。所谓“解释型”就是代码写完后不需要像 C、Java 那样先编译成机器码而是由 Python 解释器逐行读取并执行所以写起来更灵活调试也更快。那它为什么是很多人入门的首选三个原因语法接近自然语言。比如定义一个变量age 18读起来就是“把 18 赋值给 age”不需要声明类型没有大括号缩进就能表示代码块。生态极其丰富。数据分析有 Pandas爬虫有 Requests、ScrapyWeb 开发有 Flask、Django机器学习有 PyTorch、Scikit-learn自动化办公有 openpyxl、python-docx。大部分场景都有人写好轮子你只需要学会调用。跨平台能力好。Windows、Linux、macOS 都能跑写一次基本可以到处运行。1.2 Python 主要用在哪些方向从就业和项目落地的角度看Python 最常见的应用场景有以下几类方向常用库/框架典型任务数据分析与可视化pandas、numpy、matplotlib清洗表格、统计指标、画折线图网络爬虫requests、BeautifulSoup、Scrapy采集网页数据、批量下载资源Web 开发Flask、Django、FastAPI搭建网站后端、提供 API 接口自动化脚本os、subprocess、schedule批量重命名文件、定时执行任务人工智能/机器学习scikit-learn、PyTorch、TensorFlow训练分类模型、图像识别测试与运维pytest、Selenium、Fabric自动化测试、服务器部署零基础阶段不需要急着选方向先把语法、数据结构、函数、文件读写这些基础打牢后面换方向只是换个库的问题。1.3 视频教程和文字教程怎么搭配效率最高现在学习资源很多视频的优势是直观动画能清晰展示程序运行的流程文字的优势是密度高、可检索、可复制。我的建议是先看视频理解概念尤其是循环、函数、面向对象这些抽象内容动画演示确实比干讲容易懂。看完一个章节立刻用本文的代码自己敲一遍不要复制粘贴手敲能帮你记住语法细节。遇到报错回到文字教程查“常见问题”比重新刷视频效率高得多。学完基础后找一个完整的实战项目比如本文第 4 节的通讯录小程序练手把零散知识串起来。2. 环境准备从安装 Python 到跑起第一行代码很多零基础同学卡在第一步——不知道怎么安装、装完不知道在哪里写代码、环境变量配置完还是提示“python 不是内部或外部命令”。下面按 Windows 和 Linux 两种情况分别说明。2.1 Windows 下安装 Python第一步下载安装包打开 Python 官方网站进入 Downloads 页面下载 Windows 版本的安装包。建议选择 64 位版本版本号选择 3.8 以上即可具体小版本可以根据官网提示选择。这里不做具体版本推荐因为不同项目对版本要求不一样原则是“新项目用新版本老项目看依赖兼容”。第二步安装时勾选“Add Python to PATH”这一步非常关键。双击安装包后进入安装界面务必勾选最下方的Add Python to PATH然后点击 Install Now。勾选之后安装程序会自动把 Python 的可执行目录写入系统环境变量这样你在命令行输入python才能直接进入交互环境。如果安装时忘了勾选后面依然可以手动配置方法见 2.3 节。第三步验证安装按Win R打开运行窗口输入cmd回车打开命令行然后输入python --version如果输出类似Python 3.12.1的信息说明安装成功。2.2 Linux 下安装 Python大多数 Linux 发行版都会自带 Python 3但版本可能偏旧。先检查一下当前版本python3 --version如果版本过旧或者系统里没有 Python可以通过包管理器安装sudo apt update sudo apt install python3 python3-pipCentOS / RHEL 系的系统使用sudo yum install python3 python3-pip安装完成后验证一下 pip 是否可用pip3 --versionLinux 下注意一点很多系统默认python指向 Python 2输入命令时要用python3否则可能报错或者进入错误的解释器。2.3 环境变量配置Windows 下如果安装时没勾选 PATH或者升级版本后想要切换默认 Python需要手动配置环境变量。右键“此电脑”-“属性”-“高级系统设置”-“环境变量”在“系统变量”中找到Path点击编辑新增以下两个路径具体路径以你的实际安装目录为准C:\Users\你的用户名\AppData\Local\Programs\Python\Python312\ C:\Users\你的用户名\AppData\Local\Programs\Python\Python312\Scripts\第一个路径是 python.exe 所在目录第二个路径是 pip 等命令所在目录。配置完记得点确定然后重新打开命令行窗口再输入python --version验证。需要特别提醒修改环境变量属于系统级配置只在你自己的开发机上操作不要在服务器上随意改动避免影响线上环境。2.4 开发工具选择VSCode 还是 PyCharmVSCode轻量、插件丰富、启动快适合新手也适合写脚本。装好 Python 扩展后就可以直接运行.py文件。PyCharmJetBrains 出品功能更完整调试、代码补全、虚拟环境管理都是开箱即用适合做项目开发。社区版免费对学习来说已经足够。VSCode 配置 Python 环境的步骤很简单安装 VSCode。在扩展商店搜索Python安装微软官方扩展。打开一个.py文件右下角选择解释器就是你刚才安装的 Python 版本。按F5或者点击右上角运行按钮即可执行代码。2.5 验证第一个程序新建一个文件hello.py写入print(Hello, Python!)终端运行python hello.py输出Hello, Python!到这里环境搭建就算完成了。接下来进入核心语法部分。3. Python 基础语法核心拆解这一节会覆盖变量、数据类型、类型转换、条件判断、循环、函数、常用数据结构。每个知识点都会先给最小示例再解释为什么这么写。3.1 变量与基本数据类型Python 是动态类型语言声明变量不需要写类型直接赋值即可name 小明 # 字符串 str age 18 # 整数 int height 1.75 # 浮点数 float is_student True # 布尔值 bool print(name, age, height, is_student)这里需要注意print的用法多个值用逗号分隔输出时默认用空格隔开。Python 中字符串可以用单引号、双引号也可以使用三引号表示多行字符串message 第一行 第二行 print(message)3.2 类型转换不同数据类型之间经常需要转换尤其是从用户输入、文件读取得到的数据默认都是字符串做数学运算前必须先转成数字。# 字符串转整数 num_str 42 num_int int(num_str) print(num_int 8) # 输出 50 # 字符串转浮点数 pi_str 3.14 pi_float float(pi_str) print(pi_float * 2) # 输出 6.28 # 数字转字符串 score 98 score_str str(score) print(成绩是 score_str) # 拼接字符串时需要转字符串常见的坑是直接对字符串使用拼接数字会报错因为 Python 不允许字符串和数字直接相加。解决方案就是用str()转换。3.3 条件判断条件判断使用if / elif / else注意每个分支以冒号结尾缩进的代码块代表该分支的执行体。score 85 if score 90: print(优秀) elif score 60: print(及格) else: print(不及格)判断条件时要注意是比较运算符是赋值运算符初学者经常在这写错。3.4 循环for 循环for循环通常用来遍历可迭代对象比如列表、字符串、range 对象for i in range(5): print(i)这段代码会输出 0 到 4。range(5)生成的是 0 到 4 的整数序列注意不包含 5这是一个高频易错点。遍历列表fruits [苹果, 香蕉, 橙子] for fruit in fruits: print(fruit)while 循环while循环适合“当某个条件满足时持续执行”的场景count 0 while count 3: print(次数:, count) count count 1写while循环最怕死循环——条件永远为 True 且循环体里没有改变条件的语句程序就会一直跑下去。如果遇到程序卡死可以先在终端按Ctrl C强制停止。3.5 函数函数用于封装一段可复用的逻辑。定义用def关键字函数名后跟小括号和冒号返回结果用returndef add(a, b): 返回两个数的和 result a b return result sum_value add(3, 5) print(sum_value) # 输出 8函数可以设置默认参数def greet(name访客): print(你好 name) greet() # 输出你好访客 greet(小明) # 输出你好小明还可以返回多个值返回的本质上是一个元组def calculate(a, b): return a b, a - b, a * b, a / b sum_v, diff, prod, quot calculate(10, 2) print(sum_v, diff, prod, quot) # 输出 12 8 20 5.03.6 常用数据结构Python 内置四种常用容器列表、元组、字典、集合。列表 list列表是可变的、有序的用方括号定义numbers [1, 2, 3, 4, 5] numbers.append(6) # 末尾追加 numbers.remove(3) # 删除值为 3 的元素 print(numbers[0]) # 按下标访问 print(len(numbers)) # 列表长度 print(numbers[-1]) # 最后一个元素列表切片是 Python 非常实用的特性nums [10, 20, 30, 40, 50] print(nums[1:3]) # 输出 [20, 30]注意不包含下标 3 print(nums[:2]) # 输出 [10, 20] print(nums[::2]) # 每隔一个取一个输出 [10, 30, 50]元组 tuple元组用圆括号定义创建后不可修改适合表示一组固定的值point (3, 4) x, y point print(x, y)字典 dict字典是键值对的集合用花括号定义适合描述实体属性person { name: 小明, age: 18, city: 北京 } print(person[name]) # 访问值 person[age] 19 # 修改值 person[job] 学生 # 新增键值对 print(person.keys()) # 查看所有键 print(person.values()) # 查看所有值注意直接使用person[不存在的键]会抛出KeyError更安全的做法是用get方法print(person.get(height, 未填写))集合 set集合用于去重和集合运算元素不重复、无序colors_a {red, blue, green} colors_b {blue, yellow} print(colors_a colors_b) # 交集输出 {blue} print(colors_a | colors_b) # 并集4. 完整实战案例开发一个命令行通讯录基础知识学完了很多同学会卡在“不知道怎么写一个完整的东西”。这一节我们做一个命令行通讯录小程序实现联系人新增、查看、搜索、删除、保存到文件、退出六大功能。这个项目能把变量、列表、字典、函数、循环、文件读写全部串起来。4.1 需求分析用户通过菜单选择操作。联系人信息包含姓名和电话存储在一个字典列表中。支持新增联系人、查看所有联系人、按姓名搜索、删除联系人。程序退出时把数据保存到contacts.txt下次启动自动加载。4.2 功能拆分函数功能load_contacts()从文件读取已有联系人save_contacts(contacts)将联系人列表写回文件add_contact(contacts)新增联系人show_contacts(contacts)展示所有联系人search_contact(contacts)按姓名搜索delete_contact(contacts)按姓名删除main()菜单入口控制整个循环4.3 编写完整代码文件路径contacts.py# -*- coding: utf-8 -*- 命令行通讯录小程序 支持新增、查看、搜索、删除联系人数据持久化到文件 import os FILE_NAME contacts.txt def load_contacts(): 从文件加载联系人文件不存在时返回空列表 contacts [] if not os.path.exists(FILE_NAME): return contacts with open(FILE_NAME, r, encodingutf-8) as f: for line in f: line line.strip() if not line: continue parts line.split(,) if len(parts) 2: contacts.append({name: parts[0], phone: parts[1]}) return contacts def save_contacts(contacts): 将联系人列表写入文件 with open(FILE_NAME, w, encodingutf-8) as f: for item in contacts: f.write(f{item[name]},{item[phone]}\n) print(数据已保存到, FILE_NAME) def add_contact(contacts): 新增联系人 name input(请输入姓名).strip() if not name: print(姓名不能为空) return phone input(请输入电话).strip() contacts.append({name: name, phone: phone}) print(f联系人 {name} 添加成功) def show_contacts(contacts): 显示所有联系人 if not contacts: print(当前没有联系人) return print(\n 联系人列表 ) for idx, item in enumerate(contacts, start1): print(f{idx}. {item[name]} {item[phone]}) print() def search_contact(contacts): 按姓名搜索联系人 keyword input(请输入要搜索的姓名).strip() found False for item in contacts: if keyword in item[name]: print(f找到{item[name]} {item[phone]}) found True if not found: print(未找到匹配的联系人) def delete_contact(contacts): 按姓名删除联系人 name input(请输入要删除的姓名).strip() for idx, item in enumerate(contacts): if item[name] name: contacts.pop(idx) print(f联系人 {name} 已删除) return print(未找到该联系人) def main(): contacts load_contacts() while True: print(\n请选择操作) print(1. 新增联系人) print(2. 查看所有联系人) print(3. 搜索联系人) print(4. 删除联系人) print(5. 保存并退出) choice input(请输入序号).strip() if choice 1: add_contact(contacts) elif choice 2: show_contacts(contacts) elif choice 3: search_contact(contacts) elif choice 4: delete_contact(contacts) elif choice 5: save_contacts(contacts) print(再见) break else: print(无效输入请重新选择) if __name__ __main__: main()4.4 代码要点说明FILE_NAME是全局常量Python 约定常量用大写命名。load_contacts读取每行文本按逗号拆分成姓名和电话组装成字典。input()获取的都是字符串strip()用于去掉首尾空格避免用户输入多余空格导致匹配失败。enumerate(contacts, start1)在遍历列表时同时拿到序号。文件读写使用with open(...) as f语法这样即使发生异常文件也会自动关闭不需要手动调用close()。if __name__ __main__:的作用是当这个文件被直接运行时执行main()被其他文件导入时不执行这是 Python 工程中的标准写法。4.5 运行与验证在终端执行python contacts.py运行效果示例请选择操作 1. 新增联系人 2. 查看所有联系人 3. 搜索联系人 4. 删除联系人 5. 保存并退出 请输入序号1 请输入姓名小红 请输入电话13800138000 联系人 小红 添加成功输入 2 查看列表输入 5 保存退出后打开contacts.txt可以看到小红,13800138000这样一个完整的小项目就落地了。你可以在此基础上扩展分组、修改联系人、按电话搜索等功能训练自己读代码、改代码、加功能的能力。5. 常用第三方库数据分析与文件处理Python 基础语法掌握后下一步通常是接触第三方库。这一节以最常用的数据分析库 numpy、pandas 为例演示安装和基本用法。5.1 安装 pip 包第三方库通过pip安装。Windows 在命令行执行pip install numpy pandas如果你的机器上有多个 Python 版本可能需要用pip3或python -m pippython -m pip install numpy pandas安装完成后验证import numpy as np import pandas as pd print(np.__version__) print(pd.__version__)能正常输出版本号说明安装成功。需要注意某些库对 Python 版本有要求如果安装时报错提示找不到匹配版本先检查python --version再决定是升级 Python 还是降低库版本。5.2 numpy 自动应用分析成绩数据numpy 的核心是ndarray数组支持向量化运算不用写循环就能对整组数据做计算。import numpy as np # 创建一维数组 scores np.array([78, 92, 85, 60, 99, 74]) print(平均分:, scores.mean()) print(最高分:, scores.max()) print(最低分:, scores.min()) print(标准差:, scores.std())5.3 pandas 自动应用读取 CSV 表格实际项目里数据通常来自 Excel 或 CSV 文件。pandas 读取这类数据非常方便。假设有一个students.csv文件姓名,语文,数学,英语 小明,88,95,90 小红,76,82,88 小刚,95,88,92读取并计算总分import pandas as pd df pd.read_csv(students.csv, encodingutf-8) df[总分] df[语文] df[数学] df[英语] print(df)输出姓名 语文 数学 英语 总分 0 小明 88 95 90 273 1 小红 76 82 88 246 2 小刚 95 88 92 275按总分排序并筛选出大于 250 的print(df[df[总分] 250].sort_values(总分, ascendingFalse))这个能力在办公自动化里非常实用报表汇总、数据清洗、批量计算几行代码就能完成 Excel 手工操作十几分钟的工作。6. 把 Python 程序打包成 exe 文件很多初学者学完一个脚本后想要在没装 Python 的电脑上运行或者分享给朋友使用这时候就需要把.py文件打包成 Windows 下的.exe可执行文件。最常用的工具是 PyInstaller。6.1 安装 PyInstallerpip install pyinstaller6.2 打包单个文件在项目目录下执行pyinstaller -F contacts.py参数说明-F表示生成单个 exe 文件便于分发。不写-F的话会生成一个包含多个文件的目录启动速度稍快但分发时要把整个目录一起拷走。打包完成后exe 文件位于dist目录下双击即可运行。如果你的程序使用了文件读写注意生成的 exe 的工作目录可能和源码目录不同尽量让代码使用相对路径并处理文件不存在的情况就像第 4 节load_contacts做的那样。6.3 打包注意事项打包后的 exe 体积通常会比较大这是正常的因为解释器和依赖库都被打包进去了。如果程序用到了第三方库PyInstaller 会自动识别大部分但个别动态导入的模块需要手动在参数里用--hidden-import指定。杀毒软件可能误报建议先在本机测试再发给信任的朋友。打包命令请在自己开发机上执行不要在生产服务器上随意安装打包工具。7. 常见问题与排查思路零基础阶段90% 的报错都集中在下面几个问题上。遇到报错先不要慌按表格排查。问题现象常见原因解决思路python 不是内部或外部命令Python 未安装或没有加入系统环境变量 PATH确认安装时勾选 Add Python to PATH检查环境变量配置ModuleNotFoundError: No module named xxxpip 包未安装或当前环境不对执行pip install xxx检查是否在正确的虚拟环境里IndexError: list index out of range访问了列表中不存在的下标打印len(列表)确认下标范围注意最后一个元素是-1而不是lenKeyError: xxx字典中不存在该键使用dict.get(xxx, 默认值)安全访问TypeError: can only concatenate str字符串和数字直接拼接用str()把数字转成字符串或用 f-string 格式化SyntaxError: invalid syntax标点符号写成中文、漏写冒号、缩进不一致检查代码中的引号冒号是否为英文符号统一用 4 空格缩进程序运行后卡住不动死循环终端按Ctrl C强制终止检查 while 条件是否可能永远为 True中文输出乱码文件编码不是 UTF-8文件开头加# -*- coding: utf-8 -*-打开文件时指定encodingutf-8再来一个排查清单遇到报错按顺序执行读第一行报错信息重点是最后一行的错误类型和描述。查看报错位置的文件名和行号先看这一行。检查标点符号是否用了中文全角字符。检查缩进是否一致Python 对缩进极其敏感。检查变量名是否拼写一致大小写是否有差异。如果是第三方的库报错优先检查版本兼容性。8. 最佳实践与工程建议基础语法学完、能写出小项目之后建议尽早养成下面这些习惯它们能让你从“能跑”走向“写得专业”。8.1 命名规范变量名、函数名使用小写字母多个单词用下划线连接例如user_name、get_total_score。类名使用驼峰命名法例如StudentInfo。常量全部大写例如MAX_SIZE。变量名要能表达含义不要用a、b、tmp满天飞。8.2 善用虚拟环境不同项目可能依赖不同版本的库全部装进全局环境很容易冲突。推荐每个项目创建一个独立虚拟环境python -m venv venvWindows 激活venv\Scripts\activateLinux / macOS 激活source venv/bin/activate激活后命令行前会出现(venv)标识这时pip install的包只会安装在这个虚拟环境中不会污染全局环境。8.3 异常处理程序是给人用的输入不可控网络可能超时文件可能不存在。关键位置要加异常处理try: num int(input(请输入数字)) print(100 / num) except ValueError: print(输入的不是有效数字) except ZeroDivisionError: print(不能除以 0) except Exception as e: print(发生未知错误:, e)注意不要一上来就try...except Exception把什么都吞掉至少在异常处理里打印日志否则出问题时完全无法定位。8.4 保持代码简洁能用列表推导式时尽量少写三行循环加 append 的代码。# 不推荐 squares [] for i in range(10): squares.append(i * i) # 推荐 squares [i * i for i in range(10)]字符串拼接优先用 f-stringname 小明 age 18 print(f姓名{name}年龄{age})8.5 学习路线建议按下面的顺序推进每一步都有明确产出Python 基础语法变量、数据类型、条件、循环、函数、常用数据结构。产出能独立编写 50 行以内的小脚本。文件读写与异常处理掌握with open、try...except。产出能处理 CSV、TXT 数据文件。第三方库入门以 numpy、pandas 或 requests 为切入点。产出能完成一个数据统计或网页请求的小工具。完整项目实战做一个通讯录、记账本、爬虫或自动化脚本。产出自己的第一个完整作品并尝试打包成 exe。根据职业方向深入数据分析方向学 matplotlib、SQLWeb 方向学 Flask/Django自动化方向学 Selenium、openpyxl。回顾一下这篇文章带你把 Python 入门最核心的环节走了一遍理解了 Python 是什么、安装并配置了开发环境、系统掌握了变量、类型转换、条件、循环、函数和常用数据结构并通过一个通讯录项目把零散知识串成了完整程序最后还解决了第三方库安装和打包 exe 的问题。编程是典型的“手上功夫”看一百遍教程不如亲手敲一遍代码。建议你今天就把第 4 节的通讯录代码逐行敲出来改一两个功能再跑一遍这个过程会比你想象中更有收获。如果这篇文章对你有帮助可以收藏备用后续遇到问题随时回来查。
最近在后台收到不少私信都是同一个问题Python 到底怎么学才能不掉队有人收藏了一堆视频教程结果打开两集就放弃有人买了几本厚厚的书翻到第三章就开始犯困还有人跟着视频敲代码敲完就忘根本不知道什么时候该用哪个函数。正好这段时间看到一套很火的 Python 动画视频教程用动画形式把语法、逻辑、项目一步步拆开来讲对零基础确实友好。但视频有个天然短板——信息是线性的看完容易忘想回查某个知识点还得拖着进度条来回找。所以这篇文章我把零基础入门 Python 需要掌握的核心内容整理成一套完整的文字教程从环境搭建、基础语法到实战项目、打包 exe再到常见报错排查覆盖从零小白到能独立写小工具的完整路径。无论你是完全没写过代码的纯新手还是学过一遍想系统补漏的同学都可以直接照着操作。1. Python 零基础入门先搞清楚它是什么1.1 Python 到底解决什么问题简单说Python 是一种解释型、面向对象的编程语言。所谓“解释型”就是代码写完后不需要像 C、Java 那样先编译成机器码而是由 Python 解释器逐行读取并执行所以写起来更灵活调试也更快。那它为什么是很多人入门的首选三个原因语法接近自然语言。比如定义一个变量age 18读起来就是“把 18 赋值给 age”不需要声明类型没有大括号缩进就能表示代码块。生态极其丰富。数据分析有 Pandas爬虫有 Requests、ScrapyWeb 开发有 Flask、Django机器学习有 PyTorch、Scikit-learn自动化办公有 openpyxl、python-docx。大部分场景都有人写好轮子你只需要学会调用。跨平台能力好。Windows、Linux、macOS 都能跑写一次基本可以到处运行。1.2 Python 主要用在哪些方向从就业和项目落地的角度看Python 最常见的应用场景有以下几类方向常用库/框架典型任务数据分析与可视化pandas、numpy、matplotlib清洗表格、统计指标、画折线图网络爬虫requests、BeautifulSoup、Scrapy采集网页数据、批量下载资源Web 开发Flask、Django、FastAPI搭建网站后端、提供 API 接口自动化脚本os、subprocess、schedule批量重命名文件、定时执行任务人工智能/机器学习scikit-learn、PyTorch、TensorFlow训练分类模型、图像识别测试与运维pytest、Selenium、Fabric自动化测试、服务器部署零基础阶段不需要急着选方向先把语法、数据结构、函数、文件读写这些基础打牢后面换方向只是换个库的问题。1.3 视频教程和文字教程怎么搭配效率最高现在学习资源很多视频的优势是直观动画能清晰展示程序运行的流程文字的优势是密度高、可检索、可复制。我的建议是先看视频理解概念尤其是循环、函数、面向对象这些抽象内容动画演示确实比干讲容易懂。看完一个章节立刻用本文的代码自己敲一遍不要复制粘贴手敲能帮你记住语法细节。遇到报错回到文字教程查“常见问题”比重新刷视频效率高得多。学完基础后找一个完整的实战项目比如本文第 4 节的通讯录小程序练手把零散知识串起来。2. 环境准备从安装 Python 到跑起第一行代码很多零基础同学卡在第一步——不知道怎么安装、装完不知道在哪里写代码、环境变量配置完还是提示“python 不是内部或外部命令”。下面按 Windows 和 Linux 两种情况分别说明。2.1 Windows 下安装 Python第一步下载安装包打开 Python 官方网站进入 Downloads 页面下载 Windows 版本的安装包。建议选择 64 位版本版本号选择 3.8 以上即可具体小版本可以根据官网提示选择。这里不做具体版本推荐因为不同项目对版本要求不一样原则是“新项目用新版本老项目看依赖兼容”。第二步安装时勾选“Add Python to PATH”这一步非常关键。双击安装包后进入安装界面务必勾选最下方的Add Python to PATH然后点击 Install Now。勾选之后安装程序会自动把 Python 的可执行目录写入系统环境变量这样你在命令行输入python才能直接进入交互环境。如果安装时忘了勾选后面依然可以手动配置方法见 2.3 节。第三步验证安装按Win R打开运行窗口输入cmd回车打开命令行然后输入python --version如果输出类似Python 3.12.1的信息说明安装成功。2.2 Linux 下安装 Python大多数 Linux 发行版都会自带 Python 3但版本可能偏旧。先检查一下当前版本python3 --version如果版本过旧或者系统里没有 Python可以通过包管理器安装sudo apt update sudo apt install python3 python3-pipCentOS / RHEL 系的系统使用sudo yum install python3 python3-pip安装完成后验证一下 pip 是否可用pip3 --versionLinux 下注意一点很多系统默认python指向 Python 2输入命令时要用python3否则可能报错或者进入错误的解释器。2.3 环境变量配置Windows 下如果安装时没勾选 PATH或者升级版本后想要切换默认 Python需要手动配置环境变量。右键“此电脑”-“属性”-“高级系统设置”-“环境变量”在“系统变量”中找到Path点击编辑新增以下两个路径具体路径以你的实际安装目录为准C:\Users\你的用户名\AppData\Local\Programs\Python\Python312\ C:\Users\你的用户名\AppData\Local\Programs\Python\Python312\Scripts\第一个路径是 python.exe 所在目录第二个路径是 pip 等命令所在目录。配置完记得点确定然后重新打开命令行窗口再输入python --version验证。需要特别提醒修改环境变量属于系统级配置只在你自己的开发机上操作不要在服务器上随意改动避免影响线上环境。2.4 开发工具选择VSCode 还是 PyCharmVSCode轻量、插件丰富、启动快适合新手也适合写脚本。装好 Python 扩展后就可以直接运行.py文件。PyCharmJetBrains 出品功能更完整调试、代码补全、虚拟环境管理都是开箱即用适合做项目开发。社区版免费对学习来说已经足够。VSCode 配置 Python 环境的步骤很简单安装 VSCode。在扩展商店搜索Python安装微软官方扩展。打开一个.py文件右下角选择解释器就是你刚才安装的 Python 版本。按F5或者点击右上角运行按钮即可执行代码。2.5 验证第一个程序新建一个文件hello.py写入print(Hello, Python!)终端运行python hello.py输出Hello, Python!到这里环境搭建就算完成了。接下来进入核心语法部分。3. Python 基础语法核心拆解这一节会覆盖变量、数据类型、类型转换、条件判断、循环、函数、常用数据结构。每个知识点都会先给最小示例再解释为什么这么写。3.1 变量与基本数据类型Python 是动态类型语言声明变量不需要写类型直接赋值即可name 小明 # 字符串 str age 18 # 整数 int height 1.75 # 浮点数 float is_student True # 布尔值 bool print(name, age, height, is_student)这里需要注意print的用法多个值用逗号分隔输出时默认用空格隔开。Python 中字符串可以用单引号、双引号也可以使用三引号表示多行字符串message 第一行 第二行 print(message)3.2 类型转换不同数据类型之间经常需要转换尤其是从用户输入、文件读取得到的数据默认都是字符串做数学运算前必须先转成数字。# 字符串转整数 num_str 42 num_int int(num_str) print(num_int 8) # 输出 50 # 字符串转浮点数 pi_str 3.14 pi_float float(pi_str) print(pi_float * 2) # 输出 6.28 # 数字转字符串 score 98 score_str str(score) print(成绩是 score_str) # 拼接字符串时需要转字符串常见的坑是直接对字符串使用拼接数字会报错因为 Python 不允许字符串和数字直接相加。解决方案就是用str()转换。3.3 条件判断条件判断使用if / elif / else注意每个分支以冒号结尾缩进的代码块代表该分支的执行体。score 85 if score 90: print(优秀) elif score 60: print(及格) else: print(不及格)判断条件时要注意是比较运算符是赋值运算符初学者经常在这写错。3.4 循环for 循环for循环通常用来遍历可迭代对象比如列表、字符串、range 对象for i in range(5): print(i)这段代码会输出 0 到 4。range(5)生成的是 0 到 4 的整数序列注意不包含 5这是一个高频易错点。遍历列表fruits [苹果, 香蕉, 橙子] for fruit in fruits: print(fruit)while 循环while循环适合“当某个条件满足时持续执行”的场景count 0 while count 3: print(次数:, count) count count 1写while循环最怕死循环——条件永远为 True 且循环体里没有改变条件的语句程序就会一直跑下去。如果遇到程序卡死可以先在终端按Ctrl C强制停止。3.5 函数函数用于封装一段可复用的逻辑。定义用def关键字函数名后跟小括号和冒号返回结果用returndef add(a, b): 返回两个数的和 result a b return result sum_value add(3, 5) print(sum_value) # 输出 8函数可以设置默认参数def greet(name访客): print(你好 name) greet() # 输出你好访客 greet(小明) # 输出你好小明还可以返回多个值返回的本质上是一个元组def calculate(a, b): return a b, a - b, a * b, a / b sum_v, diff, prod, quot calculate(10, 2) print(sum_v, diff, prod, quot) # 输出 12 8 20 5.03.6 常用数据结构Python 内置四种常用容器列表、元组、字典、集合。列表 list列表是可变的、有序的用方括号定义numbers [1, 2, 3, 4, 5] numbers.append(6) # 末尾追加 numbers.remove(3) # 删除值为 3 的元素 print(numbers[0]) # 按下标访问 print(len(numbers)) # 列表长度 print(numbers[-1]) # 最后一个元素列表切片是 Python 非常实用的特性nums [10, 20, 30, 40, 50] print(nums[1:3]) # 输出 [20, 30]注意不包含下标 3 print(nums[:2]) # 输出 [10, 20] print(nums[::2]) # 每隔一个取一个输出 [10, 30, 50]元组 tuple元组用圆括号定义创建后不可修改适合表示一组固定的值point (3, 4) x, y point print(x, y)字典 dict字典是键值对的集合用花括号定义适合描述实体属性person { name: 小明, age: 18, city: 北京 } print(person[name]) # 访问值 person[age] 19 # 修改值 person[job] 学生 # 新增键值对 print(person.keys()) # 查看所有键 print(person.values()) # 查看所有值注意直接使用person[不存在的键]会抛出KeyError更安全的做法是用get方法print(person.get(height, 未填写))集合 set集合用于去重和集合运算元素不重复、无序colors_a {red, blue, green} colors_b {blue, yellow} print(colors_a colors_b) # 交集输出 {blue} print(colors_a | colors_b) # 并集4. 完整实战案例开发一个命令行通讯录基础知识学完了很多同学会卡在“不知道怎么写一个完整的东西”。这一节我们做一个命令行通讯录小程序实现联系人新增、查看、搜索、删除、保存到文件、退出六大功能。这个项目能把变量、列表、字典、函数、循环、文件读写全部串起来。4.1 需求分析用户通过菜单选择操作。联系人信息包含姓名和电话存储在一个字典列表中。支持新增联系人、查看所有联系人、按姓名搜索、删除联系人。程序退出时把数据保存到contacts.txt下次启动自动加载。4.2 功能拆分函数功能load_contacts()从文件读取已有联系人save_contacts(contacts)将联系人列表写回文件add_contact(contacts)新增联系人show_contacts(contacts)展示所有联系人search_contact(contacts)按姓名搜索delete_contact(contacts)按姓名删除main()菜单入口控制整个循环4.3 编写完整代码文件路径contacts.py# -*- coding: utf-8 -*- 命令行通讯录小程序 支持新增、查看、搜索、删除联系人数据持久化到文件 import os FILE_NAME contacts.txt def load_contacts(): 从文件加载联系人文件不存在时返回空列表 contacts [] if not os.path.exists(FILE_NAME): return contacts with open(FILE_NAME, r, encodingutf-8) as f: for line in f: line line.strip() if not line: continue parts line.split(,) if len(parts) 2: contacts.append({name: parts[0], phone: parts[1]}) return contacts def save_contacts(contacts): 将联系人列表写入文件 with open(FILE_NAME, w, encodingutf-8) as f: for item in contacts: f.write(f{item[name]},{item[phone]}\n) print(数据已保存到, FILE_NAME) def add_contact(contacts): 新增联系人 name input(请输入姓名).strip() if not name: print(姓名不能为空) return phone input(请输入电话).strip() contacts.append({name: name, phone: phone}) print(f联系人 {name} 添加成功) def show_contacts(contacts): 显示所有联系人 if not contacts: print(当前没有联系人) return print(\n 联系人列表 ) for idx, item in enumerate(contacts, start1): print(f{idx}. {item[name]} {item[phone]}) print() def search_contact(contacts): 按姓名搜索联系人 keyword input(请输入要搜索的姓名).strip() found False for item in contacts: if keyword in item[name]: print(f找到{item[name]} {item[phone]}) found True if not found: print(未找到匹配的联系人) def delete_contact(contacts): 按姓名删除联系人 name input(请输入要删除的姓名).strip() for idx, item in enumerate(contacts): if item[name] name: contacts.pop(idx) print(f联系人 {name} 已删除) return print(未找到该联系人) def main(): contacts load_contacts() while True: print(\n请选择操作) print(1. 新增联系人) print(2. 查看所有联系人) print(3. 搜索联系人) print(4. 删除联系人) print(5. 保存并退出) choice input(请输入序号).strip() if choice 1: add_contact(contacts) elif choice 2: show_contacts(contacts) elif choice 3: search_contact(contacts) elif choice 4: delete_contact(contacts) elif choice 5: save_contacts(contacts) print(再见) break else: print(无效输入请重新选择) if __name__ __main__: main()4.4 代码要点说明FILE_NAME是全局常量Python 约定常量用大写命名。load_contacts读取每行文本按逗号拆分成姓名和电话组装成字典。input()获取的都是字符串strip()用于去掉首尾空格避免用户输入多余空格导致匹配失败。enumerate(contacts, start1)在遍历列表时同时拿到序号。文件读写使用with open(...) as f语法这样即使发生异常文件也会自动关闭不需要手动调用close()。if __name__ __main__:的作用是当这个文件被直接运行时执行main()被其他文件导入时不执行这是 Python 工程中的标准写法。4.5 运行与验证在终端执行python contacts.py运行效果示例请选择操作 1. 新增联系人 2. 查看所有联系人 3. 搜索联系人 4. 删除联系人 5. 保存并退出 请输入序号1 请输入姓名小红 请输入电话13800138000 联系人 小红 添加成功输入 2 查看列表输入 5 保存退出后打开contacts.txt可以看到小红,13800138000这样一个完整的小项目就落地了。你可以在此基础上扩展分组、修改联系人、按电话搜索等功能训练自己读代码、改代码、加功能的能力。5. 常用第三方库数据分析与文件处理Python 基础语法掌握后下一步通常是接触第三方库。这一节以最常用的数据分析库 numpy、pandas 为例演示安装和基本用法。5.1 安装 pip 包第三方库通过pip安装。Windows 在命令行执行pip install numpy pandas如果你的机器上有多个 Python 版本可能需要用pip3或python -m pippython -m pip install numpy pandas安装完成后验证import numpy as np import pandas as pd print(np.__version__) print(pd.__version__)能正常输出版本号说明安装成功。需要注意某些库对 Python 版本有要求如果安装时报错提示找不到匹配版本先检查python --version再决定是升级 Python 还是降低库版本。5.2 numpy 自动应用分析成绩数据numpy 的核心是ndarray数组支持向量化运算不用写循环就能对整组数据做计算。import numpy as np # 创建一维数组 scores np.array([78, 92, 85, 60, 99, 74]) print(平均分:, scores.mean()) print(最高分:, scores.max()) print(最低分:, scores.min()) print(标准差:, scores.std())5.3 pandas 自动应用读取 CSV 表格实际项目里数据通常来自 Excel 或 CSV 文件。pandas 读取这类数据非常方便。假设有一个students.csv文件姓名,语文,数学,英语 小明,88,95,90 小红,76,82,88 小刚,95,88,92读取并计算总分import pandas as pd df pd.read_csv(students.csv, encodingutf-8) df[总分] df[语文] df[数学] df[英语] print(df)输出姓名 语文 数学 英语 总分 0 小明 88 95 90 273 1 小红 76 82 88 246 2 小刚 95 88 92 275按总分排序并筛选出大于 250 的print(df[df[总分] 250].sort_values(总分, ascendingFalse))这个能力在办公自动化里非常实用报表汇总、数据清洗、批量计算几行代码就能完成 Excel 手工操作十几分钟的工作。6. 把 Python 程序打包成 exe 文件很多初学者学完一个脚本后想要在没装 Python 的电脑上运行或者分享给朋友使用这时候就需要把.py文件打包成 Windows 下的.exe可执行文件。最常用的工具是 PyInstaller。6.1 安装 PyInstallerpip install pyinstaller6.2 打包单个文件在项目目录下执行pyinstaller -F contacts.py参数说明-F表示生成单个 exe 文件便于分发。不写-F的话会生成一个包含多个文件的目录启动速度稍快但分发时要把整个目录一起拷走。打包完成后exe 文件位于dist目录下双击即可运行。如果你的程序使用了文件读写注意生成的 exe 的工作目录可能和源码目录不同尽量让代码使用相对路径并处理文件不存在的情况就像第 4 节load_contacts做的那样。6.3 打包注意事项打包后的 exe 体积通常会比较大这是正常的因为解释器和依赖库都被打包进去了。如果程序用到了第三方库PyInstaller 会自动识别大部分但个别动态导入的模块需要手动在参数里用--hidden-import指定。杀毒软件可能误报建议先在本机测试再发给信任的朋友。打包命令请在自己开发机上执行不要在生产服务器上随意安装打包工具。7. 常见问题与排查思路零基础阶段90% 的报错都集中在下面几个问题上。遇到报错先不要慌按表格排查。问题现象常见原因解决思路python 不是内部或外部命令Python 未安装或没有加入系统环境变量 PATH确认安装时勾选 Add Python to PATH检查环境变量配置ModuleNotFoundError: No module named xxxpip 包未安装或当前环境不对执行pip install xxx检查是否在正确的虚拟环境里IndexError: list index out of range访问了列表中不存在的下标打印len(列表)确认下标范围注意最后一个元素是-1而不是lenKeyError: xxx字典中不存在该键使用dict.get(xxx, 默认值)安全访问TypeError: can only concatenate str字符串和数字直接拼接用str()把数字转成字符串或用 f-string 格式化SyntaxError: invalid syntax标点符号写成中文、漏写冒号、缩进不一致检查代码中的引号冒号是否为英文符号统一用 4 空格缩进程序运行后卡住不动死循环终端按Ctrl C强制终止检查 while 条件是否可能永远为 True中文输出乱码文件编码不是 UTF-8文件开头加# -*- coding: utf-8 -*-打开文件时指定encodingutf-8再来一个排查清单遇到报错按顺序执行读第一行报错信息重点是最后一行的错误类型和描述。查看报错位置的文件名和行号先看这一行。检查标点符号是否用了中文全角字符。检查缩进是否一致Python 对缩进极其敏感。检查变量名是否拼写一致大小写是否有差异。如果是第三方的库报错优先检查版本兼容性。8. 最佳实践与工程建议基础语法学完、能写出小项目之后建议尽早养成下面这些习惯它们能让你从“能跑”走向“写得专业”。8.1 命名规范变量名、函数名使用小写字母多个单词用下划线连接例如user_name、get_total_score。类名使用驼峰命名法例如StudentInfo。常量全部大写例如MAX_SIZE。变量名要能表达含义不要用a、b、tmp满天飞。8.2 善用虚拟环境不同项目可能依赖不同版本的库全部装进全局环境很容易冲突。推荐每个项目创建一个独立虚拟环境python -m venv venvWindows 激活venv\Scripts\activateLinux / macOS 激活source venv/bin/activate激活后命令行前会出现(venv)标识这时pip install的包只会安装在这个虚拟环境中不会污染全局环境。8.3 异常处理程序是给人用的输入不可控网络可能超时文件可能不存在。关键位置要加异常处理try: num int(input(请输入数字)) print(100 / num) except ValueError: print(输入的不是有效数字) except ZeroDivisionError: print(不能除以 0) except Exception as e: print(发生未知错误:, e)注意不要一上来就try...except Exception把什么都吞掉至少在异常处理里打印日志否则出问题时完全无法定位。8.4 保持代码简洁能用列表推导式时尽量少写三行循环加 append 的代码。# 不推荐 squares [] for i in range(10): squares.append(i * i) # 推荐 squares [i * i for i in range(10)]字符串拼接优先用 f-stringname 小明 age 18 print(f姓名{name}年龄{age})8.5 学习路线建议按下面的顺序推进每一步都有明确产出Python 基础语法变量、数据类型、条件、循环、函数、常用数据结构。产出能独立编写 50 行以内的小脚本。文件读写与异常处理掌握with open、try...except。产出能处理 CSV、TXT 数据文件。第三方库入门以 numpy、pandas 或 requests 为切入点。产出能完成一个数据统计或网页请求的小工具。完整项目实战做一个通讯录、记账本、爬虫或自动化脚本。产出自己的第一个完整作品并尝试打包成 exe。根据职业方向深入数据分析方向学 matplotlib、SQLWeb 方向学 Flask/Django自动化方向学 Selenium、openpyxl。回顾一下这篇文章带你把 Python 入门最核心的环节走了一遍理解了 Python 是什么、安装并配置了开发环境、系统掌握了变量、类型转换、条件、循环、函数和常用数据结构并通过一个通讯录项目把零散知识串成了完整程序最后还解决了第三方库安装和打包 exe 的问题。编程是典型的“手上功夫”看一百遍教程不如亲手敲一遍代码。建议你今天就把第 4 节的通讯录代码逐行敲出来改一两个功能再跑一遍这个过程会比你想象中更有收获。如果这篇文章对你有帮助可以收藏备用后续遇到问题随时回来查。
![[光学原理与应用-521]：对光的错误理解与纠偏](http://pic.xiahunao.cn/yaotu/[光学原理与应用-521]：对光的错误理解与纠偏)
