讲师中心 微信公众号

工具推荐

视频效率加速
Seko
Seko

AI短剧一键生成成片

剧云
剧云

中文短剧剧本制作平台

AniShort
AniShort

AI短剧协同制作平台

SoundView
SoundView

字幕擦除翻译、配音口型同步

如何在Python 3.8中利用仅限位置参数/优化API设计

梦婷姑娘_2851

梦婷姑娘_2851

发布时间:2026-11-22 10:48:26

|

164人浏览过

|

来源于php中文网

原创

斜杠 / 是 Python 3.8 引入的强制位置参数分隔符,其左侧参数必须位置传入,违反则抛 TypeError;它保障接口稳定性、兼容性和语义清晰性,不可省略。

如何在python 3.8中利用仅限位置参数/优化api设计

为什么 def func(a, b, /, c, d) 里的斜杠不能省

斜杠 / 是 Python 3.8 引入的语法分隔符,它强制其左侧所有参数必须以位置方式传入,不允许用关键字形式。这不是风格建议,而是运行时约束——一旦违反,Python 直接抛出 TypeError。

常见错误现象:func(1, b=2, c=3, d=4) 会报错 TypeError: func() got some positional-only arguments passed as keyword arguments: 'b',因为 b 在斜杠左边,却用了关键字。

  • 仅限位置参数只能出现在参数列表最左侧,且必须连续(不能中间断开)
  • 斜杠右侧的参数仍可位置或关键字混用,不受影响
  • 斜杠本身不是参数,不参与 *args 或签名检查,但会反映在 inspect.signature() 中

哪些场景下必须用仅限位置参数

核心是「防止调用者误传语义模糊的关键字」。典型场景包括:

  • 历史函数重命名参数但需保持向后兼容:比如旧版 math.pow(x, y),若未来想支持 math.pow(base=x, exp=y),但又怕用户写成 pow(x=2, y=3) 导致歧义,就用 def pow(x, y, /, *, mod=None)
  • 实现与 C 扩展一致的接口:如 str.replace(old, new, count),count 是整数,但语义上绝不是“max_replacements”,用关键字反而降低可读性
  • 避免关键字参数名被意外覆盖:比如 def load(path, /, encoding='utf-8'),确保 path 不会被调用者写成 load(path='/tmp/data', path='xxx') 这种重复键错误(虽然语法上不合法,但 IDE 可能误提示)

functools.partial 和仅限位置参数配合时的坑

当你对含 / 的函数做偏函数绑定时,partial 不会帮你校验位置参数是否“够早”。它只是静态地冻结前几个参数,后续调用时才真正触发斜杠检查。

立即学习“Python免费学习笔记(深入)”;

Define repeatable Python automation sessions in code with nox
Define repeatable Python automation sessions in code with nox

将测试、lint、构建和文档流程编码为命名的Python会话,以便人类和代理每次运行相同的workflow。

下载

示例:

from functools import partial
<p>def greet(greeting, name, /, punctuation='!'):
return f"{greeting}, {name}{punctuation}"</p><p>p = partial(greet, 'Hello')
p('World')  # ✅ 正确
p(name='World')  # ❌ TypeError: greet() takes 2 positional-only arguments but 1 positional argument (and 1 keyword-only argument) were given
  • partial 冻结的是位置序号,不是参数名;所以 p(name='World') 实际变成 greet('Hello', name='World'),违反了 name 必须位置传入的规则
  • 若想支持关键字传 name,得把 name 移到斜杠右边,但那就失去仅限位置的意义了
  • 调试时注意:错误堆栈里报的是原函数名(greet),不是 partial 对象名,容易误判来源

和 *(仅限关键字参数)组合使用的边界情况

斜杠 / 和星号 * 可共存,形成三段式参数结构:pos_only, /, pos_or_kwd, *, kwd_only。但要注意中间段(pos_or_kwd)是唯一灵活区,也是最容易混淆的地方。

例如:

def f(a, b, /, c, d=10, *, e, f=20):
    pass
  • a, b:只能位置传;e:只能关键字传;c, d:位置或关键字都行;f:关键字默认值,但仍是仅限关键字
  • 调用 f(1, 2, 3, e=4) 合法;f(1, 2, d=3, e=4) 也合法;但 f(1, 2, c=3, e=4) 虽然 c 在中间段,却因已用关键字传了 c,后面就不能再用位置传 e(* 后参数必须全关键字)
  • 如果中间段有默认值(如 d=10),它不影响位置传参顺序——你仍得按 a,b,c 的位置填满前三个,不能跳过 c 直接给 d

真正的复杂点不在语法,而在于团队协作时:有人查文档只看参数名,忽略斜杠/星号标记,结果在重构中把本该位置传的改成关键字,导致下游静默崩溃。这类问题往往在集成测试里才暴露。

热门AI工具

更多
花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

码上飞
码上飞 Hot

一款基于自然语言的AI应用开发平台,可根据用户描述自动生成应用程序,帮助个人和团队快速完成应用原型与开发。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

1971

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

5664

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1929

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

34797

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

4047

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

4067

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

1303

2023.08.11

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

636

2023.08.10

Navicat创建数据库教程
Navicat创建数据库教程

本专题整理Navicat创建数据库相关教程,介绍新建前的准备、基础设置和创建后的检查方法。内容兼顾入门学习及实际使用需求,帮助用户了解不同数据库类型下的操作差异,为后续建表、保存数据和日常管理提供参考。

0

2026.11.20

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn