Node.js全局安装CLI后无法读取.env文件的问题求助

问题场景 #

用Node.js开发了一款简单CLI工具，依赖inquirer、boxen等包，用dotenv管理.env文件。在项目根目录执行node .时工具能正常运行，但通过npm i -g .全局安装后，用package.json中设置的名称运行CLI，就找不到.env文件。

试过换其他env包，也尝试修改dotenv.config()的路径参数，但因为项目是ES模块结构，import * as dotenv from 'dotenv'在全局运行时会出现导入报错（本地运行则没问题）。原本以为全局安装只是创建符号链接和别名，不会影响.env读取，结果怎么都解决不了。

Index.js 原代码

#! /usr/bin/env node
import fs from 'fs'
import * as dotenv from 'dotenv'
dotenv.config()

let token = process.env.PERSONAL_TOKEN

async function loadUserOptions() {
  const client = new Client({ apiKey: token })
}

此时通过CLI名称运行会因找不到PERSONAL_TOKEN失败，但在根目录执行node .可正常运行。

问题根源 #

全局安装后，CLI的执行上下文是当前终端所在的路径，而dotenv默认读取当前工作目录下的.env文件。也就是说，当你在任意路径运行CLI时，它会去你当前打开终端的文件夹找.env，而不是全局包安装目录里的那个，自然找不到。另外ES模块在全局环境下的导入逻辑和本地项目存在差异，导致手动指定路径的方案也报错。

更关键的是：.env本身是项目级的配置方案，不适合全局CLI工具——用户不可能在每个运行CLI的路径都放一份.env，这完全不符合全局工具的使用逻辑。

最终解决方案：改用Conf包持久化配置 #

放弃用.env管理CLI的配置，转而使用专门的CLI配置持久化工具Conf。它能自动在系统标准配置目录存储数据，不管用户在哪个路径运行CLI，都能读取到配置。

实现步骤 #

1. 安装Conf包

npm install conf

2. 修改CLI代码，用Conf存储和读取配置

#! /usr/bin/env node
import Conf from 'conf';
import inquirer from 'inquirer';

// 初始化配置实例
const config = new Conf();

async function loadUserOptions() {
  // 先尝试读取已存储的token
  let token = config.get('personalToken');
  
  // 如果没有存储，提示用户输入并保存
  if (!token) {
    const answers = await inquirer.prompt([
      {
        type: 'input',
        name: 'token',
        message: '请输入你的PERSONAL_TOKEN:'
      }
    ]);
    token = answers.token;
    // 持久化存储到系统配置目录
    config.set('personalToken', token);
  }

  // 使用token初始化客户端
  const client = new Client({ apiKey: token });
  // 后续业务逻辑...
}

// 启动函数
loadUserOptions();

Conf的优势 #

• 自动适配不同系统的配置存储路径，不需要手动管理文件位置
• 配置持久化存储，用户只需输入一次token，后续运行CLI自动读取
• 完全适配全局CLI的使用场景，不受运行路径影响

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