JavaScript系列（22）--模块化进阶

JavaScript模块化进阶 📦

今天，让我们深入探讨JavaScript的模块化进阶主题。模块化是现代JavaScript开发的核心概念，掌握其高级特性对于构建可维护的大型应用至关重要。

模块化基础回顾 🌟

💡 小知识：ES6模块是静态的，这意味着导入和导出在编译时就已确定，而不是在运行时。这使得静态分析、tree-shaking等优化成为可能。

模块的高级特性 📊

// 1. 动态导入
async function loadModule() {
    try {
        // 动态导入模块
        const module = await import('./dynamic-module.js');
        return module.default;
    } catch (error) {
        console.error('Module loading failed:', error);
        throw error;
    }
}

// 2. 模块命名空间
// math-utils.js
export const add = (a, b) => a + b;
export const subtract = (a, b) => a - b;
export const multiply = (a, b) => a * b;

// main.js
import * as MathUtils from './math-utils.js';
console.log(MathUtils.add(1, 2));      // 3
console.log(MathUtils.multiply(2, 3)); // 6

// 3. 模块聚合
// module-aggregator.js
export { default as Module1 } from './module1.js';
export { default as Module2 } from './module2.js';
export * from './module3.js';

模块加载器实现 🔧

// 1. 简单模块加载器
class ModuleLoader {
    constructor() {  
        this.modules = new Map();
        this.loading = new Map();
    }
    
    async load(modulePath) {
        // 检查缓存
        if (this.modules.has(modulePath)) {
            return this.modules.get(modulePath);
        }
        
        // 检查是否正在加载
        if (this.loading.has(modulePath)) {
            return this.loading.get(modulePath);
        }
        
        // 开始加载
        const loadPromise = this._loadModule(modulePath);
        this.loading.set(modulePath, loadPromise);
        
        try {
            const module = await loadPromise;
            this.modules.set(modulePath, module);
            this.loading.delete(modulePath);
            return module;
        } catch (error) {
            this.loading.delete(modulePath);
            throw error;
        }
    }
    
    async _loadModule(modulePath) {
        const response = await fetch(modulePath);
        if (!response.ok) {
            throw new Error(`Failed to load module: ${modulePath}`);
        }
        const code = await response.text();
        return this._evaluateModule(code, modulePath);
    }
    
    _evaluateModule(code, modulePath) {
        const exports = {};
        const module = { exports };
        const require = (path) => this.load(this._resolvePath(path, modulePath));
        
        const wrapper = Function('exports', 'module', 'require', code);
        wrapper(exports, module, require);
        
        return module.exports;
    }
    
    _resolvePath(relativePath, basePath) {
        // 实现路径解析逻辑
        return new URL(relativePath, basePath).href;
    }
}

// 2. 模块依赖分析器
class ModuleDependencyAnalyzer {
    constructor() {
        this.dependencies = new Map();
    }
    
    analyze(code) {
        const imports = this._findImports(code);
        const exports = this._findExports(code);
        
        return {
            imports,
            exports,
            dependencies: this._buildDependencyGraph(imports)
        };
    }
    
    _findImports(code) {
        const importRegex = /import\s+(?:{[^}]*}|\*\s+as\s+\w+|\w+)\s+from\s+['"]([^'"]+)['"]/g;
        const dynamicImportRegex = /import\(['"]([^'"]+)['"]\)/g;
        
        const imports = new Set();
        let match;
        
        while (match = importRegex.exec(code)) {
            imports.add(match[1]);
        }
        
        while (match = dynamicImportRegex.exec(code)) {
            imports.add(match[1]);
        }
        
        return Array.from(imports);
    }
    
    _findExports(code) {
        const exportRegex = /export\s+(?:{[^}]*}|default\s+\w+|\w+)/g;
        const exports = new Set();
        let match;
        
        while (match = exportRegex.exec(code)) {
            exports.add(match[0]);
        }
        
        return Array.from(exports);
    }
    
    _buildDependencyGraph(imports) {
        const graph = new Map();
        
        for (const imp of imports) {
            if (!graph.has(imp)) {
                graph.set(imp, new Set());
            }
        }
        
        return graph;
    }
}

// 3. 循环依赖检测器
class CircularDependencyDetector {
    constructor() {
        this.graph = new Map();
    }
    
    addDependency(module, dependency) {
        if (!this.graph.has(module)) {
            this.graph.set(module, new Set());
        }
        this.graph.get(module).add(dependency);
    }
    
    detectCycles() {
        const visited = new Set();
        const recursionStack = new Set();
        const cycles = [];
        
        for (const module of this.graph.keys()) {
            if (!visited.has(module)) {
                this._dfs(module, visited, recursionStack, [], cycles);
            }
        }
        
        return cycles;
    }
    
    _dfs(module, visited, recursionStack, path, cycles) {
        visited.add(module);
        recursionStack.add(module);
        path.push(module);
        
        const dependencies = this.graph.get(module) || new Set();
        for (const dependency of dependencies) {
            if (!visited.has(dependency)) {
                this._dfs(dependency, visited, recursionStack, path, cycles);
            } else if (recursionStack.has(dependency)) {
                const cycleStart = path.indexOf(dependency);
                cycles.push(path.slice(cycleStart));
            }
        }
        
        path.pop();
        recursionStack.delete(module);
    }
}

模块打包优化 ⚡

// 1. Tree Shaking实现
class TreeShaker {
    constructor(modules) {
        this.modules = modules;
        this.usedExports = new Map();
    }
    
    analyze(entryPoint) {
        const used = new Set();
        this._analyzeModule(entryPoint, used);
        return used;
    }
    
    _analyzeModule(modulePath, used) {
        if (used.has(modulePath)) return;
        
        used.add(modulePath);
        const module = this.modules.get(modulePath);
        
        // 分析导入
        for (const imp of module.imports) {
            this._analyzeModule(imp, used);
        }
        
        // 标记使用的导出
        this.usedExports.set(modulePath, new Set());
        for (const exp of module.exports) {
            if (this._isExportUsed(exp, module)) {
                this.usedExports.get(modulePath).add(exp);
            }
        }
    }
    
    _isExportUsed(exportName, module) {
        // 实现导出使用分析
        return true; // 简化示例
    }
    
    shake() {
        const result = new Map();
        
        for (const [modulePath, module] of this.modules) {
            if (this.usedExports.has(modulePath)) {
                const usedExports = this.usedExports.get(modulePath);
                result.set(modulePath, {
                    ...module,
                    exports: module.exports.filter(exp => usedExports.has(exp))
                });
            }
        }
        
        return result;
    }
}

// 2. 代码分割优化
class CodeSplitter {
    constructor(modules) {
        this.modules = modules;
        this.chunks = new Map();
    }
    
    split() {
        // 分析模块依赖
        const dependencies = this._analyzeDependencies();
        
        // 创建初始chunk
        const mainChunk = {
            modules: new Set(),
            dependencies: new Set()
        };
        
        // 递归添加模块到chunk
        for (const [module, deps] of dependencies) {
            this._addModuleToChunk(module, deps, mainChunk);
        }
        
        return this.chunks;
    }
    
    _analyzeDependencies() {
        const dependencies = new Map();
        
        for (const [module, content] of this.modules) {
            dependencies.set(module, new Set(content.imports));
        }
        
        return dependencies;
    }
    
    _addModuleToChunk(module, dependencies, chunk) {
        if (chunk.modules.has(module)) return;
        
        chunk.modules.add(module);
        for (const dep of dependencies) {
            chunk.dependencies.add(dep);
            const depDeps = this._analyzeDependencies().get(dep);
            if (depDeps) {
                this._addModuleToChunk(dep, depDeps, chunk);
            }
        }
    }
}

// 3. 模块缓存优化
class ModuleCache {
    constructor() {
        this.cache = new Map();
        this.metadata = new Map();
    }
    
    set(modulePath, module, options = {}) {
        const { maxAge = Infinity } = options;
        
        this.cache.set(modulePath, module);
        this.metadata.set(modulePath, {
            timestamp: Date.now(),
            maxAge
        });
    }
    
    get(modulePath) {
        if (!this.cache.has(modulePath)) {
            return null;
        }
        
        const metadata = this.metadata.get(modulePath);
        if (Date.now() - metadata.timestamp > metadata.maxAge) {
            this.delete(modulePath);
            return null;
        }
        
        return this.cache.get(modulePath);
    }
    
    delete(modulePath) {
        this.cache.delete(modulePath);
        this.metadata.delete(modulePath);
    }
    
    clear() {
        this.cache.clear();
        this.metadata.clear();
    }
}

最佳实践建议 💡

模块设计模式

// 1. 单例模块模式
// singleton.js
let instance = null;

export default class Singleton {
    constructor() {
        if (instance) {
            return instance;
        }
        instance = this;
    }
    
    static getInstance() {
        if (!instance) {
            instance = new Singleton();
        }
        return instance;
    }
}

// 2. 工厂模块模式
// factory.js
export class ModuleFactory {
    static create(type, config) {
        switch (type) {
            case 'service':
                return new ServiceModule(config);
            case 'repository':
                return new RepositoryModule(config);
            default:
                throw new Error(`Unknown module type: ${type}`);
        }
    }
}

// 3. 适配器模块模式
// adapter.js
export class ModuleAdapter {
    constructor(oldModule) {
        this.oldModule = oldModule;
    }
    
    adapt() {
        // 适配旧模块接口到新接口
        return {
            newMethod: (...args) => this.oldModule.oldMethod(...args)
        };
    }
}

模块组织策略

// 1. 按功能组织
// features/
//   ├── auth/
//   │   ├── index.js
//   │   ├── service.js
//   │   └── types.js
//   └── user/
//       ├── index.js
//       ├── service.js
//       └── types.js

// 2. 按层级组织
// src/
//   ├── core/
//   ├── services/
//   ├── repositories/
//   └── utils/

// 3. 模块注册表
// registry.js
export class ModuleRegistry {
    constructor() {
        this.modules = new Map();
    }
    
    register(name, module) {
        if (this.modules.has(name)) {
            throw new Error(`Module ${name} already registered`);
        }
        this.modules.set(name, module);
    }
    
    get(name) {
        if (!this.modules.has(name)) {
            throw new Error(`Module ${name} not found`);
        }
        return this.modules.get(name);
    }
}