`f-string`（格式化字符串字面量，formatted string literal）是 **Python 3.6+ 引入的最强大、最简洁、最高性能的字符串格式化方式**，被官方推荐为**首选格式化方法**（取代 `%` 和 `.format()`）。 --- ### ✅ 一、基本语法：以 `f` 或 `F` 开头，花括号 `{}` 内写表达式 ```python name = "Alice" age = 30 city = "Beijing" # ✅ 最简用法：直接插入变量 s1 = f"Hello, {name}! You are {age} years old." print(s1) # Hello, Alice! You are 30 years old. # ✅ 支持任意合法 Python 表达式（不只是变量名！） s2 = f"{name.upper()} is {age + 5} in 5 years." print(s2) # ALICE is 35 in 5 years. # ✅ 支持函数调用、方法链、索引、字典键访问等 scores = {"math": 95, "english": 88} s3 = f"{name}'s math score: {scores['math']}, avg: {(scores['math'] + scores['english']) / 2:.1f}" print(s3) # Alice's math score: 95, avg: 91.5 ``` > 🔑 关键特点： > - `{}` 中的内容**在运行时求值**（不是字符串拼接） > - 表达式可含空格、换行（需用括号包裹）、注释（⚠️ 不支持！f-string 中不能写 `#` 注释） > - **无需 `.format()` 调用，无位置/关键字参数管理开销** --- ### ✅ 二、高级用法详解（实战必备） #### 1. ✅ 格式说明符（`:格式`）—— 控制输出样式 ```python x = 123.456789 print(f"x = {x:.2f}") # x = 123.46 （保留2位小数） print(f"x = {x:08.2f}") # x = 00123.46 （总宽8，不足左补0） print(f"hex = {255:x}") # hex = ff （十六进制小写） print(f"bin = {12:b}") # bin = 1100 （二进制） print(f"percent = {0.75:.1%}") # percent = 75.0% （百分比） print(f"date = {__import__('datetime').datetime.now():%Y-%m-%d}") # 当前日期 ``` #### 2. ✅ 调试快捷写法：`{expr=}`（Python 3.8+，自动显示变量名和值） ```python user_id = 1001 status = "active" print(f"{user_id=}, {status=}") # 输出：user_id=1001, status='active' ← 自动加名字+引号！ # 等价于：print(f"user_id={user_id}, status={status}") ``` #### 3. ✅ 多行 f-string（用括号包裹，提高可读性） ```python query = f""" SELECT id, name, email FROM users WHERE age > {min_age} AND city IN {tuple(cities)} ORDER BY {sort_field} DESC """ # ✅ 合法！括号内换行不影响解析 ``` #### 4. ✅ 转义与引号嵌套（灵活处理单/双引号） ```python name = "Alice" print(f"She said: \"Hello, {name}\"") # She said: "Hello, Alice" print(f'She said: "Hello, {name}"') # 同上（外单内双） print(f"Path: C:\\Users\\{name}\\Desktop") # 路径反斜杠（注意双写 \\） ``` #### 5. ✅ 在字典键/列表推导式中使用（表达式自由度极高） ```python data = [1, 2, 3] result = {f"item_{i}": x**2 for i, x in enumerate(data)} print(result) # {'item_0': 1, 'item_1': 4, 'item_2': 9} names = ["alice", "bob"] upper_names = [f"{n.upper()}!" for n in names] print(upper_names) # ['ALICE!', 'BOB!'] ``` --- ### ⚠️ 三、常见错误与避坑指南 | 错误示例 | 问题 | 正确写法 | |----------|------|-----------| | `f"Price: ${price}"` | `$` 是普通字符，但易与 Shell 混淆（非错误，但不推荐） | `f"Price: ¥{price}"` 或 `f"Price: {price} USD"` | | `f"Name: {name} Age: {age} "` | 尾部多余空格 → `"Alice "`, `"30 "`（注意空格在 `{}` 外） | `f"Name: {name} Age: {age}"` | | `f"{x if x > 0 else 0}"` | ✅ 合法！三元表达式支持 | — | | `f"{def func(): return 1}"` | ❌ 语法错误：`def` 是语句，不能在表达式中 | 改用 lambda：`f"{(lambda: 1)()}"`（不推荐，应提前定义） | | `f"{x= !r}"` | ✅ 合法：`!r` 调用 `repr()`；`!s` 调用 `str()`；`!a` 调用 `ascii()` | `f"{name=!r}" → name='Alice'` | > 💡 提示：`!r` 非常适合调试： > ```python > text = "hello\nworld" > print(f"{text!r}") # 'hello\nworld' （显示真实转义字符） > print(f"{text}") # hello↵world （实际换行） > ``` --- ### ✅ 四、性能对比（为什么 f-string 最快？） ```python import timeit name, age = "Alice", 30 # f-string（最快） time_f = timeit.timeit(lambda: f"Hi {name}, {age}", number=1000000) # .format()（次快） time_format = timeit.timeit(lambda: "Hi {}, {}".format(name, age), number=1000000) # % 格式化（最慢） time_mod = timeit.timeit(lambda: "Hi %s, %d" % (name, age), number=1000000) print(f"f-string: {time_f:.4f}s") print(f".format(): {time_format:.4f}s") print(f"%-format: {time_mod:.4f}s") # 典型结果：f-string 比 .format() 快 ~30%，比 % 快 ~50% ``` > ✅ 原因：f-string 在**编译期解析表达式结构**，运行时仅做一次求值+拼接；而 `.format()` 和 `%` 需在运行时解析格式字符串、匹配参数、再替换。 --- ### ✅ 五、完整可运行示例（含所有技巧） ```python # 🌟 综合示例：f-string 实战模板 def generate_report(users): total = len(users) active = sum(1 for u in users if u.get("active", False)) # 多行 + 表达式 + 格式化 + 调试语法 report = f"""📊 User Report ({total} total) ├─ Active users: {active} ({active/total*100:.1f}%) ├─ Top user: {max(users, key=lambda u: u.get("score", 0))["name"]!r} └─ Generated at: {__import__("datetime").datetime.now():%Y-%m-%d %H:%M} """ return report # 测试数据 users = [ {"name": "Alice", "score": 95, "active": True}, {"name": "Bob", "score": 87, "active": False}, {"name": "Charlie", "score": 92, "active": True}, ] print(generate_report(users)) ``` **输出效果：** ``` 📊 User Report (3 total) ├─ Active users: 2 (66.7%) ├─ Top user: 'Alice' └─ Generated at: 2024-06-15 14:22 ``` --- ### ✅ 六、何时不用 f-string？（边界情况） | 场景 | 建议 | 说明 | |------|------|------| | **需要延迟格式化**（如日志模板复用） | 用 `str.format()` 或 `%` | `f"Hello {name}"` 立即求值；而 `"Hello {}".format(name)` 可先存模板 | | **国际化（i18n）** | 用 `gettext` + `.format()` | f-string 无法提取待翻译字符串（`gettext` 工具不识别 `{}`） | | **动态字段名**（key 名在运行时才知道） | 用 `.format(**mapping)` | `key = "price"; f"{data[key]}"` 可行，但 `f"{data.{key}}"` ❌ 语法错误 | --- ### ✅ 七、一句话总结 > **f-string 是 Python 字符串格式化的终极形态：它用最简语法（`f"..."` + `{expr}`），提供最高性能、最强表达力和最佳可读性；只要不是国际化或延迟求值场景，就该无条件优先使用它。** ---