IntelliJ IDEA在WSL2中运行Java程序报错export: ProgramFiles(x86): bad variable name

问题根因 #

该错误是WSL2默认继承Windows系统环境变量导致的。Windows侧自带名为ProgramFiles(x86)的系统环境变量，变量名包含的()不符合bash shell的变量名命名规范，shell执行环境变量导出操作时会直接抛出语法错误。

解决方案 #

方案1：全局禁用WSL的Windows环境变量继承 #

适合不需要在WSL内调用Windows侧程序的场景：

• 在WSL终端中执行命令编辑配置文件：sudo nano /etc/wsl.conf
• 写入如下配置内容：

[interop]
appendWindowsPath = false

• 保存文件退出后，在Windows的PowerShell/CMD中执行wsl --shutdown重启WSL实例，重新进入WSL后配置生效。

方案2：Shell启动时自动过滤非法变量 #

适合需要保留WSL调用Windows程序能力的场景：

• 编辑当前shell的配置文件，bash用户编辑~/.bashrc，zsh用户编辑~/.zshrc，在文件末尾添加如下逻辑：

# 清理名称包含括号的非法Windows继承环境变量
for invalid_var in $(env | grep -E '^[^=]+\([^=]+\)=' | cut -d '=' -f 1); do
    unset "$invalid_var"
done

• 保存退出后执行source ~/.bashrc（zsh用户替换为对应配置文件路径）即可立即生效，后续每次启动shell都会自动清理非法变量。

方案3：仅修改IDEA运行配置（项目级生效） #

仅针对当前Java项目运行生效，不影响WSL全局配置：

• 打开IDEA顶部菜单栏「Run」→「Edit Configurations」，找到对应Java程序的运行配置项
• 找到「Environment variables」配置栏，点击右侧的编辑按钮
• 可以直接勾选「Do not inherit system environment variables」选项，仅手动添加项目需要的环境变量；也可以在继承的变量列表中手动删除所有名称带括号的Windows继承变量
• 保存配置后重新运行Java程序即可。

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