寻求将Python代码中f-string字面量转换为format方法的可行方案

1. 用Ruff自动修复（最简便） #

Ruff是当前维护活跃的Python linter/格式化工具，对M1 Mac支持完善，内置了将f-string转为str.format()的自动修复规则：

• 安装Ruff：pip install ruff
• 批量修复代码库：ruff check --select=UP032 --fix .
  其中UP032就是专门处理f-string转str.format()的规则，执行后会自动遍历当前目录及子目录的所有Python文件，完成转换。

2. 用LibCST做精准代码转换（适合复杂场景） #

如果代码里有嵌套表达式、复杂变量引用的f-string，LibCST（Python语法树解析库）能更精准处理，避免正则的局限性：

• 安装LibCST：pip install libcst
• 编写转换脚本示例：

import libcst
import os

class FStringToFormatTransformer(libcst.CSTTransformer):
    def visit_FString(self, node: libcst.FString) -> libcst.BaseExpression:
        # 提取f-string的内容和替换变量
        parts = []
        args = []
        for elem in node.elements:
            if isinstance(elem, libcst.FStringText):
                parts.append(elem.value)
            elif isinstance(elem, libcst.FStringExpression):
                expr = elem.expression
                args.append(expr)
                parts.append("{" + str(len(args)-1) + "}")
        # 拼接成format调用
        format_str = libcst.SimpleString(value=''.join(parts))
        return libcst.Call(
            func=libcst.Attribute(value=format_str, attr=libcst.Name("format")),
            args=[libcst.Arg(arg=arg) for arg in args]
        )

def convert_file(file_path):
    with open(file_path, 'r') as f:
        code = f.read()
    tree = libcst.parse_module(code)
    transformed_tree = tree.visit(FStringToFormatTransformer())
    with open(file_path, 'w') as f:
        f.write(transformed_tree.code)

# 遍历目录下所有py文件
for root, _, files in os.walk('.'):
    for file in files:
        if file.endswith('.py'):
            convert_file(os.path.join(root, file))

运行这个脚本就能批量处理代码库，它会精准解析语法树，处理各种复杂的f-string场景。

3. 正则表达式（仅适合简单场景） #

如果代码里的f-string都是基础格式（无嵌套、无特殊引号），可以用快速正则替换，但注意这种方法容易出错，仅适合简单场景：

• 示例正则替换逻辑（可在编辑器或脚本中实现）：
  匹配模式：f"([^"]+?){([^}]+?)}([^"]+?)"
  替换为："\1{\2}\3".format(\2)
  注意：这个正则无法处理嵌套表达式、单引号f-string等复杂情况，使用前务必测试。

注意事项 #

不管用哪种方法，转换后一定要运行代码库的单元测试，确保逻辑没有被破坏；建议先在备份分支上操作，确认无误后再合并到主分支。

内容的提问来源于stack exchange，提问作者Maximus