如何为Selenium WebDriver设置跨平台兼容的相对路径？

嘿，这个跨平台跑ChromeDriver的问题我之前踩过不少坑，给你分享一套能无缝适配Windows、Mac甚至Linux的解决方案，核心就是自动识别操作系统+相对路径管理，不用每次换系统都改代码。

第一步：先把驱动文件按平台分类放好 #

首先在项目的资源目录里给不同平台的ChromeDriver建个专属文件夹，结构大概是这样：

src/test/resources/
├─ chromedrivers/
│  ├─ windows/
│  │  └─ chromedriver.exe
│  ├─ mac/
│  │  └─ chromedriver  # 划重点：Mac和Linux的驱动没有.exe后缀，还要加执行权限
│  └─ linux/
│     └─ chromedriver

提醒下Mac用户：一定要给驱动加执行权限，打开终端到驱动所在目录，运行 chmod +x chromedriver 就行，不然会报权限不足的错误。

第二步：写代码自动识别平台并匹配路径 #

以Java为例（其他语言思路完全一样，比如Python用sys.platform判断），通过系统属性拿到当前操作系统，然后自动拼接对应的驱动路径：

import org.openqa.selenium.chrome.ChromeDriver;
import org.openqa.selenium.chrome.ChromeOptions;

public class CrossPlatformDriverSetup {
    public static ChromeDriver getChromeDriver() {
        String osName = System.getProperty("os.name").toLowerCase();
        String driverPath;

        // 根据操作系统匹配驱动路径
        if (osName.contains("win")) {
            driverPath = "src/test/resources/chromedrivers/windows/chromedriver.exe";
        } else if (osName.contains("mac")) {
            driverPath = "src/test/resources/chromedrivers/mac/chromedriver";
        } else if (osName.contains("nix") || osName.contains("nux")) {
            driverPath = "src/test/resources/chromedrivers/linux/chromedriver";
        } else {
            throw new RuntimeException("哎呀，这个操作系统咱们不支持：" + osName);
        }

        // 设置驱动路径
        System.setProperty("webdriver.chrome.driver", driverPath);
        
        // 可以加些常用的Chrome配置，比如最大化窗口
        ChromeOptions options = new ChromeOptions();
        options.addArguments("--start-maximized");
        
        return new ChromeDriver(options);
    }
}

第三步：验证路径和权限 #

• 相对路径是否有效：确保项目运行的工作目录是项目根目录，Maven/Gradle默认就是根目录，IDE里的话可以检查运行配置的「工作目录」设置，别改成子目录了。
• Mac/Linux权限问题：除了手动加权限，也可以在构建脚本里自动处理，比如Maven用exec-maven-plugin在编译阶段给驱动加权限，省得每次都手动弄。

进阶玩法：用WebDriverManager彻底解放双手 #

如果不想手动下载和管理驱动文件，强烈推荐用WebDriverManager这个库，它会自动检测你的Chrome版本，下载对应平台的驱动，完全不用管路径的事：

import io.github.bonigarcia.wdm.WebDriverManager;
import org.openqa.selenium.chrome.ChromeDriver;
import org.openqa.selenium.chrome.ChromeOptions;

public class EasyCrossPlatformDriver {
    public static ChromeDriver getChromeDriver() {
        // 一行代码搞定驱动管理
        WebDriverManager.chromedriver().setup();
        
        ChromeOptions options = new ChromeOptions();
        options.addArguments("--start-maximized");
        
        return new ChromeDriver(options);
    }
}

这个方案的好处太多了：不用手动找驱动版本，不用管跨平台路径，还能避免驱动和浏览器版本不兼容的问题，我现在写自动化测试基本都用这个。

常见坑排查 #

• 找不到驱动文件：可以先打印一下System.getProperty("user.dir")看看项目根目录是不是你以为的那个，然后把路径拼起来用绝对路径测试下。
• Mac弹出“无法打开因为无法验证开发者”：去系统设置的「安全性与隐私」里，点「仍要打开」就行，或者用终端运行xattr -d com.apple.quarantine chromedriver解除隔离。
• 版本不兼容：如果用手动管理驱动，一定要确保ChromeDriver版本和Chrome浏览器版本一致（大版本相同就行，比如Chrome 114对应ChromeDriver 114.x），用WebDriverManager的话就不用操心这个。

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