IntelliJ提交窗口提示JAVA_HOME/PATH未设置的问题求助

使用IntelliJ IDEA Ultimate内置提交窗口处理Gradle构建的Kotlin项目，已配置pre-commit钩子用于detekt检查和许可证更新，点击提交按钮时出现如下报错：

/bin/bash: warning: setlocale: LC_ALL: cannot change locale (en_US.UTF-8)
sh: warning: setlocale: LC_ALL: cannot change locale (en_US.UTF-8)
ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
Please set the JAVA_HOME variable in your environment to match the
location of your Java installation.

终端执行echo $PATH可看到JDK路径已在环境变量中：

nocomment@laptop: ~/Documents/watchdog $ echo $PATH
/home/nocomment/bin:/home/nocomment/.local/bin:/home/nocomment/.cargo/bin:/usr/local/sbin:/usr/local/bin:/usr/bin:/usr/lib/jvm/default/bin:/usr/bin/site_perl:/usr/bin/vendor_perl:/usr/bin/core_perl

其中/usr/lib/jvm/default/bin是Arch Linux仓库安装的jdk17-openjdk路径，IntelliJ中Gradle和项目默认JDK均设置为此路径。已尝试重装JDK、执行archlinux-java fix，问题仍未解决。

1. 修复locale配置问题 #

locale加载异常会干扰环境变量读取，先解决这个警告：

• 编辑/etc/locale.conf文件，确保内容包含：

  LC_ALL=en_US.UTF-8
  LANG=en_US.UTF-8
  

• 执行命令生成locale文件：

  sudo locale-gen en_US.UTF-8
  

• 重启系统或重新登录，让locale配置生效。

2. 确保pre-commit钩子能获取到正确的环境变量 #

IntelliJ的内置提交窗口可能不会加载用户shell的配置文件（如~/.bashrc、~/.zshrc），导致钩子无法读取已配置的JAVA_HOME和PATH，可通过两种方式处理：

方式一：在pre-commit钩子开头手动指定环境变量 #

编辑项目下的.git/hooks/pre-commit文件，在脚本最顶部添加：

export JAVA_HOME=/usr/lib/jvm/default
export PATH=$JAVA_HOME/bin:$PATH

保存后重新尝试提交操作。

方式二：配置IntelliJ加载用户登录shell环境 #

打开IntelliJ的设置面板（File > Settings），找到Tools > Terminal：

• 在Shell path中选择你的默认shell（比如/bin/bash或/bin/zsh）
• 勾选Run shell with login environment选项
• 重启IntelliJ IDEA后再尝试提交。

3. 调试钩子的环境变量 #

如果以上方法无效，可在pre-commit钩子中添加调试代码，查看实际加载的环境变量：
在钩子脚本开头加入：

echo "PATH: $PATH" >> /tmp/pre-commit-debug.log
echo "JAVA_HOME: $JAVA_HOME" >> /tmp/pre-commit-debug.log
locale >> /tmp/pre-commit-debug.log

执行提交后查看/tmp/pre-commit-debug.log文件，确认环境变量是否正确加载，再针对性调整配置。

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