欢迎来到简单Python代码
本页面专为编程新手打造,以「简单」为核心理念,拒绝冗长理论堆砌,聚焦可运行、可理解、可复用的Python代码示例。我们深知:第一行代码的体验,决定是否继续前行。因此,所有代码均经过严格测试,确保在Python 3.8+环境下可直接运行。
页面内容覆盖从变量定义、循环控制,到文件处理、网络请求、数据可视化等高频场景,每个示例均附带清晰输出结果、运行环境说明与常见报错提示,帮助您建立完整的认知闭环。更设有「常见陷阱」与「最佳实践」模块,助您避开新手易犯错误。
网站名称「简单Python代码」寓意明确:编程不是天才专利,而是逻辑思维的日常表达。当您看到print("Hello, World!")不再困惑,当您能独立写出一个自动整理下载文件夹的脚本,当您用几行代码生成月度报表——您已踏上属于自己的技术成长之路。
为什么选择从「简单」开始?
多数初学者陷入「理论-实践」断层:教程讲得头头是道,自己动手却无从下手。本项目采用「三步闭环」设计:
- 问题驱动:每个案例源于真实工作痛点(如“如何批量重命名100个PDF文件?”)
- 最小可行代码:仅包含必要语句,避免干扰性复杂逻辑
- 可验证结果:提供预期输出截图/文本,即时确认学习成效
例如:处理CSV数据时,我们不直接引入pandas全量教程,而是先用csv标准库实现核心功能,再引导您进阶到更高效方案。这种渐进式设计,让知识积累如搭积木般稳固。
页面结构说明
全站采用语义化HTML5标签构建,所有区块通过锚点导航直达,无需页面跳转。每个模块包含:
- ⚡ 典型场景:真实业务中高频出现的问题
- ⚙️ 核心代码:可直接复制使用的最小功能单元
- 〔注〕关键解析:逐行解释技术原理与设计思路
- 〈延伸〉拓展方向:当您掌握后可继续探索的进阶主题
所有代码均标注运行环境(如Python版本、依赖包),确保环境一致性。我们坚持:代码不是文档附录,而是可执行的解决方案。
基础语法精要
变量与数据类型:告别抽象定义
初学者常混淆「变量」与「值」的概念。我们用生活化类比理解:变量如同贴了标签的抽屉,值是抽屉里存放的物品。标签可更换,物品可替换,但抽屉本身是容器。
以下代码演示常见数据类型操作:
| 数据类型 | 示例代码 | 输出结果 | 典型用途 |
|---|---|---|---|
| 字符串 | |
欢迎学习Python! | 文本处理、用户交互 |
| 列表 | |
['绿', '蓝'] | 有序集合、批量操作 |
| 字典 | |
工程师 | 键值对存储、配置管理 |
特别注意:字符串是不可变对象,name.upper()不会修改原变量,而是返回新字符串。初学者常误写为name = name.upper()后继续使用原变量,导致逻辑错误。建议养成习惯:对不可变对象的操作,始终用新变量接收结果。
循环控制:高效处理重复任务
当需要处理列表中每个元素时,for循环是首选。但新手常犯两个错误:① 循环变量命名模糊(如i);② 在循环中修改列表长度导致跳过元素。
正确做法示例:
items = ["apple", "banana", "cherry"]
for index, item in enumerate(items):
print(f"第{index+1}项是:{item.upper()}")
输出结果:
第1项是:APPLE
第2项是:BANANA
第3项是:CHERRY
使用enumerate()同时获取索引和值,代码更清晰。若需修改列表内容,应创建新列表而非原地操作:
items = ["apple", "banana", "cherry"]
clean_items = [item.title() for item in items]
print(clean_items)
输出:['Apple', 'Banana', 'Cherry']
此为列表推导式,是Python的优雅特性。相比传统for循环,它更简洁且执行效率更高。建议在简单转换场景优先使用。
函数封装:复用逻辑的基石
函数是代码复用的核心机制。新手常犯的错误是:将功能写死在函数内,缺乏参数设计。以下对比展示设计思路:
❌ 错误示范:def add():
a = 5; b = 3
print(a + b)
✅ 正确示范:def add(a, b):
return a + b
正确函数具有通用性,可处理任意数字组合。更进一步,可添加类型提示增强可读性:
def add(a: float, b: float) -> float:
"""返回两个数的和"""
return a + b
result = add(10.5, 20.3)
print(f"结果:{result:.2f}")
输出:结果:30.80
注意:类型提示: float不强制类型检查,但能被IDE识别用于自动补全与错误提示。在团队协作中,这是重要的文档化手段。
数据处理实战
CSV文件读写:告别手动整理
Excel文件常因格式混乱导致程序读取失败。CSV作为纯文本格式,是数据交换的首选。以下代码展示如何安全读写CSV:
import csv
# 写入数据
with open("scores.csv", "w", newline="", encoding="utf-8") as f:
writer = csv.writer(f)
writer.writerow(["姓名", "科目", "分数"])
writer.writerow(["张三", "数学", 95])
writer.writerow(["李四", "英语", 88])
# 读取数据
with open("scores.csv", "r", encoding="utf-8") as f:
reader = csv.DictReader(f)
for row in reader:
print(f"{row['姓名']}的{row['科目']}成绩是:{row['分数']}分")
关键点解析:
- 〔注意〕必须指定
encoding="utf-8"避免中文乱码 - 〔注意〕写入时
newline=""防止额外空行 - 〈延伸〉
DictReader将每行转为字典,字段名即键
实际业务中,常需处理不规范CSV(如分隔符混用、缺失值)。可添加异常处理增强鲁棒性:
try:
with open("data.csv", "r", encoding="utf-8") as f:
reader = csv.reader(f)
for row in reader:
if len(row) < 3: # 跳过字段不足的行
continue
process(row)
except FileNotFoundError:
print("文件不存在,请检查路径")
JSON数据处理:API交互的核心
现代Web服务多采用JSON格式传输数据。Python内置json模块可轻松处理:
import json
# Python字典 → JSON字符串
data = {"name": "小明", "scores": [95, 88, 92]}
json_str = json.dumps(data, ensure_ascii=False, indent=2)
print(json_str)
输出(缩进格式便于阅读):
{
"name": "小明",
"scores": [95, 88, 92]
}
关键参数说明:
- 〔注意〕
ensure_ascii=False保留中文字符(否则显示为\u编码) - 〔注意〕
indent=2设置缩进空格数 - 〈延伸〉
json.loads()可将JSON字符串转回字典
实际案例:获取网络API响应并解析:
import requests
response = requests.get("https://api.weather.com/v1/today")
weather_data = response.json()
print(f"今日温度:{weather_data['temp']}℃")
注意:需先安装requests库(pip install requests),且API需返回合法JSON格式。
时间处理:日期计算的精确之道
时间处理是常见痛点。Python的datetime模块提供结构化方案:
from datetime import datetime, timedelta
# 当前时间
now = datetime.now()
print(f"当前时间:{now.strftime('%Y-%m-%d %H:%M:%S')}")
# 3天后日期
three_days_later = now + timedelta(days=3)
print(f"3天后:{three_days_later.strftime('%Y-%m-%d')}")
输出示例:
当前时间:2024-07-15 14:30:22
3天后:2024-07-18
格式化符号说明:
| 符号 | 含义 | 示例 |
|---|---|---|
| %Y | 四位年份 | 2024 |
| %m | 两位月份 | 07 |
| %d | 两位日期 | 15 |
| %H | 24小时制小时 | 14 |
常见陷阱:直接对字符串做日期计算会失败。必须先用strptime()解析:
date_str = "2024-07-15"
date_obj = datetime.strptime(date_str, "%Y-%m-%d")
print(date_obj + timedelta(days=1))
输出:2024-07-16 00:00:00
自动化办公:解放双手
文件批量重命名
手动重命名100个文件耗时耗力。以下脚本可按规则批量处理:
import os
folder = "E:/照片/2024/"
for i, filename in enumerate(os.listdir(folder)):
if filename.endswith(".jpg"):
new_name = f"照片_{i+1:03d}.jpg" # 001, 002...
old_path = os.path.join(folder, filename)
new_path = os.path.join(folder, new_name)
os.rename(old_path, new_path)
print(f"已重命名:{filename} → {new_name}")
关键设计:
- 〔注意〕使用
os.path.join()保证跨平台路径兼容 - 〔注意〕
:03d确保序号补零(1→001) - 〈延伸〉可添加日期前缀:
f"{now.strftime('%Y%m%d')}_照片_{i+1}.jpg"
安全增强版(先预览再执行):
for filename in os.listdir(folder)[:5]: # 仅预览前5个
if filename.endswith(".jpg"):
print(f"将重命名:{filename} → ???")
PDF文件合并
使用PyPDF2库合并PDF(需先安装:pip install PyPDF2):
from PyPDF2 import PdfMerger
merger = PdfMerger()
pdf_files = ["合同1.pdf", "合同2.pdf", "合同3.pdf"]
for pdf in pdf_files:
merger.append(pdf)
merger.write("合并合同.pdf")
merger.close()
print("PDF合并完成!")
高级功能:仅合并指定页面:
merger.append("报告.pdf", pages=(0, 3)) # 仅合并第1-3页(索引0-2)
注意:PDF加密文件需先解密。常见报错PdfReadError: File has not been decrypted时,需添加密码参数:
merger.append("加密文件.pdf", password="123456")
自动发送邮件
使用SMTP协议发送邮件(以QQ邮箱为例):
import smtplib
from email.mime.text import MIMEText
from email.header import Header
# 配置信息
smtp_server = "smtp.qq.com"
smtp_port = 465
sender = "your@qq.com"
password = "your_auth_code" # 需在QQ邮箱设置中获取授权码
# 构建邮件
msg = MIMEText("会议提醒:明日10:00线上会议,请准时参加", "plain", "utf-8")
msg["From"] = Header("系统通知")
msg["To"] = Header("同事")
msg["Subject"] = Header("会议提醒", "utf-8")
# 发送邮件
with smtplib.SMTP_SSL(smtp_server, smtp_port) as server:
server.login(sender, password)
server.sendmail(sender, ["colleague@example.com"], msg.as_string())
print("邮件发送成功!")
关键步骤:
- 开启邮箱SMTP服务并获取授权码(非登录密码)
- 使用SSL加密连接(端口465)
- 收件人列表支持多个地址
〈延伸〉:发送HTML格式邮件只需修改MIMEText参数:
MIMEText("重要通知
请查收附件
", "html", "utf-8")
Web开发入门
构建简易Web服务器
Python内置http.server模块,一行命令启动静态服务器:
python -m http.server 8000
效果:在当前目录启动HTTP服务,访问http://localhost:8000即可查看目录文件。适合本地测试HTML页面。
自定义服务器(支持动态响应):
from http.server import HTTPServer, BaseHTTPRequestHandler
class SimpleHandler(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html; charset=utf-8")
self.end_headers()
html = "欢迎访问简单Python代码
当前路径:" + self.path + "
"
self.wfile.write(html.encode("utf-8"))
server = HTTPServer(("", 8000), SimpleHandler)
print("服务器启动于 http://localhost:8000")
server.serve_forever()
运行后访问http://localhost:8000/about,页面将显示当前路径/about。这展示了Web服务器的核心逻辑:接收请求→处理→返回响应。
Flask框架快速上手
Flask是轻量级Web框架,适合小型项目。安装:pip install flask:
from flask import Flask, render_template_string
app = Flask(__name__)
@app.route("/")
def home():
return "简单Python代码主页
探索编程的无限可能
"
@app.route("/user/")
def user(name):
return f"欢迎,{name}!
这是您的个人主页
"
if __name__ == "__main__":
app.run(debug=True)
运行后访问:
http://localhost:5000/→ 显示主页http://localhost:5000/user/小明→ 动态路径参数
〈延伸〉:使用模板文件(templates/index.html)分离视图:
@app.route("/")
def home():
return render_template("index.html", title="首页", message="欢迎访问")
模板文件内容:
<h1>{{ title }}</h1>
<p>{{ message }}</p>
网络爬虫实践
基础网页数据抓取
使用requests获取网页内容,BeautifulSoup解析HTML(需安装:pip install requests beautifulsoup4):
import requests
from bs4 import BeautifulSoup
url = "https://example.com/articles"
response = requests.get(url)
soup = BeautifulSoup(response.text, "html.parser")
# 提取所有文章标题
for article in soup.select("h2.article-title"):
title = article.get_text(strip=True)
link = article.find("a")["href"]
print(f"标题:{title} | 链接:{link}")
关键点:
- 〔注意〕必须设置
headers模拟浏览器,避免被拦截 - 〔注意〕使用
get_text(strip=True)去除多余空白 - 〈延伸〉
soup.select("div.content p")可定位嵌套元素
防反爬增强版:
headers = {
"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"
}
response = requests.get(url, headers=headers, timeout=10)
处理JavaScript渲染页面
当网页内容由JS动态加载时,requests无法获取。解决方案:
- 分析网络请求,直接调用API接口
- 使用Selenium模拟浏览器
方案二示例(安装:pip install selenium):
from selenium import webdriver
from selenium.webdriver.common.by import By
driver = webdriver.Chrome()
driver.get("https://example.com/dynamic")
# 等待元素加载
driver.implicitly_wait(10)
items = driver.find_elements(By.CSS_SELECTOR, ".product-item")
for item in items:
name = item.find_element(By.CSS_SELECTOR, ".name").text
price = item.find_element(By.CSS_SELECTOR, ".price").text
print(f"{name} - {price}")
driver.quit()
〈延伸〉:结合time.sleep()等待特定元素出现:
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
wait = WebDriverWait(driver, 10)
element = wait.until(EC.presence_of_element_located((By.ID, "content")))
实用工具集锦
命令行进度条
使用tqdm库(安装:pip install tqdm)为循环添加进度显示:
from tqdm import tqdm
import time
for i in tqdm(range(100), desc="处理中"):
time.sleep(0.05) # 模拟耗时操作
输出效果:
处理中:100%|██████████| 100/100 [00:05<00:00, 19.80it/s]
〈延伸〉:支持自定义格式:
for i in tqdm(range(100), desc="下载", bar_format="{l_bar}{bar} | {n_fmt}/{total_fmt} [{elapsed}<{remaining}]"):
pass
日志记录系统
替代print(),实现结构化日志:
import logging
logging.basicConfig(
filename="app.log",
level=logging.INFO,
format="%(asctime)s - %(levelname)s - %(message)s"
)
logging.info("程序启动")
logging.warning("磁盘空间不足")
logging.error("文件读取失败")
日志文件内容:
2024-07-15 14:30:22 - INFO - 程序启动
2024-07-15 14:30:25 - WARNING - 磁盘空间不足
2024-07-15 14:30:28 - ERROR - 文件读取失败
〈延伸〉:按大小轮转日志文件:
from logging.handlers import RotatingFileHandler
handler = RotatingFileHandler("app.log", maxBytes=1024*1024, backupCount=3)
logging.getLogger().addHandler(handler)
学习路径指南
新手30天计划
基础语法:变量、条件、循环、函数
每日任务:用print()实现1个计算器功能,理解if-else嵌套
数据处理:列表/字典操作、文件读写
每日任务:整理自己的下载文件夹,按类型自动分类
工具实践:自动化办公(重命名、PDF处理)
每日任务:用os模块编写批量重命名脚本
综合项目:爬取天气数据并生成报表
每日任务:结合requests与csv模块完成数据采集
〈延伸建议〉:每完成一个项目,用git提交到本地仓库,培养版本控制习惯。
常用库速查表
| 库名称 | 主要用途 | 安装命令 | 典型场景 |
|---|---|---|---|
| requests | HTTP请求 | pip install requests | 网络爬虫、API调用 |
| pandas | 数据处理 | pip install pandas | CSV/Excel分析、数据清洗 |
| matplotlib | 数据可视化 | pip install matplotlib | 绘制折线图、柱状图 |
| openpyxl | Excel操作 | pip install openpyxl | 读写.xlsx文件 |
| pyautogui | GUI自动化 | pip install pyautogui | 自动点击、键盘输入 |
〔重要提示〕:安装库时建议使用虚拟环境(python -m venv venv),避免版本冲突。
常见问题解答
Q:为什么我的代码在Python 3.9能运行,3.7就报错?
A:Python版本差异可能导致语法不兼容。例如match-case语句仅支持3.10+。解决方案:
- 检查代码使用的特性是否依赖新版本
- 在
requirements.txt中指定最低版本:python>=3.8 - 使用
sys.version_info做版本兼容处理
import sys
if sys.version_info < (3, 8):
print("需要Python 3.8+")
sys.exit(1)
Q:如何避免Python脚本被误删?
A:添加文件保护机制:
import os
import sys
# 检查文件是否被移动
script_path = os.path.abspath(sys.argv[0])
if not os.path.exists(script_path):
print("错误:脚本文件丢失")
sys.exit(1)
〈延伸〉:对关键数据文件加密存储:
from cryptography.fernet import Fernet
key = Fernet.generate_key()
cipher = Fernet(key)
with open("data.txt", "rb") as f:
encrypted = cipher.encrypt(f.read())
with open("data.enc", "wb") as f:
f.write(encrypted)
Q:如何调试复杂循环中的变量变化?
A:使用print()调试法升级版:
def process_data(data):
for i, item in enumerate(data):
print(f"处理第{i}项:{item}") # 添加位置信息
if item < 0:
print(f"⚠️ 发现负值:{item},索引{i}")
# ... 处理逻辑
〈进阶〉:使用logging替代print,可控制输出级别:
logging.debug(f"当前处理项:{item}")
logging.info(f"已处理{len(data)}项")
logging.error(f"项'{item}'格式错误")