如何在 Javascript/TypeScript 中实现C++里对象宏(常量宏)/全局常量的效果

如何在 Javascript/TypeScript 中实现C++里对象宏(常量宏)/全局常量的效果

本文介绍一种在 TypeScript 项目中实现C++里对象宏(常量宏)效果的实用方法,兼顾类型提示、开发体验和产物优化。

步骤一:在 global.d.ts 中声明全局常量

首先,在 global.d.ts 文件中声明一个 const 类型的全局变量。例如:

typescript 复制代码
declare const __IS_DEV__: boolean;

注意:由于 const 语义不可修改,理论上你无法在代码中为它赋值或实现它。但实际上可以通过后续步骤解决。


步骤二:运行时安全赋值

  1. 编写一个macro.ts文件
typescript 复制代码
if (typeof __IS_DEV__ === 'undefined') {
  Reflect.set(globalThis, '__IS_DEV__', true);
}
  1. 在入口文件(如 main.ts)最顶部,添加如下代码:
typescript 复制代码
import '<path>/macro.ts';

细节说明

  1. 安全判断

    除了 typeof __IS_DEV__ === 'undefined' 这种写法,其它所有涉及 __IS_DEV__ 的用法都会被视为"使用",在严格模式下会导致运行时错误。

    • 例如,不能写 if (__IS_DEV__),必须写 if (typeof __IS_DEV__ === 'undefined')
  2. 开发与生产环境兼容

    • 在测试或开发环境下,__IS_DEV__ 会被设置为 true
    • 打包时,用 rollup 的 replace 插件将 __IS_DEV__ 替换为 false,配合terser插件净化掉所有相关内容
      • 意味着 if (__IS_DEV__) 将变成 if (false),因其永假性而被terser插件优化掉
      • 同样的,定义处会变成if (typeof false === 'undefined'),因永假性而被terser消除
  3. 类型提示与全局可用性

    • declare 的作用是让全局都能用到 __IS_DEV__ 并获得类型提示,编写时不会报错。
    • 只需在入口文件最上方加上上述定义,运行时即可安全使用。

步骤三:rollup replace 插件配置

rollup.config.mjs 中配置 replace 插件(名为@rollup/plugin-replace):

js 复制代码
replace({
  preventAssignment: true,
  ... // 其他配置
  __IS_DEV__: 'false', // 生产环境下替换为 false
}),

总结

  • 通过类型声明、运行时安全赋值和构建时替换,实现了C++里对象宏(常量宏)效果。
  • 开发/测试环境下变量可用,生产环境下相关代码自动优化消除。
  • 兼顾类型安全、运行安全和产物精简。
相关推荐
烛阴5 分钟前
【TS 设计模式完全指南】构建你的专属“通知中心”:深入观察者模式
javascript·设计模式·typescript
lumi.22 分钟前
Vue.js 从入门到实践1:环境搭建、数据绑定与条件渲染
前端·javascript·vue.js
二十雨辰22 分钟前
vue核心原理实现
前端·javascript·vue.js
影子信息25 分钟前
[Vue warn]: Error in mounted hook: “ReferenceError: Jessibuca is not defined“
前端·javascript·vue.js
北城以北88881 小时前
JavaScript--基础ES(一)
开发语言·javascript·intellij-idea
珍宝商店2 小时前
优雅的 async/await 错误处理模式指南
开发语言·前端·javascript
宋辰月2 小时前
echarts项目积累
前端·javascript·echarts
醉方休3 小时前
TensorFlow.js高级功能
javascript·人工智能·tensorflow
炒香菇的书呆子3 小时前
基于Amazon S3设置AWS Transfer Family Web 应用程序
javascript·aws
!chen3 小时前
学习 React 前掌握 JavaScript 核心概念
javascript·学习·react.js