---
url: /zh/guide/package-management/using-system-packages.md
---
# 使用系统包 {#using-system-packages}

## 查找使用系统包

Xmake 对远程包和系统包的使用进行了统一，全部使用 `add_requires("zlib")` 接口来描述集成。默认配置下，它会优先从系统上查找库，如果没有，则会自动下载并安装集成。

如果我们只想查找并使用系统库，不想远程下载，可以这样配置：

```lua
add_requires("zlib", {system = true})

target("test")
    set_kind("binary")
    add_files("src/*.c")
    add_packages("zlib")
```

通过 `{system = true}` 就可以强制禁用远程下载，此时它就等价于 Xmake/CMake 的 `find_package`，但更简单易用，并且与远程包的使用方式完全一致。

默认情况下，如果找不到系统库，则会提示失败。如果这个包是可选的，可以额外配置 `{optional = true}` 选项。

```lua
add_requires("zlib", {system = true, optional = true})
```

## 查找包快速测试

我们可以使用下面的命令，快速检测系统上指定的包信息：

```sh
$ xmake l find_package x264
{
    links = {
      "x264"
    },
    linkdirs = {
      "/usr/local/Cellar/x264/r2699/lib"
    },
    version = "0.148.2699 a5e06b9",
    includedirs = {
      "/usr/local/Cellar/x264/r2699/include"
    }
}
```

我们也可以追加第三方包管理器前缀来测试：

```sh
xmake l find_package conan::OpenSSL/1.0.2g
```

::: tip 注意
find\_package 命令如果在带有 xmake.lua 的工程目录下执行，是会有缓存的。如果查找失败，下次查找也会使用缓存的结果。如果要每次强制重新检测，请切换到非工程目录下执行上述命令。
:::