【AI Agent系列课程03-Python 基础03】变量、字符串与基础类型:处理接口输入输出
上一篇咱们把房间搭好了,依赖隔离了,骨架立住了。这一篇开始往房间里搬东西——搬的是最基础、但接口开发里出现频率最高的那批砖:变量、字符串、数字、布尔、None。
别一听“基础类型”就划走。我跟你讲,接口开发中百分之七十的低级 bug,全都出在这几样东西上:"false" 被当成真、金额算出来多了个零、用户名字后面带了看不见的空格、None 和空字符串混着用。这些坑不来自什么高深语法,全来自“我以为它是什么样”。
所以这一篇咱们不按语法书的方式讲,按接口的输入输出这个视角,把这几样东西一个个过一遍。
变量:就是给数据贴个标签
Python 里的变量,你可以理解成便利贴。user_id = 1001,意思是“我把一张写着 user_id 的便利贴,贴到了 1001 这个数字上”。以后我想用这个数字,喊一声 user_id 就行。
它跟 C、Java 那些语言不太一样:你不用提前声明类型。贴上去的时候是数字,回头撕下来贴个字符串上去,Python 也不拦你。
x = 100 # 现在贴的是整数
x = "一百" # 撕下来,重新贴个字符串,完全合法
方便是方便,但在接口代码里,这种“随便换”恰恰是 bug 的温床。所以我有两条朴素建议:
第一,名字要能自己说话。 data、info、temp 这种名字,过两天你自己都不知道它装的是什么。request_data、user_profile、retry_count,多敲几个字母,省下来的 debug 时间能多喝两杯咖啡。
第二,接口里的变量,心里要有个“它应该是什么类型”的预期。 虽然 Python 不强制,但你写 user_id 的时候,心里默认它该是整数;写 username 的时候,默认它是字符串。这个预期,就是下一篇类型注解要显式写出来的东西。 现在先养成这个意识。
还有一个词得提一句:变量名能不能用,取决于“作用域”。函数里定义的变量,函数外面喊不到。这个现在不用深究,但你将来在接口里遇到 NameError: name 'xxx' is not defined,八成就是你在一个函数里定义的东西,跑到另一个函数里去用了。
五大基础类型:接口世界里的“五件套”
先给你一张速览表,混个脸熟,后面逐个展开。
| 类型 | 写法示例 | 接口里通常扮演什么 |
|---|---|---|
str 字符串 | "xiaoming" | 用户名、邮箱、Token、URL、状态标识 |
int 整数 | 1001 | ID、数量、年龄、状态码 |
float 浮点数 | 3.14 | 价格、评分、经纬度、比例 |
bool 布尔 | True / False | 是否启用、是否删除、是否通过 |
NoneType | None | “没有值”“还没设置”“查不到” |
注意,Python 的布尔是大写开头的 True / False,不是 true / false。这个差别在你看 JSON 的时候会反复出现:JSON 里是小写 true,Python 里是大写 True。json.loads() 帮你自动转,但你手写字符串对比的时候,写错大小写就永远对不上。
字符串:接口里绝对的“头号角色”
HTTP 传过来的东西,刨去结构,底下几乎全是字符串。URL 是字符串,Header 是字符串,JSON 里的文本是字符串,表单提交上来的数字本质上也是字符串。所以字符串这块,得多花点功夫。
引号:单双都行,但别有强迫症
name = 'xiaoming'
name = "xiaoming"
效果一样。唯一要注意的是嵌套的时候别打架:
msg = "他说:'你好'" # 里面单引号,外面双引号,没事
拼接:用 f-string,别用加号
新手最爱这么写:
greeting = "你好," + name + ",你的ID是" + str(user_id)
能跑,但看着累,而且一旦中间有个数字,就得手动 str() 一下,漏了就是 TypeError。
现代写法,认准 f-string:
greeting = f"你好,{name},你的ID是{user_id}"
花括号里可以直接放变量、放表达式,甚至放函数调用,Python 会自动帮你转字符串。接口里凡是拼日志、拼提示、拼返回消息,一律 f-string。 这个习惯值得从第一天就养成。
去掉多余的空格:.strip()
这个太重要了。用户注册时输了个 " xiaoming ",你不处理就存进数据库,将来登录的时候用户输 "xiaoming",死活匹配不上。
username = raw_input_value.strip()
.strip() 去掉首尾空白(空格、换行、制表符)。凡是接用户输入的地方,几乎都该先 strip() 一下。 这是个不用思考、直接加上的动作。
还有 lstrip()(只去左边)、rstrip()(只去右边),一般用 .strip() 就够了。
大小写:.lower() / .upper()
判断邮箱、判断是否等于某个关键字,常见套路是先统一小写再比:
if user_input.lower() == "yes":
...
不然用户输 "Yes"、"YES"、"yes",你得写三个 or。
拆分和拼接:.split() 和 "分隔符".join()
tags = "python,backend,api".split(",")
# ['python', 'backend', 'api']
result = "-".join(tags)
# 'python-backend-api'
注意 join 是用分隔符去调用,不是用列表去调用,方向别搞反。这个写法第一次看有点反直觉,见两次就顺了。
判断空:别用 == "" 就完事
接口里“字符串是空的”有好几种情况:""(空字符串)、" "(全是空格)、None(压根没传)。稳妥的写法是:
if not text or not text.strip():
# 空字符串、None、纯空白,都会进来
not text 同时能挡住 None 和空字符串,.strip() 再挡一层纯空白。这行代码在接口参数校验里出现的频率高得吓人,建议直接记住。
一个必须知道的事实:字符串是不可变的
s = "abc"
s.upper() # 返回 "ABC"
print(s) # 还是 "abc"
所有字符串方法都是返回一个新字符串,不改原字符串。所以别写 s.upper() 然后指望 s 变了,得 s = s.upper()。
数字:整数和浮点,各有各的脾气
int 和 float 的日常使用没什么好说的,+ - * / 照常用。但有两个地方值得单独拎出来。
除法:/ 和 // 不是一回事
10 / 3 # 3.3333333333333335,结果是浮点数
10 // 3 # 3,向下取整,结果是整数
10 % 3 # 1,取余数
写分页的时候特别容易踩这个:total / page_size 出来是 2.5,你以为 int() 一下就行,但 int(2.5) 是 2,页数是不够的。正确写法是用 // 配合 % 判断,或者直接 math.ceil():
total_pages = -(-total // page_size) # 向上取整的土办法
# 或者更可读
import math
total_pages = math.ceil(total / page_size)
浮点数:别拿它算钱
0.1 + 0.2 # 0.30000000000000004
这不是 Python 的 bug,是所有用二进制表示小数的语言都有的现象。平时无所谓,但涉及金额、计费、对账,绝对不能用 float。
正确做法是用 decimal:
from decimal import Decimal
Decimal("0.1") + Decimal("0.2") # Decimal('0.3')
注意传进去的是字符串,不是浮点数,传 Decimal(0.1) 会把那个精度问题带进去。这个点先记着,遇到金额相关需求再回来查。
布尔和 None:两个最容易“想当然”的地方
布尔的坑:"false" 是真的
if "false":
print("进来了")
猜猜会不会打印?会。 因为非空字符串在 Python 里是真值。所以如果你从 URL 参数、表单、环境变量里拿到 "false",直接 if,它永远为真。
处理办法是显式判断:
value = "false"
is_enabled = value.lower() == "true"
“看起来像布尔的东西”,和“真正的布尔”,是两回事。 这个坑在接口开发里非常常见,尤其是配置项从字符串读进来的时候。
顺带记住“假值”清单,判断空的时候很有用:False、0、""、[]、{}、None,这六样在 if 里都是假。其他都是真。
None:表示“没有”,不是“空”
None 在接口里通常意味着:这个字段压根没有值。它和空字符串 ""、零 0、空列表 [],语义上是不同的。
- 用户没填年龄 → 可能是
None - 用户填了年龄 0(婴儿)→ 是
0,不是None
判断 None,用 is,不用 ==:
if value is None:
...
if value is not None:
...
is 判断的是“是不是同一个对象”,None 在 Python 里全局只有一个,所以 is None 永远可靠。而 == 理论上可以被自定义类改写行为,虽然对 None 一般也没问题,但写 is None 是一种约定俗成的好习惯。
还有一个新手常见的疑惑:if not value 能不能替代 is None?不能完全替代。因为 if not value 在 value = 0、value = ""、value = [] 的时候也会成立。如果你的本意只是“是不是 None”,那就老老实实写 is None,别偷懒,语义清楚比代码短更重要。
类型转换:接口开发的日常动作
接口收到的数据,类型经常不是你以为的那个。URL 参数永远是字符串,表单提交永远是字符串,环境变量也永远是字符串。所以你几乎每天都要做类型转换。
int("123") # 123
float("3.14") # 3.14
str(1001) # "1001"
bool("false") # True —— 注意这个坑!
bool("") # False
看最后两行,bool() 转字符串的时候,只要是非空字符串就是 True。所以想转布尔,别用 bool() 硬转,老老实实比较字符串。
还有一个小细节:int(" 123 ") 是能成功的,Python 会自动忽略两边空格。但 int("12.5") 会直接抛 ValueError,因为它不是整数格式。要先 float() 再 int(),或者干脆一开始就按浮点处理。
转换失败会抛异常,这一点在接口里很重要:别人传了个 "abc" 给你当 ID,你 int("abc") 就炸了。所以要么在外面包 try,要么用框架的校验机制(FastAPI 那层会帮你挡)。这个意识先建立起来:转换不是免费的,是有可能失败的。
踩坑清单:这一篇的精华浓缩
| 坑 | 表现 | 正确姿势 |
|---|---|---|
用户输入没 strip() | 存了带空格的用户名,登录匹配不上 | 接输入先 .strip() |
if "false" | 配置项永远为真 | value.lower() == "true" |
用 == 比 None | 一般没事,但不够严谨 | is None / is not None |
if not x 代替 is None | x = 0 时也被判为假 | 明确语义,该 is None 就写 |
| 浮点算钱 | 0.1 + 0.2 出精度问题 | 用 Decimal |
分页 total / size | 页数少一页 | math.ceil() |
s.upper() 不赋值 | 原字符串没变 | s = s.upper() |
int("12.5") | 直接 ValueError | 先 float() 或者校验格式 |
这个阶段可以练什么: 写一个函数
normalize_user(raw: dict) -> dict,接收一个“脏数据”字典——里面用户名带空格、年龄是字符串、开关是"false"字符串。你的任务是把它们清洗成干净的类型:用户名strip()、年龄int()、开关转成真正的布尔。这个练习看起来朴素,但它把这一篇的内容全串起来了,而且它就是你未来接口里最常写的那种“入参预处理”逻辑的雏形。
说句实在话,这些内容单独看都很简单,简单到你会觉得“这还用讲”。但接口开发真正的功夫,恰恰不在什么高级语法,而在对“数据现在到底是什么类型、什么值”这件事保持清醒。想清楚每一个变量从哪来、是什么、要去哪,你已经比大多数新手稳了。
下一篇,咱们聊列表、字典和嵌套数据——也就是接口里那堆 JSON 到底怎么组织、怎么取、怎么改。那才是真正动手拼“数据结构”的地方。到时候见。
更多推荐



所有评论(0)