Python f-string嵌套过深导致的错误及解决方案
Python 的 f-string 在处理复杂的嵌套结构时，可能会遇到“f-string: expressions nested too deeply”的错误。本文将通过示例分析问题根源并提供解决方案。
问题描述
考虑如下代码：
tmp = "黄昏"
s1 = f'{"music.search.searchcgiservice": {"method": "dosearchforqqmusicdesktop","module": "music.search.searchcgiservice","param": {"num_per_page": 40,"page_num": 1,"query": {tmp},"search_type": 0}}}'
运行这段代码会引发“f-string: expressions nested too deeply”错误。这是因为 f-string 的表达式嵌套层级过深，超出了解释器的处理能力。
问题分析
根本原因在于 f-string 使用 {} 作为表达式边界，而目标字符串本身也包含了大量的 {} ，导致解析器难以区分表达式和字符串字面量，从而造成嵌套过深。
立即学习“Python免费学习笔记（深入）”；
解决方案
避免 f-string 嵌套过深，推荐以下几种方法：
方法一： 使用 json.dumps() 函数
对于类似 JSON 结构的字符串，最佳实践是使用 json.dumps() 函数来生成 JSON 字符串，避免手动构造字符串并处理嵌套：
import json
tmp = "黄昏"
data = {
"music.search.searchcgiservice": {
"method": "dosearchforqqmusicdesktop",
"module": "music.search.searchcgiservice",
"param": {
"num_per_page": 40,
"page_num": 1,
"query": tmp,
"search_type": 0
}
}
}
s1 = json.dumps(data)
print(s1)
此方法更清晰、更易于维护，并且避免了 f-string 嵌套过深的问题。
方法二： 分解 f-string 表达式
如果必须使用 f-string，可以将复杂的表达式分解成多个部分，降低嵌套深度：
tmp = "黄昏"
param_str = f'{{"num_per_page": 40,"page_num": 1,"query": {json.dumps(tmp)},"search_type": 0}}'
s1 = f'{{"music.search.searchcgiservice": {{"method": "dosearchforqqmusicdesktop","module": "music.search.searchcgiservice","param": {param_str}}}}'
print(s1)
这种方法通过将 param 部分单独处理，降低了 f-string 的嵌套层级。
方法三： 使用字符串拼接
虽然不如 json.dumps() 方法优雅，但也可以使用字符串拼接：
tmp = "黄昏"
s1 = '{"music.search.searchcgiservice": {"method": "dosearchforqqmusicdesktop","module": "music.search.searchcgiservice","param": {"num_per_page": 40,"page_num": 1,"query": "' + tmp + '","search_type": 0}}}'
print(s1)
这种方法简单直接，但可读性较差，尤其是在字符串较长时。
总而言之，对于复杂的 JSON 或类似结构的字符串，使用 json.dumps() 是最推荐的方案。 其他方法可以作为补充，根据实际情况选择最合适的方案。
