Python基础之注释的写法(单行多行文档注释)

# Python示例代码
# 本节演示注释的写法（单行多行文档注释）的基本用法
# 示例1：基础用法
print("Hello, Python!")  # 输出：Hello, Python!
# 示例2：变量定义
name = "Python学习者"
age = 25
score = 95.5
print(f"姓名: {name}")
print(f"年龄: {age}")
print(f"分数: {score}")

┌─────────────────────────────────────────────────────────┐
│                    Python核心特点                        │
├─────────────────────────────────────────────────────────┤
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐     │
│  │  简洁易读   │  │  面向对象   │  │  跨平台     │     │
│  │  (Readable) │  │  (OOP)      │  │  (Cross)    │     │
│  └─────────────┘  └─────────────┘  └─────────────┘     │
│         ↑                                    ↓          │
│  ┌─────────────────────────────────────────────────┐   │
│  │              丰富的标准库和第三方库              │   │
│  └─────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────┘

class PythonDemo:
"""Python演示类"""
def __init__(self, name):
"""
初始化方法
Args:
name: 名称
"""
self.name = name
self.data = []
def add_data(self, item):
"""添加数据"""
self.data.append(item)
return self
def process(self):
"""处理数据"""
return [item * 2 for item in self.data]
def show(self):
"""显示结果"""
print(f"{self.name}的数据: {self.data}")
print(f"处理结果: {self.process()}")
# 使用示例
demo = PythonDemo("测试")
demo.add_data(1).add_data(2).add_data(3)
demo.show()

# Windows: 从官网下载安装包
# https://www.python.org/downloads/
# macOS: 使用Homebrew
brew install python3
# Linux (Ubuntu/Debian):
sudo apt update
sudo apt install python3
# 验证安装
python --version
# 或
python3 --version

# 检查Python版本
import sys
print(f"Python版本: {sys.version}")
# 检查已安装的包
import pip
installed_packages = pip.get_installed_distributions()
print(f"已安装的包数量: {len(installed_packages)}")

# 第一个Python程序
print("Hello, World!")
print("你好，Python！")
# 使用变量
message = "欢迎学习Python"
print(message)
# 格式化输出
name = "张三"
age = 25
print(f"姓名: {name}, 年龄: {age}")

# 列表操作
numbers = [1, 2, 3, 4, 5]
# 添加元素
numbers.append(6)
print(f"添加后: {numbers}")
# 列表推导式
squares = [x**2 for x in numbers]
print(f"平方后: {squares}")
# 过滤
even_numbers = [x for x in numbers if x % 2 == 0]
print(f"偶数: {even_numbers}")

# 面向对象编程示例
class Student:
"""学生类"""
# 类属性
school = "Python大学"
def __init__(self, name, age):
"""初始化方法"""
self.name = name
self.age = age
self.grades = []
def add_grade(self, grade):
"""添加成绩"""
self.grades.append(grade)
def get_average(self):
"""计算平均分"""
if not self.grades:
return 0
return sum(self.grades) / len(self.grades)
def __str__(self):
"""字符串表示"""
return f"学生: {self.name}, 年龄: {self.age}, 平均分: {self.get_average():.2f}"
# 使用示例
student = Student("李四", 20)
student.add_grade(85)
student.add_grade(90)
student.add_grade(88)
print(student)

'python' 不是内部或外部命令

# Windows: 添加Python到环境变量
# 1. 右键"此电脑" -> 属性 -> 高级系统设置
# 2. 环境变量 -> 系统变量 -> Path
# 3. 添加Python安装路径
# 或重新安装时勾选 "Add Python to PATH"

ERROR: Could not find a version that satisfies the requirement

# 使用国内镜像
pip install 包名 -i https://pypi.tuna.tsinghua.edu.cn/simple
# 永久设置镜像
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

UnicodeDecodeError: 'gbk' codec can't decode byte

# 指定编码
with open("file.txt", "r", encoding="utf-8") as f:
content = f.read()
# 或使用errors参数
with open("file.txt", "r", encoding="utf-8", errors="ignore") as f:
content = f.read()

ModuleNotFoundError: No module named 'xxx'

# 检查模块是否安装
import sys
print(sys.path)  # 查看模块搜索路径
# 安装缺失的模块
# pip install 模块名

# 1. 使用有意义的变量名
student_name = "张三"  # ✅ 好
a = "张三"  # ❌ 不好
# 2. 添加文档字符串
def calculate_average(numbers):
"""
计算列表中数字的平均值
Args:
numbers: 数字列表
Returns:
平均值
"""
return sum(numbers) / len(numbers)
# 3. 使用类型注解（Python 3.5+）
def greet(name: str) -> str:
return f"你好, {name}!"
# 4. 异常处理
try:
result = 10 / 0
except ZeroDivisionError as e:
print(f"错误: {e}")