把 kebab-case 名称中的连字符换成下划线:order-history → order_history。URL 路径、查询参数、CLI 参数和文件名常用连字符,而 Python 变量、SQL 列以及许多分析或日志 schema 只允许下划线。
粘贴路由、查询 key 或参数名,就能得到可在 Python 代码、数据库列或事件属性中使用的标识符。
文本字符串 中。结果 中复制改名后的文本。GET /api/order-history?page-size=20
GET /api/gift-cards/balance-checkGET /api/order_history?page_size=20
GET /api/gift_cards/balance_check路径片段和查询 key page-size 都被转换;GET、/api 以及数字 20 没有变化。
balance-check → balance_check。?、= 等 URL 字符保持不变。2024-01-01 这样的日期和版本号不受影响。Flask 和 FastAPI 中 /gift-cards/balance-check 这样的路径,通常对应名为 balance_check 的函数。转换路由列表,就得到需要实现的函数名。
进入 BigQuery 或 Snowflake 的 utm-source、ref-code 等查询参数,通常存成 utm_source、ref_code 列。
item-2 变成 item_2,依然是合法的 Python 标识符。my-shop.com → my_shop.com),不要把主机名放进输入。由字母和连字符组成的名称可以。如果名称以数字开头,Python 仍然不接受它作为标识符。
不需要。argparse 本身就会把 --dry-run 变成 args.dry_run。本页适用于要在别处写这些名称的情况,比如配置 key 或文档。