ProcessBuilder在Processing中无法获取Git版本号的问题排查

问题原因 #

你猜的完全正确：Processing默认的工作目录并非你的草图所在文件夹，而是Processing的安装目录或系统临时目录。git describe --tags需要在包含.git仓库的目录下执行，找不到仓库自然返回空结果。

解决办法 #

核心是让ProcessBuilder在草图目录下执行git命令，具体步骤如下：

• 用Processing内置的sketchPath()函数获取当前草图的绝对路径，这个函数直接返回草图文件夹的路径字符串。
• 给ProcessBuilder设置工作目录，调用directory()方法传入草图目录的File对象。
• 正确读取命令的输出流，避免因流阻塞导致执行异常。

示例代码 #

String getGitVersion() {
  try {
    // 获取草图目录的File对象
    File sketchRoot = new File(sketchPath());
    // 构建git命令
    ProcessBuilder gitProcess = new ProcessBuilder("git", "describe", "--tags");
    // 指定命令执行的工作目录
    gitProcess.directory(sketchRoot);
    
    Process process = gitProcess.start();
    
    // 读取命令输出
    BufferedReader outputReader = new BufferedReader(
      new InputStreamReader(process.getInputStream())
    );
    String version = outputReader.readLine();
    outputReader.close();
    
    // 等待命令执行完成并检查退出码
    int exitCode = process.waitFor();
    if (exitCode == 0 && version != null) {
      return version.trim();
    } else {
      return "unknown";
    }
  } catch (IOException | InterruptedException e) {
    e.printStackTrace();
    return "error";
  }
}

void setup() {
  size(400, 200);
  println("当前版本: " + getGitVersion());
}

void draw() {
  background(255);
  textSize(16);
  text("版本号: " + getGitVersion(), 50, 100);
}

注意事项 #

• 确认你的草图文件夹是一个git仓库（里面有.git隐藏目录）。
• 确保git已安装并添加到系统PATH中，如果Processing找不到git命令，需要在ProcessBuilder里写git的绝对路径，比如Windows下"C:/Program Files/Git/bin/git.exe"，Mac/Linux下"/usr/bin/git"。
• 处理异常情况：比如git未安装、仓库不存在、没有标签等，返回友好的默认值（比如"unknown"）。

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