Node.js中ES6模块导入前定义全局变量失效问题及解决问询

ES模块规范中，静态import语句存在声明提升特性：当前模块内所有静态import声明都会被解析器提前到模块顶层，按照声明顺序在所有同步业务代码执行前完成依赖模块的加载、解析和执行。
你写的代码实际执行顺序和书写顺序完全不同：

1. 先加载path模块
2. 再加载./my-object-file模块，此时global.appRoot还未完成赋值，因此模块内拿到的是undefined
3. 最后才执行global.appRoot = path.resolve(path.resolve())的赋值逻辑
   而CommonJS的require是运行时同步加载逻辑，执行顺序和书写顺序完全一致，因此之前的CommonJS写法可以正常工作。
   针对你问的「ES6模块导入是否会优先于当前文件所有代码执行」：是的，所有静态import的加载执行都会早于当前文件内的普通同步代码。

你当前ES模块中用来获取根目录的写法存在问题：path.resolve()不传参时等价于获取执行node命令的工作目录（process.cwd()），和CommonJS中__dirname（当前文件所在目录）的语义完全不同，正确的获取方式为：

import path from 'path';
import { fileURLToPath } from 'url';

// 获取当前文件的绝对路径
const __filename = fileURLToPath(import.meta.url);
// 获取当前文件所在目录的绝对路径，等价于CommonJS的__dirname
const __dirname = path.dirname(__filename);
global.appRoot = path.resolve(__dirname);

你可以任选以下两种方案实现需求：

• 方案1：拆分全局变量初始化模块（推荐，符合ES模块规范）
  将全局变量赋值逻辑单独拆分为独立模块，优先导入该模块确保全局变量赋值完成后，再加载依赖全局变量的业务模块：

1. 新建init-global.js：

import path from 'path';
import { fileURLToPath } from 'url';

const __filename = fileURLToPath(import.meta.url);
const __dirname = path.dirname(__filename);
global.appRoot = path.resolve(__dirname);

2. 修改入口文件：

// 优先导入初始化模块，保证全局变量先完成赋值
import './init-global.js';
import myObj from './my-object-file.js';

• 方案2：使用动态import
  动态import是运行时执行的，不会被提升，可以保证赋值完成后再加载业务模块：

import path from 'path';
import { fileURLToPath } from 'url';

const __filename = fileURLToPath(import.meta.url);
const __dirname = path.dirname(__filename);
global.appRoot = path.resolve(__dirname);

// 动态import返回Promise，Node.js支持顶层await可以直接使用
const myObj = (await import('./my-object-file.js')).default;

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