TypeScript接口属性能否使用短横线？如何定义HTTP头类型？

你猜的完全没错！TypeScript接口里直接使用带短横线的属性名（比如Content-Type）会报错，核心原因是这类名称不符合JavaScript的标识符规范——JS标识符只能包含字母、数字、下划线_和美元符号$，且不能以数字开头，短横线显然不在允许范围内，所以TS会抛出Property or signature expected的错误。

下面给你几种实用的解决办法，适配不同的场景：

1. 给属性名加引号（最适合固定头字段） #

如果你的HTTP头字段是固定的（比如Content-Type、Authorization这类标准头），直接把属性名用单引号或双引号包裹，TS就能识别它为字符串字面量属性：

// 注意接口名首字母大写，符合TS编码规范
interface HttpHeader {
  'Content-Type': string;
  'Authorization'?: string; // 可选字段加?标记
}

修改你的函数后就能正常使用：

export function HTTPOptionCreate(
  url: string,
  path: string,
  port: number,
  method: string,
  header: HttpHeader
) {
  // 你的业务逻辑代码
}

2. 使用索引签名（适合任意头字段） #

如果你的HTTP头可能包含各种自定义的带特殊字符的键，用索引签名可以灵活适配任意字符串类型的键：

interface HttpHeader {
  [key: string]: string | undefined; // 值允许为string或undefined，适配可选头
}

这样不管是Content-Type还是X-Custom-Header这类自定义头，都能被正确做类型检查。

3. 使用内置Record类型（简洁的键值对定义） #

TypeScript提供了内置的Record类型，可以快速定义“键为字符串、值为指定类型”的结构，和索引签名效果一致，但写法更简洁：

type HttpHeader = Record<string, string | undefined>;

4. 混合固定属性和索引签名（兼顾固定头和自定义头） #

如果既想强制要求某些固定头字段，又允许添加自定义头，可以混合写法：

interface HttpHeader {
  'Content-Type': string; // 必填固定头
  [key: string]: string | undefined; // 允许其他任意字符串键的头
}

本质上，TypeScript的属性命名规则和JavaScript完全一致，官方手册虽然没有单独针对“短横线属性”做说明，但在标识符规范的章节里隐含了这个规则——毕竟TS最终会编译为JS，必须遵循JS的语法约束。

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