the_silver_searcher

C/C++ 2025-08-17

银牌搜索者

ack类似的代码搜索工具,重点是速度。

你知道c吗?想改善农业吗?我邀请你与我配对。

AG有什么好处?

  • 它的数量级比ack快。
  • 它忽略了您的.gitignore.hgignore的文件模式。
  • 如果您不想搜索源存储库中的文件,只需将其模式添加到.ignore文件中即可。 (*咳嗽*.min.js *咳嗽*)
  • 命令名称比ack短33%,所有密钥都在主排!

AG现在非常稳定。大多数更改是新功能,次要错误修复或性能改进。在我的基准中,它比ACK快得多:

 ack test_blah ~/code/  104.66s user 4.82s system 99% cpu 1:50.03 total

ag test_blah ~/code/  4.67s user 4.58s system 286% cpu 3.227 total

ACK和AG找到了相同的结果,但AG的速度快34倍(3.2秒比110秒)。我的~/code目录约为8GB。多亏了git/hg/忽略,AG仅搜索了700MB。

也有跨版本的性能图。

怎么这么快?

  • AG使用PTHreads并行利用多个CPU内核和搜索文件。
  • 文件是mmap() ed而不是读入缓冲区。
  • 文字弦搜索使用Boyer-Moore Strstr。
  • REGEX搜索使用PCRE的JIT编译器(如果使用PCRE> = 8.21构建AG)。
  • AG在每个文件上执行相同的正则拨号之前,请调用pcre_study()
  • 非regex模式没有在忽略文件中的每个模式上调用fnmatch() ,而是将其加载到数组和二进制中。

我写了几篇博客文章,展示了我如何提高性能。其中包括我添加pthreads的方式,编写了自己的scandir() ,对每个修订进行了基准测试以查找性能回归,并与Gprof和valgrind进行了介绍。

安装

macos

 brew install the_silver_searcher

或者

 port install the_silver_searcher

Linux

  • ubuntu> = 13.10(Saucy)或Debian> = 8(Jessie)

      apt-get install silversearcher-ag
    
  • Fedora 21及以下

      yum install the_silver_searcher
    
  • Fedora 22+

      dnf install the_silver_searcher
    
  • Rhel7+

      yum install epel-release.noarch the_silver_searcher
    
  • Gentoo

      emerge -a sys-apps/ the_silver_searcher
    
  •   pacman -S the_silver_searcher
    
  • Slackware

      sbopkg -i the_silver_searcher
    
  • Opensuse

      zypper install the_silver_searcher
    
  • Centos

      yum install the_silver_searcher
    
  • NIXOS/NIX/NIXPKGS

      nix-env -iA silver-searcher
    
  • Suse Linux Enterprise:遵循以下简单说明。

BSD

  • freebsd

      pkg install the_silver_searcher
    
  • OpenBSD/NetBSD

      pkg_add the_silver_searcher
    

视窗

  • Win32/64

    提供非官方的每日版本。

  • Winget

      winget install "The Silver Searcher"
    

    笔记:

    • 这安装了针对Windows优化的AG.EXE的版本。
    • Winget旨在成为Windows的默认包装管理器客户端。
      截至2020年6月,它仍在Beta中,可以使用其中的说明安装。
    • AG的Winget软件包中的设置脚本在第一个目录中安装AG.EXE,该目录与以下标准之一:
      1. 在先前的ag.exe的实例上,从路径中发现的相同来源
      2. 在环境中定义的目录中,变量bindir_%processor_architecture%
      3. 在环境变量bindir中定义的目录中
      4. 在环境变量中定义的目录中
  • 巧克力

      choco install ag
    
  • MSYS2

      pacman -S mingw-w64-{i686,x86_64}-ag
    
  • cygwin

    在“ UTILS”类别中运行相关setup-*.exe ,然后选择“ the_silver_searcher ”。

从来源建造

建筑大师

  1. 安装依赖项(Automake,PKG-Config,PCRE,LZMA):

    • macos:

        brew install automake pkg-config pcre xz
      

      或者

        port install automake pkgconfig pcre xz
      
    • Ubuntu/Debian:

        apt-get install -y automake pkg-config libpcre3-dev zlib1g-dev liblzma-dev
      
    • 软呢帽:

        yum -y install pkgconfig automake gcc zlib-devel pcre-devel xz-devel
      
    • Centos:

        yum -y groupinstall "Development Tools"
        yum -y install pcre-devel xz-devel zlib-devel
      
    • OpenSuse:

        zypper source-install --build-deps-only the_silver_searcher
      
    • Windows:很复杂。请参阅此Wiki页面。

  2. 运行构建脚本(刚刚运行aclocal,Automake等):

     ./build.sh
    

    在Windows上(MSYS/MINGW Shell内部):

     make -f Makefile.w32
    
  3. 进行安装:

     sudo make install
    

构建释放tarball

GPG签名版本可在此处找到。

建筑释放焦油需要相同的依赖项,除了汽车和PKG-Config。安装依赖项后,只需运行:

 ./configure
make
make install

您可能需要使用sudo或运行作为Make Install的根。

编辑整合

vim

您可以通过将以下行添加到.vimrc

 let g:ackprg = 'ag --nogroup --nocolor --column'

或者:

 let g:ackprg = 'ag --vimgrep'

具有相同的效果,但会在线上报告每场比赛。

emacs

您可以将AG.EL用作AG的Emacs前端。另请参阅:Helm-ag。

文字人

Textmate用户可以将AG与我的流行Ackmate插件一起使用,该插件使您可以同时使用ACK和AG进行搜索。如果您已经有了Ackmate,则只想用Ag替换ACK,移动或删除"~/Library/Application Support/TextMate/PlugIns/AckMate.tmplugin/Contents/Resources/ackmate_ack"并运行ln -s /usr/local/bin/ag "~/Library/Application Support/TextMate/PlugIns/AckMate.tmplugin/Contents/Resources/ackmate_ack"

您可能喜欢的其他东西

  • ACK-比GREP好。没有ACK,不存在AG。
  • ack.vim
  • CTAGS-比AG快,但事先构建了索引。非常适合真正的大型代码库。
  • git -grep-与Ag一样快,但仅在GIT存储库中起作用。
  • FZF-命令行模糊查找器
  • ripgrep
  • 麻袋 - 包裹ACK和AG的实用程序。它从搜索和打开匹配文件中删除了很多重复。
下载源码

通过命令行克隆项目:

git clone https://github.com/ggreer/the_silver_searcher.git