
vite 本身不支持类似 webpack 的注释标记式代码排除,但可通过 `import.meta.env.dev` 实现精准的环境条件编译:开发时执行并保留代码,构建时自动剔除,零配置、零插件、原生可靠。
在 Vite 中,没有内置的 ###SOMETHING / ###END_SOMETHING 这类注释驱动的代码剔除机制(即“源码级条件剥离”),但这并不意味着无法实现相同效果。Vite 基于 Rollup 构建,而 Rollup 在打包阶段会进行死代码消除(Dead Code Elimination, DCE) —— 只要代码被静态判定为不可达,就会被完全移除。结合 Vite 提供的环境变量机制,我们就能安全、高效地达成目标。
核心方案是使用 import.meta.env.DEV:
// 示例:仅在开发环境运行的调试逻辑
if (import.meta.env.DEV) {
console.log('✅ 开发专用日志');
const mockApi = new MockService();
mockApi.enable();
}✅ 为什么这能实现“构建时排除”?
- import.meta.env.DEV 是一个编译时内联常量:Vite 在构建阶段(vite build)会将它直接替换为 false(生产环境)或 true(开发环境)。
- 因此上述代码在生产构建后实际变为:
if (false) { console.log('✅ 开发专用日志'); const mockApi = new MockService(); mockApi.enable(); } - Rollup 的 DCE 会识别该 if (false) 分支为永远不执行的死代码,并彻底删除整个块——连字符串字面量、函数调用、模块导入都会被移除,不占用任何产物体积。
⚠️ 重要注意事项:
❌ 不要使用动态表达式(如 import.meta.env['DEV'] 或变量赋值后再判断),否则 DCE 失效;
❌ 避免副作用依赖:若 MockService 的构造函数或 enable() 方法有副作用(如全局 patch、定时器启动),请确保其定义本身也受 DEV 条件包裹,否则模块可能仍被引入;
-
✅ 推荐封装为可复用的开发钩子(尤其适合大型项目):
// src/utils/devOnly.ts export function devOnly
(fn: () => T): T | undefined { return import.meta.env.DEV ? fn() : undefined; } // 使用 devOnly(() => { console.info('仅开发可见的性能分析器已挂载'); setupProfiler(); });
? 进阶提示:如需更精细控制(例如按自定义模式剔除),可配合 --mode 启动参数与 .env.[mode] 文件定义专属环境变量,例如:
vite build --mode preview # 使用 .env.preview 中的 VITE_EXCLUDE_DEMO=true
然后在代码中使用 import.meta.env.VITE_EXCLUDE_DEMO 做条件判断。
总结:无需插件、无需复杂配置,import.meta.env.DEV + if 语句就是 Vite 官方推荐、生产就绪的“条件编译”方案——它简洁、可靠、零运行时开销,且与 TypeScript 完美兼容。









