f-string是Python 3.6+引入的字符串格式化语法,3.5及更早版本不支持,会直接报SyntaxError;需通过python3 --version或sys.version确认解释器版本,.format()和%格式化是兼容旧版本的替代方案。
f-string 是 Python 3.6 才正式加入的语法,3.5 及更早版本根本无法解析 f"..." 这种写法,会直接报 SyntaxError: invalid syntax —— 不是配置问题,也不是 IDE 没识别,而是解释器压根不认识这个前缀。
Python 版本验证必须做在运行前
很多人以为“代码能 import 就代表环境 OK”,但 f-string 在词法分析阶段就被拒绝,连进入 import 流程的机会都没有。所以第一步永远是确认版本:
- 终端执行
python3 --version或在脚本里加import sys; print(sys.version) - Ubuntu 16.04 自带的
python3就是 3.5,pip3 install --upgrade pip后 pip 自身用了 f-string,导致整个 pip 崩溃 —— 这不是 pip 坏了,是它被强行塞进了不兼容的解释器里 - 不要依赖
which python3的路径判断版本,有些系统 PATH 里混着多个 Python,实际执行的可能是旧版本
.format() 是最稳妥的替代方案
.format() 从 Python 2.6 就存在,覆盖所有需要兼容的旧环境,且语义清晰、调试友好:
Python 3.14.3
微软官方的 Python 扩展,是 VS Code 安装量最高的扩展(209M+)。集成 IntelliSense(通过 Pylance)、调试(通过 Python Debugger)、代码检查、格式化、重构和单元测试等功能。支持 Jupyter Notebook、虚拟环境管理和多 Python 版本切换。
- 基础用法:
"Hello {}".format(name)、"{user} is {age}".format(user="Alice", age=25) - 避免拼写错误:f-string 中写错变量名是
NameError,而.format()错了会抛KeyError或IndexError,更容易定位 - 注意位置参数和关键字参数不能混用:
"{0} {name}".format("hi", name="bob")合法,但"{0} {1}".format("hi", name="bob")会报错 - 如果模板固定、变量多,推荐用
**locals()简化传参,比如函数内直接写"{x} + {y} = {result}".format(**locals())
% 格式化虽老但最无脑兼容
只要 Python 还能跑,% 就一定行,适合快速修复或嵌入式/受限环境:
- 简单场景够用:
"Path: %s, count: %d" % (path, n) - 类型敏感:
%s强转 str,%d要整数,%f要浮点 —— 写错会抛TypeError,比 f-string 的静默失败更可控 - 嵌套括号容易翻车:
"%s" % ("a", "b")会报TypeError: not all arguments converted,因为右边是 tuple,得写成"%s" % ("a",)或"%s %s" % ("a", "b") - 不支持命名字段(如
"%(name)s"虽然可用,但可读性差,且和 logging 配置冲突风险高)
真正麻烦的不是选哪种格式化,而是有人在 setup.py 或 pyproject.toml 里写了 python_requires >= "3.6" 却还在 3.5 环境里硬跑 —— 解释器连第一行 f"..." 都过不去,后续所有逻辑都白搭。兼容性声明和实际运行环境必须对齐,否则任何字符串格式化技巧都救不了语法层面的死刑。