理解模块顶层代码的执行机制
在javascript模块（es modules）中，当你使用import语句导入一个模块时，该模块的所有顶层（top-level）代码都会被执行一次。这意味着，即使你只导入了模块中导出的某个特定函数，模块文件中所有不在函数内部、直接位于文件顶层的语句都会被运行。
例如，考虑以下blah.js文件：
// blah.js
console.log('blah.js 正在运行顶层代码'); // 这是一个顶层副作用
export const function1 = () => {
console.log('function1 被调用');
};
export const function2 = () => {
console.log('function2 被调用');
};如果你在page2.html中尝试仅导入function2：
你会在控制台中看到'blah.js 正在运行顶层代码'被输出，即使你并没有直接调用function1或任何其他顶层逻辑。这是因为模块加载时，其顶层代码总是会先执行，以初始化模块并解析其导出内容。这种行为与传统通过方式加载脚本类似，都会导致整个文件被执行。
避免模块顶层副作用的最佳实践
要解决上述问题，即在导入模块时避免不必要的代码执行，核心原则是：避免在模块的顶层放置任何具有副作用的代码。所有可能产生副作用的操作（如DOM操作、网络请求、全局变量修改、或在页面加载时自动执行的逻辑）都应该封装在函数中，并导出这些函数，以便按需调用。
立即学习“Java免费学习笔记（深入）”；
这种做法使得模块更加纯粹，其主要职责是提供可复用的功能单元，而不是在被导入时自动修改应用程序状态或执行特定逻辑。
重构模块以实现按需执行
假设你的blah.js文件中有一个function1()需要在page1.html加载时自动运行，而function2()则是一个工具函数，你希望在page2.html中按需使用。我们可以将function1()的自动执行逻辑也封装在一个导出的函数中。
以下是重构后的blah.js：
// blah.js - 重构后
console.log('blah.js 模块已加载，但无顶层副作用'); // 这仍会执行，但它没有副作用
/**
* 封装在页面加载完成后执行的逻辑。
* 这是一个副作用，因此被封装在函数中。
*/
export const runFunction1WhenPageLoads = () => {
const actualFunction1Logic = () => {
// 这里是原先 function1() 的具体实现，例如：
console.log('function1 的逻辑在页面加载后执行');
// 执行其他DOM操作、初始化等
};
// 确保在DOM加载完成后执行
if (document.readyState === 'complete') {
actualFunction1Logic();
} else {
window.addEventListener('DOMContentLoaded', actualFunction1Logic);
}
};
/**
* 这是一个纯粹的工具函数，没有顶层副作用。
*/
export const function2 = () => {
console.log('function2 被调用');
// function2 的具体实现
return 'some result from function2';
};
// 可以在这里添加其他纯粹的导出，例如常量或类
export const MY_CONSTANT = 123;在这个重构后的文件中：
- console.log('blah.js 模块已加载，但无顶层副作用'); 这行代码依然会在模块加载时执行，但它本身没有产生对应用状态的副作用，仅仅是一个调试信息。
- 原先自动运行的function1()逻辑被封装在了runFunction1WhenPageLoads函数中。这个函数负责在适当的时机（页面加载完成）执行实际的逻辑。
- function2保持为一个独立的、可按需调用的函数。
在不同页面中按需使用模块功能
现在，我们可以根据不同的页面需求，选择性地导入和调用模块中的功能。
在page1.html中使用：
page1.html需要runFunction1WhenPageLoads来初始化页面。
页面1
欢迎来到页面1
此时，runFunction1WhenPageLoads函数会被导入并立即调用，从而在页面加载完成后执行其内部逻辑。
在page2.html中使用：
page2.html只需要function2，不需要runFunction1WhenPageLoads的副作用。
页面2
欢迎来到页面2
在page2.html中，runFunction1WhenPageLoads函数并未被导入，因此其内部的副作用逻辑也不会被触发。只有function2被导入，并在用户点击按钮时按需调用。
总结与注意事项
- 模块顶层代码执行： 记住，当一个ES Module被导入时，其顶层的所有代码都会被执行一次，无论你导入了多少个具体的导出。
- 避免顶层副作用： 这是编写健壮、可维护模块的关键。将所有会改变全局状态、执行DOM操作或启动复杂流程的代码封装在导出的函数中。
- 按需调用： 通过将副作用封装在函数中并导出，你可以在需要时显式地调用这些函数，从而实现对代码执行的精确控制。
- 提高模块复用性： 遵循这一原则可以使你的模块更具通用性。一个不带副作用的模块可以更容易地在应用程序的不同部分甚至不同项目中复用，而无需担心意外的行为。
- 调试便利性： 当模块行为是显式调用而非自动执行时，调试会变得更加简单，因为你可以更清晰地追踪代码的执行路径。
通过采纳这种模块设计模式，开发者可以构建出更加清晰、高效且易于维护的JavaScript应用程序。
