忍者：一个注重速度的小型构建系统

忍者：一个注重速度的小型构建系统
Ninja is a small build system with a focus on speed

原始链接: https://github.com/ninja-build/ninja

## Ninja：一个快速构建系统 - 摘要 Ninja 是一个轻量级且**快速的构建系统**，专为速度而设计。它是一个单独的可执行文件——无需严格安装，只需下载二进制文件即可！可以通过复制 `misc/` 目录中的文件来获得诸如 shell 补全和编辑器集成等可选功能。你可以使用 Python 生成器 (`./configure.py --bootstrap`) 或 CMake 构建 Ninja 本身。支持使用 GoogleTest 进行测试；在构建期间指定其位置。文档使用 AsciiDoc 和 Doxygen 生成。要创建手册，请运行 `./configure.py ninja manual`（需要 AsciiDoc 和 xsltproc）。也可以使用 dblatext 创建 PDF 版本。可以使用 `./configure.py ninja doxygen` 构建 Doxygen 文档。重要的是，Ninja 是一个独立的*可执行文件*，而不是一个库，并且缺乏公共 API。更多详细信息和贡献指南可在项目的手册和 `CONTRIBUTING.md` 文件中找到。

## Ninja 构建系统：摘要 Ninja 是一个快速的构建系统，正日益流行，尤其是在 Chrome、Postgres 和 Gnome 等项目中。用户称赞它的简单性和速度，通常将其与 Make 和 CMake 相比。一个关键优势是它基于静态构建图高效地并行执行任务。讨论强调了 Ninja 易于集成——它可以由 Python 等工具生成（使用 `ninja_syntax.py`），也可以作为 CMake 和 Meson 等其他构建系统的后端使用。然而，它依赖于文件修改时间（mtime）来进行增量构建，这是一个已知的限制，当文件被移动或重命名但 mtime 未更新时，可能会导致不必要的重建。Ninja 的作者已经通过一个较新的系统 n2 来解决这个问题，该系统利用内容哈希。目前的一个问题是 PyPI 上的软件包过时（版本 1.13.0），导致 Windows 上的构建问题，尽管已经有修复程序可用。除了技术方面，用户还欣赏 Ninja 的“做好一件事”的理念，以及人工智能在自动化构建系统配置中日益增长的作用。

原文

Ninja is a small build system with a focus on speed. https://ninja-build.org/

See the manual or doc/manual.asciidoc included in the distribution for background and more details.

Binaries for Linux, Mac and Windows are available on GitHub. Run ./ninja -h for Ninja help.

Installation is not necessary because the only required file is the resulting ninja binary. However, to enable features like Bash completion and Emacs and Vim editing modes, some files in misc/ must be copied to appropriate locations.

If you're interested in making changes to Ninja, read CONTRIBUTING.md first.

You can either build Ninja via the custom generator script written in Python or via CMake. For more details see the wiki.

./configure.py --bootstrap

This will generate the ninja binary and a build.ninja file you can now use to build Ninja with itself.

If you have a GoogleTest source directory, you can build the tests by passing its path with --gtest-source-dir=PATH option, or the GTEST_SOURCE_DIR environment variable, e.g.:

./configure.py --bootstrap --gtest-source-dir=/path/to/googletest
./ninja all     # build ninja_test and other auxiliary binaries
./ninja_test    # run the unit-test suite.

Use the CMake build below if you want to use a preinstalled binary version of the library.

To build the ninja binary without building the unit tests, disable test building by setting BUILD_TESTING to OFF:

cmake -Bbuild-cmake -DBUILD_TESTING=OFF
cmake --build build-cmake

The ninja binary will now be inside the build-cmake directory (you can choose any other name you like).

To run the unit tests, omit the -DBUILD_TESTING=OFF option, and after building, run:

You must have asciidoc and xsltproc in your PATH, then do:

./configure.py
ninja manual doc/manual.html

Which will generate doc/manual.html.

To generate the PDF version of the manual, you must have dblatext in your PATH then do:

./configure.py    # only if you didn't do it previously.
ninja doc/manual.pdf

Which will generate doc/manual.pdf.

If you have doxygen installed, you can build documentation extracted from C++ declarations and comments to help you navigate the code. Note that Ninja is a standalone executable, not a library, so there is no public API, all details exposed here are internal.

./configure.py   # if needed
ninja doxygen

Then open doc/doxygen/html/index.html in a browser to look at it.

忍者：一个注重速度的小型构建系统 Ninja is a small build system with a focus on speed

忍者：一个注重速度的小型构建系统
Ninja is a small build system with a focus on speed