CLion 中的 Makefile 项目：现已公开！

Lei

Read this post in other languages:
한국어

• 后台工作原理是什么?
• 如何在 CLion 中开始使用 Makefile 项目？
• 如果出现问题而项目无法正确加载，该怎么办？
• 有哪些已知问题和局限性？

我们的实现方法

1. 编译包装器用于包装实际的编译器调用，然后执行完整的构建并提取项目信息。
2. 在执行任何构建过程之前，将使用 LD_PRELOAD 环境变量并加载特定的动态库，以拦截编译器调用并收集项目信息。
3. 解析 make 命令的输出，通常与 --just-print 选项一起使用以避免实际构建。

• 它不会影响构建过程。
• 与完整的项目构建相比，它使我们可以更快地收集信息。
• 这将是一个“便携式”选项，因为 IDE 理论上可以从记录在另一台计算机上的 Make 输出开始。

如何在 CLion 中开始使用 Makefile 项目

1. 在项目中选择文件 | 打开（File | Open）。
2. 您可以将文件夹作为项目打开，CLion 将搜索顶级 Makefile（以及 CMakeList.txt 或 compile_commands.json 文件）并建议将其作为项目打开。
   或者在 Open 对话框中直接将 CLion 指向 Makefile。
3. CLion 可能会要求您清理项目。
   这是必需的，因为 Make 构建是增量的，在未清理的项目上运行时，只会编译更新的文件，因此重新加载项目将无法正常进行并会丢失所有未更改的文件。
4. CLion 现在将尝试加载项目。
5. 成功加载项目后，您可以在 CLion 中开始使用它，并从其提供的所有智能 IDE 功能中受益。

1. 用于加载 Makefile 项目的工具链。
   支持所有本地工具链（Clang、GCC、MinGW、Cygwin、WSL）。
   Visual Studio 工具链依赖于 NMake，当前不支持该工具，但是如果您使用 GNU Make 构建项目，将可以在 CLion 中使用。
   远程模式尚未包括在内。
2. 用于在 CLion 中调用 make 命令以提取项目信息的参数。
3. 在 CLion 中与 make 命令一起使用 Build 和 Clean Make 目标以提取项目信息。
   对于 Build，空字段表示 CLion 将采用项目的 Makefile 中指定的第一个目标。

并且如果CLion无法找到您的 Make 目标，则可以创建 Make 类型的自定义构建目标并在配置中使用它：

如果出现问题而项目无法正确加载，该怎么办？

1. 在设置/偏好 | 构建、执行、部署 | Makefile 设置 ( Settings/Preferences | Build, Execution, Deployment | Makefile settings)中检查您正在使用的工具链：
   您应该能够在所选环境中构建项目。
2. 在设置/偏好 | 构建、执行、部署 | Makefile 设置 ( Settings/Preferences | Build, Execution, Deployment | Makefile settings)中检查重新加载参数和构建目标。
   大多数成功运行的项目都可以使用默认参数，但您可能需要在这种情况下进行一些更改。
3. 尝试工具 | Makefile | 清理并重新加载 Makefile 项目（Tools | Makefile | Clean and Reload Makefile Project）。
4. 如果上述步骤无济于事，请尝试从系统目录中的 /makefiles中清理项目。
   例如，我的 macOS 上的 postgres 项目可以在~/Library/Caches/JetBrains/CLion2020.2/makefiles/postgres.dc29ef09中找到。
   清理后请重新加载项目。
5. 最后，如果以上所有提示对您都不起作用，请转到帮助 | 诊断工具 | 调试日志设置…（Help | Diagnostic Tools | Debug Log Settings… ），并通过添加com.jetbrains.cidr.cpp.makefile 来打开调试日志，
   然后重现问题并将日志提交给我们的跟踪器或支持。

已知问题和局限性

• 项目禁止打印目录。
  因此，该算法无法正确检测正在构建的源文件。
• 编译器未知，或者无法正确提取编译标志。
  诸如 libtool 之类的各种包装器都会通过隐藏编译标志并干扰 Make 的输出（CPP-19549，CPP-19305）而产生更多问题。

• Makefile 支持插件：该插件提供代码高亮显示功能以及对构建 make 项目的一些支持。
  计划是重新设计并将其捆绑到 CLion（CPP-16933）中。
• 稍后将为 Makefile 项目启用单元测试集成（CPP-20718）。
• 添加将 Makefile 链接到现有项目的功能（CPP-20733）。
• 更改工具链或影响项目加载的其他设置应触发重新加载（CPP-18982）。
• 为了扩展对 GNU Autotool 项目的支持，允许用户为 Makefile 项目（CPP-16924）设置”预配置”步骤。
• 支持非 GNU Makes（NMake、BSD）（CPP-18723）。
• 用编译包装器实现该方法，并使它与当前的包装器结合使用。