Python不允许str与int直接拼接，因类型安全设计不支持隐式转换，会报TypeError；解决方式包括f-string（推荐）、str()转换、format()和%格式化，需据可读性、性能及兼容性选用。
为什么拼接字符串和数字会报错
Python 不允许直接用 + 把 str 和 int 拼在一起，这是类型安全的设计——它不会隐式转换，而是抛出 TypeError: can only concatenate str (not "int") to str。常见于打印日志、构造路径、生成 SQL 片段等场景，比如："User ID: " + 123 就会崩。
四种安全拼接方式怎么选
不是所有写法都适合所有场景，得看可读性、性能和上下文：
-
f-string（推荐）：最直观，Python 3.6+ 支持，
f"User ID: {user_id}"，变量自动转为字符串，支持表达式（如{user_id * 2}） -
str()显式转换：兼容老版本，明确意图，"User ID: " + str(user_id)，但注意嵌套多层时易漏转 -
.format()：适合复杂模板或需要复用格式串，"User ID: {}".format(user_id)，但语法略冗长 -
%格式化（不推荐新代码）：遗留代码里还能见，"User ID: %d" % user_id，类型需匹配（%d要整数），否则报错
容易忽略的隐式拼接陷阱
错误常藏在看似“纯字符串”的地方：
- 列表推导里混用类型：
["item" + i for i in [1, 2, 3]]→i是int，必须写成"item" + str(i)或用 f-string - 函数返回值类型不确定：
get_id()看起来返回数字，但实际可能返回None或str，直接拼接前建议先检查或统一转str - 从 JSON 或数据库读出的数据，数字字段默认是
int或float，不是字符串，别想当然当成字符串用
调试时快速定位出问题的变量
报错行不一定就是源头，尤其链式调用中。加一行诊断更省时间：
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
print(repr(user_id), type(user_id))
比 print(user_id) 更有用，能看清是不是空格字符串、None、或者真·整数。如果发现是 int，就确认是否该转 str；如果是 None，就得补默认值或提前处理。
真正麻烦的不是拼接本身，而是上游数据没做类型契约——同一个变量在不同分支里可能是 str 或 int，这种地方光修拼接没用，得往回查数据来源。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
