本文介绍一种简洁高效的方法，将接受字符串或字符串数组作为参数的函数，统一返回首个字符串值，适用于 typescript 类型安全场景。

本文介绍一种简洁高效的方法，将接受字符串或字符串数组作为参数的函数，统一返回首个字符串值，适用于 typescript 类型安全场景。

在实际开发中，我们常需处理类型为 string | string[] 的灵活输入，并始终期望得到一个确定的 string 类型返回值（例如用于渲染、日志或 API 参数拼接）。此时，关键在于类型守卫 + 安全取值。

最直接且类型安全的实现方式是使用 Array.isArray() 进行运行时判断，并结合可选链或边界检查确保健壮性：

function x(p: string | string[]): string {
  return Array.isArray(p) ? (p.length > 0 ? p[0] : '') : p;
}

✅ 此写法满足全部要求：

Javascript Sdk

用于 inference.sh 的 JavaScript/TypeScript SDK，可运行 AI 应用、构建代理、集成 150+ 模型。包名：@inferencesh/sdk（npm install），完整 TypeScript 支持。

下载

• x("Hello") → "Hello"（原样返回字符串）
• x(["Hello", "World"]) → "Hello"（取首元素）
• x([]) → ""（空数组返回空字符串，避免 undefined）
• TypeScript 编译通过：返回类型明确为 string（非联合类型），便于后续链式调用

⚠️ 注意事项：

• 不可省略 Array.isArray()：仅靠 typeof p === 'object' 无法准确区分数组与普通对象，且 string[] 在运行时确实是 object，但该判断不具排他性。
• 避免直接访问 p[0] 而不校验长度：若传入空数组 []，p[0] 会返回 undefined，可能引发隐式类型错误或运行时异常。
• 若业务逻辑允许 undefined 作为有效值，可改用 return Array.isArray(p) ? p[0] : p;，但此时函数签名需同步改为 string | undefined，牺牲了类型确定性。

进阶建议：如需复用该逻辑，可封装为工具函数或使用 Lodash 的 head()（需注意其对非数组输入的处理策略），但在轻量场景下，原生 Array.isArray() + 三元表达式已是最佳实践——简洁、零依赖、类型清晰、性能最优。