TypeScript关键字参数与位置参数选型及JS迁移场景下的实践咨询

TS生态中普遍优先保留对象入参的写法，类型声明的冗余属于可接受的一次性成本，远低于位置参数带来的维护风险，以下是不同场景下的常规实现方案：

1. 公共/跨模块调用函数：优先提前定义独立类型 #

对于对外暴露的函数，提前定义interface/type的收益远高于成本：

• 类型可复用，同业务域的多个函数可以共享、组合类型
• 支持添加JSDoc注释，调用方在IDE中悬浮即可看到每个参数的含义，无需跳转到函数定义
• 类型变更时只需修改一处，所有关联函数自动同步

/** 支付文案渲染入参 */
interface RenderPaymentCopyArgs {
  /** 展示用金额 */
  display_as_amount: number;
  /** 金额转积分比例 */
  amount_to_points_ratio: number;
  /** 原始订单金额 */
  amount: number;
  /** 币种 */
  currency: string;
  /** 已审批金额 */
  amount_approved: number;
  /** 支付状态 */
  status: 'approved' | 'rejected';
}

const renderPaymentCopy = ({
  display_as_amount,
  amount_to_points_ratio,
  amount,
  currency,
  amount_approved,
  status,
}: RenderPaymentCopyArgs) => {
  // 函数实现
}

2. 模块内私有函数：直接使用内联类型声明 #

对于仅在当前模块内调用的私有函数，直接在入参处内联声明类型是性价比最高的选择：

• 无需额外维护独立的类型定义，减少全局类型冗余
• 代码结构内聚，函数定义和参数类型放在一起，阅读时无需跳转查找类型
• 可以配合Prettier、ESLint的自动格式化规则优化排版，避免入参列表看起来过于冗长

const renderPaymentCopy = ({
  display_as_amount,
  amount_to_points_ratio,
  amount,
  currency,
  amount_approved,
  status,
}: {
  display_as_amount: number;
  amount_to_points_ratio: number;
  amount: number;
  currency: string;
  amount_approved: number;
  status: 'approved' | 'rejected';
}) => {
  // 函数实现
}

3. 结合类型复用能力减少重复声明 #

如果入参字段来源于已有类型（比如后端接口类型、通用业务实体类型），可以直接用TS内置的类型工具提取所需字段，无需逐行手写字段类型：

// 已有通用支付订单类型
interface PaymentOrder {
  display_as_amount: number;
  amount_to_points_ratio: number;
  amount: number;
  currency: string;
  amount_approved: number;
  status: 'approved' | 'rejected';
  order_id: string;
  user_id: string;
  // 其他数十个业务字段
}

// 直接从已有类型Pick需要的字段，无需重复声明
const renderPaymentCopy = (args: Pick<PaymentOrder, 'display_as_amount' | 'amount_to_points_ratio' | 'amount' | 'currency' | 'amount_approved' | 'status'>) => {
  const { display_as_amount, amount_to_points_ratio, ...rest } = args;
  // 函数实现
}

4. 带默认值的参数可简化类型声明 #

如果入参字段有默认值，TS会自动从默认值推导类型，无需在类型定义中重复声明类型，仅需标记为可选即可：

const renderPaymentCopy = ({
  display_as_amount,
  amount_to_points_ratio = 10, // 自动推导类型为number
  amount,
  currency = 'cny', // 自动推导类型为string
  amount_approved,
  status,
}: {
  display_as_amount: number;
  amount_to_points_ratio?: number; // 仅需标记可选
  amount: number;
  currency?: string; // 仅需标记可选
  amount_approved: number;
  status: 'approved' | 'rejected';
}) => {
  // 函数实现
}

补充说明：类型声明带来的代码量增加是TS的正常特性，属于一次性投入，后续带来的类型校验、自动补全、重构安全等收益会远高于初期的编写成本。如果是批量迁移老JS项目，可以用ts-migrate这类官方工具自动生成初始类型，大幅减少手动编写成本。
绝对不建议为了简化类型声明切换为位置参数，多个同类型参数传错顺序的问题在TS中也无法完全避免，排查和修复成本远高于写类型的成本。

内容的提问来源于stack exchange，提问作者bigpotato