# Python示例代碼
# 本節(jié)演示可變參數(shù)（星號args與雙星號kwargs）詳解的基本用法

# 示例1：基礎(chǔ)用法
print("Hello, Python!")  # 輸出：Hello, Python!

# 示例2：變量定義
name = "Python學(xué)習(xí)者"
age = 25
score = 95.5

print(f"姓名: {name}")
print(f"年齡: {age}")
print(f"分數(shù): {score}")

┌─────────────────────────────────────────────────────────┐
│                    Python核心特點                        │
├─────────────────────────────────────────────────────────┤
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐     │
│  │  簡潔易讀   │  │  面向?qū)ο?  │  │  跨平臺     │     │
│  │  (Readable) │  │  (OOP)      │  │  (Cross)    │     │
│  └─────────────┘  └─────────────┘  └─────────────┘     │
│         ↑                                    ↓          │
│  ┌─────────────────────────────────────────────────┐   │
│  │              豐富的標(biāo)準庫和第三方庫              │   │
│  └─────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────┘

class PythonDemo:
    """Python演示類"""
    
    def __init__(self, name):
        """
        初始化方法
        
        Args:
            name: 名稱
        """
        self.name = name
        self.data = []
        
    def add_data(self, item):
        """添加數(shù)據(jù)"""
        self.data.append(item)
        return self
    
    def process(self):
        """處理數(shù)據(jù)"""
        return [item * 2 for item in self.data]
    
    def show(self):
        """顯示結(jié)果"""
        print(f"{self.name}的數(shù)據(jù): {self.data}")
        print(f"處理結(jié)果: {self.process()}")

# 使用示例
demo = PythonDemo("測試")
demo.add_data(1).add_data(2).add_data(3)
demo.show()

# Windows: 從官網(wǎng)下載安裝包
# 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"已安裝的包數(shù)量: {len(installed_packages)}")

# 第一個Python程序
print("Hello, World!")
print("你好，Python！")

# 使用變量
message = "歡迎學(xué)習(xí)Python"
print(message)

# 格式化輸出
name = "張三"
age = 25
print(f"姓名: {name}, 年齡: {age}")

# 列表操作
numbers = [1, 2, 3, 4, 5]

# 添加元素
numbers.append(6)
print(f"添加后: {numbers}")

# 列表推導(dǎo)式
squares = [x**2 for x in numbers]
print(f"平方后: {squares}")

# 過濾
even_numbers = [x for x in numbers if x % 2 == 0]
print(f"偶數(shù): {even_numbers}")

# 面向?qū)ο缶幊淌纠?
class Student:
    """學(xué)生類"""
    
    # 類屬性
    school = "Python大學(xué)"
    
    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"學(xué)生: {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)

# Windows: 添加Python到環(huán)境變量
# 1. 右鍵"此電腦" -> 屬性 -> 高級系統(tǒng)設(shè)置
# 2. 環(huán)境變量 -> 系統(tǒng)變量 -> Path
# 3. 添加Python安裝路徑

# 或重新安裝時勾選 "Add Python to PATH"

ERROR: Could not find a version that satisfies the requirement

# 使用國內(nèi)鏡像
pip install 包名 -i https://pypi.tuna.tsinghua.edu.cn/simple

# 永久設(shè)置鏡像
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參數(shù)
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):
    """
    計算列表中數(shù)字的平均值
    
    Args:
        numbers: 數(shù)字列表
    
    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}")