JavaScript模块需显式用export/import声明且环境支持：浏览器须type="module"，Node.js须"type":"module"或.mjs；默认为脚本非模块，无自动识别；路径须带扩展名或相对/绝对前缀；export在顶层，default后不可跟函数声明；import()可动态加载但不tree-shaking。
JavaScript 模块是封装代码、隔离作用域、按需加载的基本单位，不是靠 var 或 function 声明就能自动变成模块的——必须显式使用 export 和 import，且运行环境要支持模块系统（比如浏览器启用了 type="module"，或 Node.js 启用了 "type": "module"）。
模块必须用 import / export 显式声明，不能靠文件名或位置自动识别
JS 文件默认是脚本（script），不是模块（module）。即使你把逻辑拆成多个 .js 文件，不加 export 就没有导出，不写 import 就无法导入，全局污染照旧，作用域也不隔离。
常见错误现象：
- 在 HTML 中直接
，然后试图在另一个 script 里用utilsHelper()—— 报错ReferenceError: utilsHelper is not defined - Node.js 里写
module.exports = {...}，但package.json没设"type": "module"，却用import导入 —— 报错ERR_REQUIRE_ESM
正确做法：
立即学习“Java免费学习笔记（深入）”；
- 浏览器中：入口 script 必须带
type="module"，例如 - Node.js 中：要么加
"type": "module"，要么用.mjs后缀，二者选一 - 所有模块内，导出必须用
export，导入必须用import，不混用require()或module.exports
export 的三种写法和对应 import 方式
导出不是“让别人能访问变量”，而是“声明哪些绑定可以被其他模块引用”。绑定一旦导出，就与原始变量保持活连接（不是拷贝值）。
示例（math.js）：
export const PI = 3.14159;
export function add(a, b) {
return a + b;
}
export default function multiply(a, b) {
return a * b;
}对应导入方式：
- 命名导入（解构式）：
import { PI, add } from './math.js'; - 重命名导入：
import { add as sum } from './math.js'; - 默认导入：
import multiply from './math.js';（注意：无大括号，且只能有一个 default） - 全部导入：
import * as math from './math.js';→math.PI,math.add
⚠️ 容易踩的坑：
淘宝客打折系统，集成了jssdk模块，增加了seo优化功能，更有利于搜索引擎收录 1程序上传到服务器空间 2开启服务器 3打开安装地址：http://您的域名/install.php 4如果不能安装请确保数据库里的表全部删除 5进入后台地址：http://您的域名/main.php 默认用户名和密码都是admin 6测试数据时可以导入 test文件夹里的test.sql文件 到数据库，或者
-
export只能出现在顶层作用域，不能在if或函数里 -
export default后面不能接function声明（会报语法错误），得写成export default function() {...}或export default (a, b) => a * b; - 命名导出必须与源文件中声明的名称完全一致，大小写敏感
动态 import() 是函数调用，不是声明，适用于条件加载
静态 import 必须在顶层、编译时确定路径；而 import() 是一个返回 Promise 的函数，可以在任意位置调用，适合按需加载、路由懒加载、错误降级等场景。
典型用法：
async function loadChart() {
const { Chart } = await import('./chart.js');
new Chart(document.getElementById('chart'));
}注意事项：
-
import()的参数必须是字符串字面量或模板字符串（V8 限制），不能是拼接变量，否则打包工具无法静态分析 - 它不触发 tree-shaking（因为路径不确定），但可配合
try/catch实现 fallback - Node.js 中支持，但需启用
--experimental-import-meta-resolve（v20.6+ 已稳定）
模块解析路径必须带扩展名或以 /、./、../ 开头
ESM 规范禁止省略扩展名（不像 CommonJS 自动尝试 .js、.json）。浏览器和现代 Node.js 都严格遵循这点。
错误写法：import { foo } from 'utils'; → 报错 Failed to resolve module specifier "utils"
正确写法（任选其一）：
-
import { foo } from './utils.js';（推荐，明确、可预测） -
import { foo } from '/src/utils.js';（绝对路径，从站点根目录起） import { foo } from '../lib/utils.js';
⚠️ 特别注意：
- Node.js 中若用
exports字段映射入口（如"exports": {".": "./dist/index.js"}），那import 'pkg'才合法；否则必须写完整路径 - 打包工具（如 Vite、Webpack）会自动补扩展名或做别名解析，但原生 ESM 不会 —— 调试时务必确认浏览器 Network 面板里请求的是真实存在的路径
模块不是语法糖，它是运行时行为。写对 export 和 import 只是第一步，路径是否合法、环境是否启用模块模式、是否混用 CJS/ESM，任何一个环节断掉都会静默失败或报难以定位的错误。
