如何将JavaScript类私有属性（#）转译为下划线前缀公有属性？

一、Babel相关优化方案 #

你提到的privateFieldsAsProperties编译假设确实会引入冗余辅助函数，若想彻底避免这类问题，更可靠的方式是自定义极简Babel插件，通过AST遍历精准替换私有属性前缀：

• 编写小型插件识别ClassPrivateProperty和ClassPrivateMethod节点，直接将名称中的#替换为_
• 这种方式不会误替换字符串、注释中的#，也无需依赖Babel的辅助函数注入
• 核心逻辑示例：

module.exports = function({ types: t }) {
  return {
    visitor: {
      ClassPrivateProperty(path) {
        const newName = t.identifier(path.node.key.name.replace('#', '_'));
        path.node.key = newName;
      },
      ClassPrivateMethod(path) {
        const newName = t.identifier(path.node.key.name.replace('#', '_'));
        path.node.key = newName;
      }
    }
  };
};

将该插件加入Babel配置的plugins数组，转译时即可直接替换私有属性前缀，后续配合@babel/plugin-proposal-class-properties处理字段声明即可。

二、其他转译工具选项 #

• SWC：作为Babel的高性能替代方案，SWC支持privateFieldsAsProperties配置，转译后的代码更简洁，不会生成冗余辅助函数。在swc.config.js中配置：

module.exports = {
  jsc: {
    transform: {
      privateFieldsAsProperties: true,
    },
  },
};

SWC转译速度远快于Babel，适合在CI环境中提升效率。

• esbuild：目前esbuild默认将私有属性转译为WeakMap实现，可通过自定义插件实现前缀替换，但esbuild插件生态不如Babel成熟，实现成本略高。

三、sed替换方案的可行性与实践 #

可行性验证 #

GitHub Actions的Ubuntu runner默认预装sed，完全可以作为Babel转译前的预处理步骤。需要注意：

• 你原本的正则是PCRE语法（支持负向后瞻），但sed默认使用POSIX扩展正则，不支持(?<!...)，需调整为等价写法：

sed -E 's/(^|[^'\''`"&])#/\1_/g' your-file.js

该正则通过(^|[^'\''"&])匹配开头或非引号、&的字符，确保只替换代码中私有属性的#，避免误替换字符串、URL中的#`。

实践案例 #

不少开源项目在CI流程中用sed做代码预处理，比如：

• 老项目迁移时批量替换私有属性前缀，兼容不支持私有语法的环境
• 预处理代码以简化后续压缩步骤，减少冗余字符
  你可以在GitHub Actions的steps中直接添加sed执行步骤：

steps:
  - name: Checkout code
    uses: actions/checkout@v4
  - name: Replace private property # with _
    run: find src -name "*.js" -exec sed -i -E 's/(^|[^'\''`"&])#/\1_/g' {} +
  - name: Run Babel transpilation
    run: npx babel src --out-dir dist --plugins @babel/plugin-proposal-class-properties

注意事项 #

sed方案的局限性是无法区分代码和注释，若你的代码注释中存在独立的#（如// #TODO），会被误替换为// _TODO。如果存在这类场景，建议优先使用自定义Babel插件的方案。

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