Python中str is not callable问题详解及解决办法

听雨眠

发布时间：2026-10-12| 5人浏览过

原创

本文深入解析Python中常见的“str object is not callable”错误。该问题通常由用户自定义变量名覆盖了内置str函数引起。通过示例代码展示错误复现过程，并提供恢复默认str函数的具体解决方法，帮助开发者快速定位并修复此类命名冲突导致的运行时异常。

Python中str is not callable问题详解及解决办法

问题提出：

在编写Python代码时，程序运行期间可能会遇到如下错误提示：

python代码：

def check_province_code(province, country): 
  num = len(province) 
   
  while num <3: 
    province = ''.join([str(0),province]) 
    num = num +1 
   
  return country + province

运行的错误信息：

check_province_code('ab', '001') 
--------------------------------------------------------------------------- 
TypeError                 Traceback (most recent call last) 
<ipython-input-44-02ec8a351cce> in <module>() 
----> 1 check_province_code('ab', '001') 
 
<ipython-input-43-12db968aa80a> in check_province_code(province, country) 
   3  
   4   while num <3: 
----> 5     province = ''.join([str(0),province]) 
   6     num = num +1 
   7  
 
TypeError: 'str' object is not callable

问题分析与排查：

根据错误提示可知，str不再是一个可调用的对象。然而，str原本是Python的内置函数，在官方API文档中明确列为可用函数，为何在此处失效？

我们需要进一步验证这一现象。

在命令行环境中尝试执行str(123)，目的是将数字转换为字符串：

>>> str(1233) 
--------------------------------------------------------------------------- 
TypeError                 Traceback (most recent call last) 
<ipython-input-45-afcef5460e92> in <module>() 
----> 1 str(1233) 
 
TypeError: 'str' object is not callable

至此问题根源已明确。原本存在的str函数已不可用。回顾之前的代码逻辑，发现在定义变量时，不慎使用了str作为变量名，导致内置的str函数被该变量覆盖。具体操作类似于以下示例：