Node.js全应用全局变量定义最佳方案及__dirname问题咨询

问题1：ES模块中获取__dirname的值 #

在"type": "module"模式下，Node.js不再提供全局的__dirname和__filename变量，需要手动通过import.meta.url计算。你可以在需要的模块中添加以下代码：

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

// 当前模块的文件名
const __filename = fileURLToPath(import.meta.url);
// 当前模块所在目录
const __dirname = dirname(__filename);

如果多个模块都需要用到，建议封装成工具模块避免重复代码：

// path-utils.js
import { fileURLToPath } from 'url';
import { dirname } from 'path';

export const getDirname = (importMetaUrl) => {
  const __filename = fileURLToPath(importMetaUrl);
  return dirname(__filename);
};

在其他模块中导入使用：

// app.js
import { getDirname } from './path-utils.js';
const __dirname = getDirname(import.meta.url);

问题2：全局变量的通用最佳方案 #

不建议直接使用globalThis挂载全局变量（易引发命名冲突、增加维护成本），更可靠的方案是创建统一配置模块，集中管理需要复用的变量/配置，其他模块按需导入：

1. 新建配置文件（如app-config.js）：

import { fileURLToPath } from 'url';
import { dirname, join } from 'path';

// 计算项目根目录（根据实际目录结构调整）
const __filename = fileURLToPath(import.meta.url);
const rootDir = dirname(__filename);

export default {
  rootDir,
  // public文件夹路径
  publicDir: join(rootDir, 'public'),
  // 其他全局配置项
  port: process.env.PORT || 3000,
  env: process.env.NODE_ENV || 'development'
};

2. 在任意模块中导入使用：

// server.js 或 app.js
import config from './app-config.js';

// 使用配置项
app.use(express.static(config.publicDir));
console.log('当前运行环境:', config.env);

关于public文件夹非ES模块的兼容 #

若public目录下是CommonJS格式文件，可将其后缀改为.cjs，Node.js会自动识别为CommonJS模块，ES模块中可直接导入：

// 静态导入CommonJS模块
import commonJsModule from './public/some-module.cjs';

// 动态按需加载
const commonJsModule = await import('./public/some-module.cjs');

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