开发JetBrains IDE插件时ProcessBuilder调用npx遇PATH缺失问题

问题场景 #

开发JetBrains系列IDE（如IntelliJ IDEA、WebStorm）插件时，使用ProcessBuilder调用npx命令：

val builder = ProcessBuilder("npx jest /src/some.test.js").directory(workingDir)

执行时出现错误：Cannot run program "npx" (in directory ...): error=2, No such file or directory。即使指定npx绝对路径/path/to/npx jest /src/some.test.js，仍会触发env: node: No such file or directory错误。

排查发现插件中ProcessBuilder的PATH环境变量远少于终端执行echo $PATH的内容，但IDE内置终端执行相同命令完全正常。尝试手动设置PATH等变量：

builder.environment()["PATH"] = EnvironmentUtil.getEnvironmentMap()["PATH"]

同时对JAVA_HOME、M2_HOME、MAVEN_HOME做了相同操作，均无效果。重启笔记本曾短暂恢复正常，但再次重启后失效，其他用户也遇到相同问题。

解决方案 #

1. 通过登录shell加载完整环境（macOS/Linux） #

JetBrains IDE启动时默认不会加载用户shell的完整配置（如~/.bash_profile、~/.zshrc），导致ProcessBuilder拿到的PATH不完整。可以通过调用登录模式的shell来执行命令，自动加载完整环境：

val command = "npx jest /src/some.test.js"
// 用zsh登录模式执行命令
val builder = ProcessBuilder("/bin/zsh", "-l", "-c", command).directory(workingDir)
// 若使用bash则替换为：
// val builder = ProcessBuilder("/bin/bash", "-l", "-c", command).directory(workingDir)

-l参数让shell以登录模式启动，会自动加载用户的shell配置文件，从而获取完整的PATH。

2. 手动获取并设置完整PATH #

如果不想依赖shell，可主动获取终端中的完整PATH，再赋值给ProcessBuilder：

// 获取zsh环境下的完整PATH
val pathProcess = ProcessBuilder("/bin/zsh", "-l", "-c", "echo \$PATH").start()
val fullPath = String(pathProcess.inputStream.readBytes()).trim()

val builder = ProcessBuilder("npx jest /src/some.test.js").directory(workingDir)
builder.environment()["PATH"] = fullPath
// 可手动补充node相关路径，比如/usr/local/bin、~/.nvm/versions/node/vxx.x.x/bin等

3. 利用JetBrains API获取IDE完整环境 #

IDE内置终端使用的是完整环境，可结合JetBrains API获取并复用：

import com.intellij.util.EnvironmentUtil

// 获取IDE当前环境变量
val ideEnv = EnvironmentUtil.getEnvironmentMap().toMutableMap()
// 补充shell中的完整PATH
val shellPath = ProcessBuilder("/bin/zsh", "-l", "-c", "echo \$PATH").run {
    start().inputStream.bufferedReader().readLine()?.trim() ?: ideEnv["PATH"] ?: ""
}
ideEnv["PATH"] = shellPath

val builder = ProcessBuilder("npx jest /src/some.test.js").directory(workingDir)
builder.environment().putAll(ideEnv)

4. Windows系统适配 #

Windows环境下，通过cmd或PowerShell加载完整环境：

val command = "npx jest /src/some.test.js"
// 使用cmd执行
val builder = ProcessBuilder("cmd.exe", "/c", command).directory(workingDir)
// 或使用PowerShell：
// val builder = ProcessBuilder("powershell.exe", "-Command", command).directory(workingDir)

内容的提问来源于stack exchange，提问作者D.Strizhkov