Symbol.description可为原始枚举值添加调试友好描述而不影响运行时行为；通过Object.defineProperty在枚举对象属性上挂载，或用createEnumValue封装返回带Symbol.description的轻量函数对象，实现控制台显示如“200 OK”且保持数值运算能力。
Symbol.description 可以让原始枚举（如 const enum 或纯对象映射）在调试时显示可读的字符串描述，而非无意义的数字或符号。关键在于：不改变运行时行为，仅增强开发者体验。
为原始枚举值绑定描述信息
原始枚举通常用常量对象模拟，例如：
const HttpStatus = {OK: 200,
NOT_FOUND: 404,
INTERNAL_ERROR: 500
};
直接给数字值设置 Symbol.description 不生效（原始值不可扩展）。正确做法是：用 Object.defineProperty 在枚举对象的属性上挂载描述，或封装访问器。
- 对每个枚举键，定义一个 getter 属性，返回带
Symbol.description的包装对象 - 该包装对象是轻量级的、不可变的，并且
toString()和控制台输出时能自然展示描述 - 保持原始值仍可直接参与运算（如
status === HttpStatus.OK）
实现语义化调试的包装器
以下是一个最小可行封装：
function createEnumValue(value, description) {const obj = Object.assign(() => value, { [Symbol.toPrimitive]: () => value });
Object.defineProperty(obj, Symbol.description, {
value: description,
writable: false,
enumerable: false
});
return obj;
}
const HttpStatus = {
OK: createEnumValue(200, "OK"),
NOT_FOUND: createEnumValue(404, "Not Found"),
INTERNAL_ERROR: createEnumValue(500, "Internal Server Error")
};
此时在 Chrome DevTools 或 VS Code 调试器中打印 HttpStatus.OK，会显示 200 "OK"（取决于环境支持程度），而 HttpStatus.OK + 10 仍得 210 —— 语义与行为分离。
兼容性与实际调试表现
Symbol.description 主要被现代浏览器开发者工具识别，但并非所有环境都渲染它：
- V8（Chrome/Node.js）在 console.log 中会尝试显示
Symbol.description（尤其对函数、Symbol 类型） - 对数字包装对象，效果依赖具体实现；更稳定的方式是重写
toString并配合自定义 formatter（如 Chrome 的console.table或自定义util.inspect.custom） - TypeScript 编译后不保留
Symbol.description元数据，因此这是纯运行时调试增强，不影响类型系统
替代方案：利用 toString 配合 Symbol.toStringTag
若 Symbol.description 显示不稳定，可组合使用：
const fn = () => value;
fn.toString = () => `${value} (${name})`;
Object.defineProperty(fn, Symbol.toStringTag, { value: name });
return fn;
}
这样 console.log(HttpStatus.OK) 输出类似 200 (OK)，且 HttpStatus.OK.toString() 也可显式调用。比纯 Symbol 更可控，也无需依赖调试器特殊支持。
