欢迎来到简单Python代码 —— 让编程回归简单本色

简单Python代码 —— 零基础也能轻松学会的Python编程

欢迎来到简单Python代码

本页面专为编程新手打造,以「简单」为核心理念,拒绝冗长理论堆砌,聚焦可运行、可理解、可复用的Python代码示例。我们深知:第一行代码的体验,决定是否继续前行。因此,所有代码均经过严格测试,确保在Python 3.8+环境下可直接运行。

页面内容覆盖从变量定义、循环控制,到文件处理、网络请求、数据可视化等高频场景,每个示例均附带清晰输出结果、运行环境说明与常见报错提示,帮助您建立完整的认知闭环。更设有「常见陷阱」与「最佳实践」模块,助您避开新手易犯错误。

网站名称「简单Python代码」寓意明确:编程不是天才专利,而是逻辑思维的日常表达。当您看到print("Hello, World!")不再困惑,当您能独立写出一个自动整理下载文件夹的脚本,当您用几行代码生成月度报表——您已踏上属于自己的技术成长之路。

为什么选择从「简单」开始?

多数初学者陷入「理论-实践」断层:教程讲得头头是道,自己动手却无从下手。本项目采用「三步闭环」设计:

  1. 问题驱动:每个案例源于真实工作痛点(如“如何批量重命名100个PDF文件?”)
  2. 最小可行代码:仅包含必要语句,避免干扰性复杂逻辑
  3. 可验证结果:提供预期输出截图/文本,即时确认学习成效

例如:处理CSV数据时,我们不直接引入pandas全量教程,而是先用csv标准库实现核心功能,再引导您进阶到更高效方案。这种渐进式设计,让知识积累如搭积木般稳固。

页面结构说明

全站采用语义化HTML5标签构建,所有区块通过锚点导航直达,无需页面跳转。每个模块包含:

  • ⚡ 典型场景:真实业务中高频出现的问题
  • ⚙️ 核心代码:可直接复制使用的最小功能单元
  • 〔注〕关键解析:逐行解释技术原理与设计思路
  • 〈延伸〉拓展方向:当您掌握后可继续探索的进阶主题

所有代码均标注运行环境(如Python版本、依赖包),确保环境一致性。我们坚持:代码不是文档附录,而是可执行的解决方案。

基础语法精要

变量与数据类型:告别抽象定义

初学者常混淆「变量」与「值」的概念。我们用生活化类比理解:变量如同贴了标签的抽屉,值是抽屉里存放的物品。标签可更换,物品可替换,但抽屉本身是容器。

以下代码演示常见数据类型操作:

数据类型 示例代码 输出结果 典型用途
字符串
name = "Python"
greeting = f"欢迎学习{name}!"
print(greeting)
欢迎学习Python! 文本处理、用户交互
列表
colors = ["红", "绿", "蓝"]
colors.append("紫")
print(colors[1:3])
['绿', '蓝'] 有序集合、批量操作
字典
info = {"姓名": "小张", "年龄": 25}
info["职业"] = "工程师"
print(info.get("职业"))
工程师 键值对存储、配置管理

特别注意:字符串是不可变对象,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
%H24小时制小时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("邮件发送成功!")

关键步骤:

  1. 开启邮箱SMTP服务并获取授权码(非登录密码)
  2. 使用SSL加密连接(端口465)
  3. 收件人列表支持多个地址

〈延伸〉:发送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无法获取。解决方案:

  1. 分析网络请求,直接调用API接口
  2. 使用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天计划

第1周

基础语法:变量、条件、循环、函数

每日任务:用print()实现1个计算器功能,理解if-else嵌套

第2周

数据处理:列表/字典操作、文件读写

每日任务:整理自己的下载文件夹,按类型自动分类

第3周

工具实践:自动化办公(重命名、PDF处理)

每日任务:用os模块编写批量重命名脚本

第4周

综合项目:爬取天气数据并生成报表

每日任务:结合requests与csv模块完成数据采集

〈延伸建议〉:每完成一个项目,用git提交到本地仓库,培养版本控制习惯。

常用库速查表

库名称主要用途安装命令典型场景
requestsHTTP请求pip install requests网络爬虫、API调用
pandas数据处理pip install pandasCSV/Excel分析、数据清洗
matplotlib数据可视化pip install matplotlib绘制折线图、柱状图
openpyxlExcel操作pip install openpyxl读写.xlsx文件
pyautoguiGUI自动化pip install pyautogui自动点击、键盘输入

〔重要提示〕:安装库时建议使用虚拟环境(python -m venv venv),避免版本冲突。

常见问题解答

Q:为什么我的代码在Python 3.9能运行,3.7就报错?

A:Python版本差异可能导致语法不兼容。例如match-case语句仅支持3.10+。解决方案:

  1. 检查代码使用的特性是否依赖新版本
  2. 在requirements.txt中指定最低版本:python>=3.8
  3. 使用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}'格式错误")

网友还关心