selenium

环境要求

• Windows 系统（README 的自动/手动安装流程均面向 Windows）
• 以管理员身份运行的 PowerShell
• MSYS2 与已安装"Desktop development with C++"工作负载的 Visual Studio Community
• 已安装 Python 与 pip（用于 Python 绑定的本地安装）
• 已安装 Docker（如需构建开发镜像）

安装与启动步骤

1. 1克隆项目代码

   把 Selenium 仓库克隆到你想放置的父目录，后续所有 ./go 命令都要在仓库根目录执行。

   git clone https://github.com/SeleniumHQ/selenium.git

   复制

2. 2一键装开发环境

   管理员 PowerShell 先放开脚本执行策略，再运行官方脚本自动补齐开发环境，已存在的组件不会重复安装。

   Set-ExecutionPolicy Bypass -Scope Process -Force
   .\scripts\dev-environment-setup.ps1

   复制

3. 3手动模式：放开权限

   若不用自动脚本，先允许 Selenium 内脚本运行，并写入注册表开启 Windows 开发者模式。

   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
   reg add "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock" /t REG_DWORD /f /v "AllowDevelopmentWithoutDevLicense" /d "1"

   复制

4. 4配置编译依赖

   装 MSYS2 并把其 bin 加入 PATH、bash.exe 路径写入 BAZEL_SH；装 Visual Studio 后设置 BAZEL_VC 与 BAZEL_VC_FULL_VERSION。

5. 5开启长路径支持

   Bazel 目录层级很深，需改注册表启用长路径、允许短文件名，并把 Bazel 输出根改到 C:/tmp 避免超限。

   reg add "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Command Processor" /t REG_DWORD /f /v "DisableUNCCheck" /d "1"
   reg add "HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem" /t REG_DWORD /f /v "LongPathsEnabled" /d "1"
   fsutil 8dot3name set 0

   复制

6. 6构建开发镜像

   可选：用 dev image 目录下的 Dockerfile 构建一个适合构建和测试 Selenium 的镜像，需在仓库根目录执行。

   docker build -f scripts/dev-image/Dockerfile -t selenium-dev .

   复制

7. 7装 Java 到本地

   Selenium 不用 Maven 构建，但可用 go 脚本把各模块部署到本地 Maven 仓库 ~/.m2/repository 供本地使用。

   ./go java:install

   复制

8. 8本地安装 Python 包

   先装 Python 依赖，再生成文件到源码树以便直接从 py 目录导入；也可构建 wheel 安装到 site-packages。

   pip install -r py/requirements_lock.txt
   ./go py:local_dev

   复制

关键配置

如何确认成功

在仓库根的 py 目录下执行 python -c "import selenium" 能成功导入，且 ./go 相关命令无报错退出，即表示本地开发环境可用。

常见问题

注意事项

• 本 README 面向贡献者，非普通用户的上手文档，使用场景请以官方 User Manual 为准。
• 自动安装脚本不会覆盖已存在的环境，遇到提示时按需选择。
• 所有 ./go 命令必须在克隆下来的 selenium 仓库根目录执行。
• 手动安装需要逐个设置 BAZEL_SH、BAZEL_VC、BAZEL_VC_FULL_VERSION 等环境变量，缺一不可。