npm运行脚本时docker别名未被podman别名覆盖问题

npm执行package.json中定义的脚本时，会启动非交互、非登录模式的shell子进程运行命令，两个默认机制直接导致配置的alias不生效：

• 你写在~/.zshrc、~/.bashrc中的alias配置，仅会在交互模式终端启动时加载，非交互shell默认不会读取这部分配置
• 即便alias配置被加载，非交互shell默认关闭alias展开功能，就算识别到alias定义也不会做命令替换

这就是为什么直接在终端敲docker-compose up --build（交互shell环境）能正常调用podman-compose，npm跑脚本时却会直接查找PATH下原生的docker二进制，最终报无法连接Docker守护进程的错误。

按稳定性、通用性优先级排序：

方法1：全局软链接替换（最推荐，全场景兼容） #

直接给podman相关命令建立全局软链接，让PATH下的docker、docker-compose直接指向podman可执行文件，完全绕开alias机制，不管是终端敲命令、npm跑脚本、IDE执行任务都能正常生效，没有兼容问题。
操作步骤：

1. 先查询本机podman相关命令的实际安装路径：

   which podman
   which podman-compose
   

2. 建立软链接，把命令里的路径替换成上一步查询到的实际路径（M1芯片Mac通过Homebrew安装的路径一般为/opt/homebrew/bin/，Intel芯片Mac一般为/usr/local/bin/）：

   # 如果/usr/local/bin下已有旧的docker/docker-compose二进制，先删除再执行ln命令
   sudo ln -s /opt/homebrew/bin/podman /usr/local/bin/docker
   sudo ln -s /opt/homebrew/bin/podman-compose /usr/local/bin/docker-compose
   

配置完成后所有场景下调用docker相关命令都会直接走podman，不需要修改任何项目脚本。

方法2：修改npm和shell配置，强制开启alias加载 #

如果不想建立软链接，可以修改配置让npm执行脚本时强制加载alias配置、开启alias展开：

1. 把alias配置和alias展开开关写入shell全局环境配置文件（zsh对应~/.zshenv，bash对应~/.bash_env），以zsh为例，在~/.zshenv末尾追加以下内容：

   alias docker='podman'
   alias docker-compose='podman-compose'
   # 兼容bash/zsh，强制开启alias展开
   shopt -s expand_aliases 2>/dev/null
   setopt aliases 2>/dev/null
   

2. 修改npm默认执行脚本的shell参数，强制使用交互模式运行：

   # zsh用户执行
   npm config set script-shell "/bin/zsh -i"
   # bash用户执行
   npm config set script-shell "/bin/bash -i"
   

这个方法的缺点是跨环境兼容性差，换设备、换shell、CI环境运行时容易复现问题，仅适合个人固定环境使用。

方法3：直接修改项目脚本命令 #

就是已经验证过的方案，把package.json脚本里的docker-compose直接替换为podman-compose即可。缺点是如果项目协作者还在使用原生Docker，会影响其他人使用，仅适合个人本地项目使用。

注意：不要尝试仅修改~/.zshrc/~/.bashrc里的alias配置解决问题，非交互shell默认不会加载这两个文件的配置，修改后不会生效。

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