私有字段是ES2022正式特性，Chrome 91+、Firefox 90+、Safari 16.4+、Node.js 16.12+等主流环境已原生支持，旧环境需Babel或TypeScript降级处理。
JavaScript 的 # 私有字段（Private Fields）是 ES2022 正式标准化的特性，但实际支持情况因运行环境而异。它不是“写了就能跑”，需要关注引擎版本、构建工具链和目标平台兼容性。
主流浏览器与 Node.js 支持现状
截至 2026 年中，所有现代浏览器最新稳定版均已原生支持 # 私有字段：
- Chrome：v91+（2021年5月起）完全支持，包括 DevTools 调试时对私有字段的隐藏提示
- Firefox：v90+（2021年7月起）支持，早期 v84–v89 存在部分语法解析问题
-
Safari：v16.4+（2023年3月随 macOS Ventura 13.3 更新）起稳定支持；Safari 15.6 及更早版本不识别
#语法，会直接报Unexpected token '#' -
Node.js：v16.12+（2021年10月）开始支持；v14.x 全系不支持，v15.x 仅部分实验性版本启用（需
--harmony-class-fields且不稳定）
构建工具与转译注意事项
若需兼容旧环境（如 IE、老旧安卓 WebView、Node.js v14），不能依赖原生支持，必须借助工具链处理：
-
Babel：需启用
@babel/plugin-proposal-private-methods和@babel/plugin-proposal-class-properties（注意：Babel 转译后的私有字段是“模拟”而非真私有，通过 WeakMap 或闭包实现，外部仍可能通过反射绕过） -
TypeScript：
tsc默认将#field编译为降级代码（如使用private _field+ 命名约定），但不会生成真正的私有语义——除非开启useDefineForClassFields: true并配合目标为 ES2022+，否则无法输出原生# -
打包器（Vite / Webpack）：默认不转译语法，是否支持取决于底层使用的 JavaScript 引擎或配置的 Babel preset。例如 Vite 项目若
target设为'es2015'，则#会被视为语法错误
特殊运行环境限制
某些嵌入式或受限 JS 环境尚未跟进标准：
-
微信小程序基础库：2.28.0+（2024年底起）开始支持
#字段；低于此版本会静默失败或抛出解析异常 -
React Native（Hermes 引擎）：Hermes v0.12+（对应 RN 0.72+）支持；旧版 Hermes（v0.7–v0.11）不识别
#，需关闭 strict mode 或禁用该语法 - Deno：v1.12+（2021年6月）起全面支持，且默认启用，无额外配置要求
- Cloudflare Workers / Bun：均原生支持（Workers 使用 V8 100+，Bun 自研引擎从 v1.0 起即支持）
如何检测运行时是否支持
没有标准 API 可直接判断，但可通过安全的语法探测辅助决策：
- 尝试
eval一个最小私有字段类定义，捕获SyntaxError—— 适用于非严格 CSP 环境 - 构建时通过
package.json的engines字段声明最低 Node.js 版本（如"node": ">=16.12"），配合 CI 检查 - 在文档或 SDK 初始化时记录运行环境信息，对不支持的环境自动降级为
_privateField命名约定 + 注释警告
