go wails doctor提示Required dependencies missing: libwebkit

zhuhezhang2026-01-23 17:33

复制代码

# Diagnosis
Required package(s) installation details: 
  - libgtk-3: sudo apt install libgtk-3-dev
  - libwebkit: sudo apt install libwebkit2gtk-4.0-dev
  - pkg-config: sudo apt install pkg-config

Optional package(s) installation details: 
  - docker: sudo apt install docker.io
  - nsis: sudo apt install nsis

 WARNING  Your system has missing dependencies!
Fatal:
Required dependencies missing: libwebkit

wails doctor诊断结果如上，此时根据提示需要先执行sudo apt install libgtk-3-dev安装 libgtk-3，紧接着执行第二行的sudo apt install libwebkit2gtk-4.0-dev时提示无法找到该软件包，此时若是你忽略该错误编译运行的话会提示

复制代码

Package webkit2gtk-4.1 was not found in the pkg-config search path.
Perhaps you should add the directory containing `webkit2gtk-4.1.pc'
to the PKG_CONFIG_PATH environment variable
Package 'webkit2gtk-4.1', required by 'virtual:world', not found
Package 'webkit2gtk-4.1', required by 'virtual:world', not found
Package 'webkit2gtk-4.1', required by 'virtual:world', not found
Package 'libsoup-3.0', required by 'virtual:world', not found
Package 'webkit2gtk-4.1', required by 'virtual:world', not found

Build error - exit status 1

其实替换成sudo apt install libwebkit2gtk-4.1-0，再udo apt install libwebkit2gtk-4.1-dev就可以了，不过此时你执行wails doctor仍会有如下提示

复制代码

# Diagnosis
Optional package(s) installation details: 
  - docker: sudo apt install docker.io
  - nsis: sudo apt install nsis

 WARNING  Your system has missing dependencies!
Fatal:
Required dependencies missing: libwebkit

不用理会，编译运行时在命令后面加 -tags webkit2_41即可，例如 wails dev -tags webkit2_41即可