TypeScript/JavaScript中导入无关联函数时如何避免触发副作用？

下面提供几种可行的方案，根据你的场景选择：

1. 用测试框架Mock无关依赖（无需修改原代码） #

如果你的测试环境是Jest、Vitest这类支持模块Mock的框架，直接Mock掉产生副作用的依赖模块即可。Mock后的模块会替代真实模块，不会执行任何副作用代码，完全不影响无状态函数的测试。

示例（以Jest为例）：

// test.ts
// Mock side_effect模块，用空函数替代真实的thing方法
jest.mock('./side_effect.js', () => ({
  thing: jest.fn()
}));

import { statelessFunction } from './util.js';

test('statelessFunction输出正确内容', () => {
  // 捕获console.log的输出用于断言
  const logSpy = jest.spyOn(console, 'log').mockImplementation();
  
  statelessFunction();
  
  expect(logSpy).toHaveBeenCalledWith('foo');
  
  // 恢复console.log的原始实现
  logSpy.mockRestore();
});

2. 延迟依赖加载（重构原代码） #

把依赖副作用的代码从模块顶部移到函数内部，用动态导入的方式加载依赖。这样只有当调用该函数时才会触发依赖模块的加载，导入statelessFunction时不会执行任何无关代码。

示例：

// util.ts
// 移除顶部的静态导入，改为在函数内动态加载
export async function reliesOnThing() {
  // 同步场景下用await加载，异步场景可以用then
  const { thing } = await import('./side_effect.js');
  thing();
}

export function statelessFunction() {
  console.log("foo");
}

如果reliesOnThing需要保持同步，也可以用同步动态导入（部分构建工具或环境支持，如Webpack、Node.js 16+）：

export function reliesOnThing() {
  const { thing } = require('./side_effect.js'); // CommonJS同步导入
  thing();
}

3. 子模块拆分（优雅的代码组织方案） #

用「桶模块+子模块」的方式，既保持代码的可维护性，又避免不必要的依赖加载：

• 拆分功能到独立子模块：

// util/stateless.ts
export function statelessFunction() {
  console.log("foo");
}

// util/with-side-effect.ts
import { thing } from "../side_effect.js";

export function reliesOnThing() {
  thing();
}

• 用桶模块统一导出（不影响原有代码的使用方式）：

// util/index.ts
export { statelessFunction } from './stateless.ts';
export { reliesOnThing } from './with-side-effect.ts';

测试时直接导入无状态函数所在的子模块：

// test.ts
import { statelessFunction } from './util/stateless.js';

statelessFunction(); // 完全不会触发side_effect模块的加载

这种方式可扩展性强，后续新增函数可以按依赖类型归类到不同子模块，原有业务代码依然可以从util/index.ts导入所有函数，无需改动。

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