/* JS 不检查参数类型，传错了运行时才暴露 */
function add(a, b) {
  return a + b;
}
add(1, "2"); /* 返回 "12"，不是 3！JS 不会报错 */

/* TS 在写代码时就告诉你类型对不对 */
function add(a: number, b: number): number {
  return a + b;
}
add(1, "2"); /* ❌ 编辑器直接红线报错！数字+字符串 */

/* 全局安装 TypeScript 编译器 */
npm install -g typescript

/* 验证安装是否成功 */
tsc --version

/* 定义一个接口：描述"用户"对象长什么样 */
interface User {
  name: string;
  age: number;
}

/* 函数接收 User 类型参数，返回字符串 */
function greet(user: User): string {
  return `你好，${user.name}，你 ${user.age} 岁了`;
}

const me: User = { name: "小明", age: 25 };
console.log(greet(me)); /* 输出：你好，小明，你 25 岁了 */

/* 编译 TS → JS，生成 hello.js */
tsc hello.ts
/* 用 Node.js 运行编译后的 JS */
node hello.js

/* 参数和返回值都可以标注类型 */
function add(a: number, b: number): number {
  return a + b;
}

/* 箭头函数也可以加类型 */
const multiply = (a: number, b: number): number => a * b;

/* 可选参数：加 ? */
function greet(name: string, greeting?: string): string {
  return `${greeting ?? "你好"}，${name}`;
}

/* 参数默认值：不传就用默认值 */
function createUser(name: string, role: string = "user") {
  return { name, role };
}

/* 定义一个接口，描述"用户"对象的形状 */
interface User {
  id: number;
  name: string;
  email: string;
  avatar?: string;               /* 可选字段（加 ?） */
  readonly createdAt: Date;       /* 只读字段，创建后不能改 */
}

/* 使用接口：必须提供 id/name/email/createdAt */
const user: User = {
  id: 1,
  name: "小明",
  email: "xm@test.com",
  createdAt: new Date()
  /* avatar 不写也行，因为它是可选的 */
};

/* user.createdAt = new Date(); ← ❌ 报错：只读字段不能修改 */

/* id 可以是数字或字符串 */
let id: number | string;
id = 123;     /* ✅ 数字可以 */
id = "abc";  /* ✅ 字符串也可以 */
/* id = true; ← ❌ 布尔值不行！ */

/* 字面量类型：只能是这几个固定值 */
type Status = "pending" | "active" | "deleted";
let userStatus: Status = "active"; /* ✅ */
/* userStatus = "banned"; ← ❌ 不在联合范围内 */

/* T 是类型占位符，用的时候才确定具体类型 */
function first<T>(arr: T[]): T {
  return arr[0];
}

const n = first([1, 2, 3]);       /* n 自动推断为 number */
const s = first(["a", "b"]);        /* s 自动推断为 string */

/* 泛型接口：统一的后端响应格式 */
interface ApiResponse<T> {
  code: number;
  data: T;
  message: string;
}

/* const: 不可重新赋值（推荐默认用 const） */
const name = "小明";

/* let: 可重新赋值 */
let age = 25;
age = 26; /* ✅ 可以改 */

/* var: 老写法，有作用域问题，不要用了 */

/* 模板字符串：用反引号 + ${} 嵌入变量 */
console.log(`${name} 今年 ${age} 岁`);

const nums = [1, 2, 3, 4, 5];

/* map: 对每个元素做变换，返回新数组 */
const doubled = nums.map(n => n * 2);  /* [2, 4, 6, 8, 10] */

/* filter: 过滤符合条件的元素 */
const evens = nums.filter(n => n % 2 === 0); /* [2, 4] */

/* reduce: 累加计算 */
const sum = nums.reduce((acc, n) => acc + n, 0); /* 15 */

/* find: 找第一个满足条件的元素 */
const found = nums.find(n => n > 3); /* 4 */

/* forEach: 遍历每个元素（不返回新数组） */
nums.forEach(n => console.log(n));

const user = {
  name: "小明",
  age: 25,
  city: "广元市旺苍县"
};

/* 解构赋值：一次性取出多个字段 */
const { name, city } = user;
console.log(name, city); /* 小明 广元市旺苍县 */

/* 展开运算符：复制对象并修改部分字段 */
const updated = { ...user, age: 26 };
console.log(updated); /* { name: "小明", age: 26, city: "广元市旺苍县" } */

# 变量不需要声明类型（Python 是动态类型）
name = "小明"
age = 25
height = 1.75
is_student = True  # 布尔值，注意首字母大写

# f-string（类似 JS 模板字符串）
print(f"{name} 今年 {age} 岁，身高 {height} 米")

# 多行字符串：用三个引号
text = """这是
多行
文本"""

# 字符串常用方法
print("hello".upper())       # 转大写：HELLO
print("  hi  ".strip())        # 去空格：hi
print("a,b,c".split(","))      # 分割：['a', 'b', 'c']

score = 85

# if / elif / else — 用冒号开头，缩进表层级
if score >= 90:
    print("优秀")
elif score >= 80:
    print("良好")
elif score >= 60:
    print("及格")
else:
    print("不及格")

# for 循环：range(5) 生成 0~4
for i in range(5):
    print(i)  # 输出 0 1 2 3 4（每行一个）

# while 循环：条件为真就一直跑
count = 0
while count < 3:
    print(f"当前 count = {count}")
    count += 1

fruits = ["苹果", "香蕉", "橙子"]
fruits.append("葡萄")     # 末尾添加元素
fruits.insert(0, "西瓜")   # 在指定位置插入
fruits.remove("香蕉")      # 删除指定元素
print(fruits[0])            # 访问第一个
print(fruits[-1])           # 访问最后一个（负数从末尾计）
print(len(fruits))          # 获取长度

# 基本函数定义
def add(a, b):
    return a + b

# 默认参数：不传就用默认值
def greet(name, greeting="你好"):
    return f"{greeting}，{name}"

print(greet("小明"))        # 输出：你好，小明
print(greet("小明", "哈喽"))  # 输出：哈喽，小明

# 不定长参数：*args 接收任意数量参数
def sum_all(*numbers):
    return sum(numbers)

print(sum_all(1, 2, 3, 4))  # 输出：10

# Lambda 匿名函数（类似 JS 箭头函数）
square = lambda x: x ** 2
print(square(5))  # 输出：25

# 写文件（"w" 模式：覆盖写入）
with open("data.txt", "w", encoding="utf-8") as f:
    f.write("第一行\n")
    f.write("第二行\n")

# 读文件（"r" 模式：只读）
with open("data.txt", "r", encoding="utf-8") as f:
    content = f.read()        # 一次性读取全部
    print(content)

# 逐行读取（适合大文件）
with open("data.txt", "r", encoding="utf-8") as f:
    for line in f:
        print(line.strip())

class Dog:
    # __init__ 是构造方法，创建实例时自动执行
    def __init__(self, name, breed, age):
        self.name = name       # 实例属性：每个狗名字不同
        self.breed = breed     # 品种
        self.age = age         # 年龄

    # 实例方法：self 指向调用它的那只狗
    def bark(self):
        return f"{self.name} 汪汪叫！"

    def birthday(self):
        self.age += 1
        return f"{self.name} 过完生日，{self.age} 岁了"

# 创建两只狗
dog1 = Dog("旺财", "中华田园犬", 3)
print(dog1.bark())       # 旺财 汪汪叫！
print(dog1.birthday())  # 旺财 过完生日，4 岁了

# 安装 FastAPI + uvicorn 服务器
pip install "fastapi[standard]"

# 或用 uv（更现代的包管理器）
uv add fastapi uvicorn

from fastapi import FastAPI

app = FastAPI()                      # 创建应用实例

@app.get("/")                         # GET 请求，访问根路径
def home():
    return {"message": "Hello, FastAPI!"}

@app.get("/users/{user_id}")         # 路径参数 {user_id}
def get_user(user_id: int):
    return {"user_id": user_id, "name": "用户" + str(user_id)}

# 启动开发服务器（修改代码自动重载）
fastapi dev main.py

# 自动生成的 API 文档（直接在浏览器测试！）
# http://127.0.0.1:8000/docs  → Swagger UI（交互式文档）
# http://127.0.0.1:8000/redoc → ReDoc（美观文档）

from fastapi import FastAPI
from fastapi.middleware.cors import CORSMiddleware
from pydantic import BaseModel

app = FastAPI()

# 允许前端跨域访问（开发时必须加）
app.add_middleware(CORSMiddleware, allow_origins=["*"], allow_methods=["*"], allow_headers=["*"])

class Todo(BaseModel):
    title: str        # 待办标题
    done: bool = False  # 是否完成，默认未完成

todos = []              # 演示用内存存储

@app.get("/api/todos")                    # 读取：获取所有待办
def get_todos():
    return todos

@app.post("/api/todos")                   # 创建：新增待办
def add_todo(todo: Todo):
    todos.append(todo.model_dump())
    return {"ok": True}

/* 定义接口类型：和后端 Pydantic 模型保持一致 */
interface Todo { title: string; done: boolean; }

/* 获取所有待办：GET 请求 */
async function fetchTodos(): Promise<Todo[]> {
  const res = await fetch("http://localhost:8000/api/todos");
  return res.json();
}

/* 创建新待办：POST 请求，发送 JSON body */
async function createTodo(title: string): Promise<void> {
  await fetch("http://localhost:8000/api/todos", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ title, done: false })
  });
}

/* 使用示例：创建后获取列表 */
createTodo("学完这个教程").then(() => {
  fetchTodos().then(todos => console.log(todos));
});