macOS环境下如何获取pkg打包Node应用的正确启动目录

问题根源 #

这个问题的本质就是你判断的那样：macOS 不管是拉起裸可执行二进制，还是标准 .app 程序包，只要是通过 LaunchServices 从 Finder 双击启动的，都会把进程的初始工作目录强制设为当前登录用户的主目录（~/），跟可执行文件本身存放的位置没有关系。
之前几个正常的测试场景，其实都是外部启动方帮忙把工作目录设对了，跟你代码的原有取值逻辑没有关系：

• 用node myApp.js跑源码：你是在源码目录下打开的终端，终端主动把当前工作目录设为源码路径，传给了node进程
• 命令行执行./myApp：你是在二进制所在目录下打开的终端，同样是终端给进程传入了正确的工作目录
• Windows、Linux下运行正常：这两个系统双击启动程序时，默认会把工作目录设为可执行文件所在目录，刚好和你之前用process.cwd()的取值逻辑契合，所以之前的代码能正常运行。

正确的取值逻辑 #

process.cwd()从设计上就不是用来获取“可执行文件所在目录”的API，它返回的是启动进程的外部程序传入的工作目录，完全依赖启动方的行为，天然不适合跨平台固定获取应用根目录。
对于pkg打包的应用，有两个需要避开的常见坑：

• 不要使用__dirname作为路径基准：pkg打包后所有JS代码都运行在内存里的虚拟快照文件系统中，__dirname返回的是虚拟路径，根本不是真实磁盘上的文件位置，用它查找配置文件百分百会出错
• 直接使用process.execPath获取真实路径：这个属性返回当前运行的可执行文件的绝对路径，不受进程工作目录影响，不管你是双击启动、命令行启动、后台服务启动，这个值都是准确的。

兼容所有启动场景的实现代码 #

const path = require('path');

function getAppBaseDir() {
  // 判断当前是不是pkg打包后的二进制环境
  if (process.pkg) {
    const execFullPath = process.execPath;

    // 单独处理macOS .app程序包的特殊路径结构
    // 标准.app的可执行文件路径类似：/xx/yy/MyApp.app/Contents/MacOS/myApp
    if (process.platform === 'darwin' && execFullPath.includes('/Contents/MacOS/')) {
      // 高版本Node（>=15.10）可以直接传dirname的层级参数
      // 低版本不支持的话，循环调用3次path.dirname即可
      // 从可执行文件路径往上跳3层，就到了MyApp.app的所在目录
      // 如果config.json要放在MyApp.app同级，就再往上跳1层
      return path.dirname(execFullPath, 3);
    }

    // 普通裸二进制（Win/Linux/macOS未打bundle的场景）直接取可执行文件所在目录
    return path.dirname(execFullPath);
  }

  // 开发环境：node直接跑源码的场景，沿用原来的cwd逻辑即可
  return process.cwd();
}

// 拼接配置文件的完整路径
const configPath = path.join(getAppBaseDir(), 'config.json');

macOS 场景的额外提醒 #

• 如果你最终把应用放到/Applications目录分发，不要强行把config.json生成在应用所在目录：/Applications是系统级目录，普通用户没有写入权限，强行生成会直接报权限拒绝错误。符合macOS规范的做法是把用户配置存在~/Library/Application Support/你的应用名/专属目录下。
• 没必要绕弯子在启动时修改进程的工作目录来“修正”路径，逻辑复杂还容易出现边界问题，直接从process.execPath推导真实路径是踩坑最少的方案。

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