# Autotools

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/clion/llms.txt).

在 CLion 中，您可以处理需要预配置步骤以准备实际 Makefile 的项目。 [GNU Autotools](https://www.gnu.org/software/automake/faq/autotools-faq.html)、 [K构建](https://www.kernel.org/doc/html/latest/kbuild/kbuild.html) 和 [PERL MakeMaker](https://perldoc.perl.org/ExtUtils::MakeMaker) 的脚本会被自动检测并执行，以获取 Makefile 并加载项目。 CLion 还支持 [xmkmf](https://www.x.org/releases/X11R7.7/doc/man/man1/xmkmf.1.xhtml) 工具，该工具从 [Imakefile](https://www.x.org/releases/X11R7.7/doc/man/man1/imake.1.xhtml) 模板生成 Makefile。

> **Tip:**
> 以下是针对 GNU Autotools 的一般说明。 有关 PERL MakeMaker 的其他提示，请参阅 [本节](#makemaker)。

## Autotools 项目

当您打开一个项目文件夹时，CLion 在以下情况下会将其识别为 Autotools 项目：

* 如果项目根目录下有 `configure.ac` 或 `configure.in` 文件，但不是同时存在。

* 如果项目根目录下有 `Makefile.in` 、 `Makefile.am` 或两者都有。

已经生成的  `Makefile`  或  `configure`  脚本的存在不会影响这一点。

## 预配置（GNU Autoconf）

如果您的系统上安装了 [GNU Autoconf](https://www.gnu.org/software/autoconf/)（  autoreconf  应位于系统  `PATH`  中），CLion 将首先调用它。

![使用 autoreconf 预配置项目](https://resources.jetbrains.com/help/img/idea/2026.3/cl_makefile_autoreconf.png)

> **Note:**
> 预配置会在每次项目 [重新加载](makefiles-support.html#manual-reload) 时执行。

默认情况下，CLion 使用以下命令来配置 Autotools 项目：

```CONSOLE
which autoreconf && autoreconf --install --force --verbose; /bin/sh configure

```

您可以根据需要 [更改](#preconf-settings) 这组命令（请参见下文）。

Procedure: 控制预配置参数

如果需要，您可以调整预配置命令。

1. 转到  `设置 | 构建、执行、部署 | Makefile` 。

2. 在   命令   字段中进行必要的更改：

![预配置命令](https://resources.jetbrains.com/help/img/idea/2026.3/cl_makefile_autotools_commands.png)

例如，要运行一个额外的预配置脚本，如  `bootstrap` ，添加以下命令：

```CONSOLE
./bootstrap <args>
```

还请注意默认命令集中的第一行，  `#!/bin/sh` 。 它明确指定了 POSIX 默认解释器  `/bin/sh` 。 您可以保持此命令不变，或者将其更改为使用其他解释器，例如  `#!/usr/bin/python`  用于 Python。

3. 您还可以在   构建目录   字段中或通过  `-C path`  标志在   构建选项   中更改构建目录。

更改构建目录时请注意以下事项：

* 之前的目录不会被删除。

* 如果新的构建目录不存在，CLion 会在预配置步骤之前创建它（如果脚本不为空）。 否则，该目录将不会被创建。

> **Note:**
> 如果您使用带有远程工具链（如 Docker、WSL 或 SSH）的预配置脚本，您应使用相对路径或完整的远程路径指向项目文件。 这是因为预配置脚本将在远程环境中运行。 如果您不想在每次更改工具链时更改预配置脚本，请使用相对路径。
>
>
>
> [使用 Docker 工具链时](clion-toolchains-in-docker.html#build-run-debug-docker)，项目文件夹默认挂载到容器中的  `/tmp`  文件夹。 因此，可以在  `/tmp/your-project-name`  访问项目文件。

Procedure: 更改工具链

* 执行 Autotools 脚本时，CLion 从  `设置 | 构建、执行、部署 | Makefile`  中指定的工具链获取编译器。

如果您第一次打开项目，CLion 将使用默认工具链。

请注意，您也可以在此处指定远程工具链。

![为 Makefile 项目选择工具链](https://resources.jetbrains.com/help/img/idea/2026.3/cl_makefile_autotools_toolchain.png)

## PERL MakeMaker 项目

MakeMaker 生成的 Makefile 没有单独的  `clean`  和  `distclean`  目标。 只有  `clean`  目标，它会清理项目树并删除  `Makefile`  本身。

因此，对于 MakeMaker 项目，  `make clean`  命令应仅作为 [预配置](#preconf-settings) 步骤的一部分运行。 CLion 使用以下预配置脚本，您可以根据需要随时 [调整](#toolchain-settings)：

```CONSOLE
#!/bin/sh
#
# ExtUtils::MakeMaker template, feel free to customize.
#
[ -f Makefile ] && "${MAKE:-make}" clean
perl Makefile.PL

```

> **Note:**
> 如果 MakeMaker 项目在预配置后被清理，  `Makefile`  将被删除，项目将无法加载，因此请确保执行以下操作：
>
>
>
> * 在 [打开](makefiles-support.html#open-prj) 项目时，通过清除相应的复选框跳过 清理 步骤： ![打开 Makefile 项目时跳过 Clean 步骤](https://resources.jetbrains.com/help/img/idea/2026.3/cl_makefiles_skip_clean.png)
>
> * 对于 [重新加载](makefiles-support.html#manual-reload) 项目，请使用 重新加载 Makefile 项目 而不是 清理并重新加载 Makefile 项目 。

## 远程模式限制

* 在远程模式下， `构建` 目录不会同步到本地机器。 请确保手动同步 `config.h` 。

远程上的 Windows 特定问题：

* 当项目上传到远程主机时，行尾不会转换为 UNIX (LF) 格式（ [CPP-26698](https://youtrack.jetbrains.com/issue/CPP-26698)）。

* 上传阶段可能会显示成功完成，但实际上没有文件传输到远程主机（ [CPP-26700](https://youtrack.jetbrains.com/issue/CPP-26700)）。

## See also

### 流程

[Makefile projects](makefiles-support.html)

