Detailed explanation of Ag search tool parameters

ag Detailed explanation of search tool parameters

Ag Is similar to ack, grep Tools for , It is used to search for the corresponding keywords in the file .

Officials have listed several reasons for choosing it ：

• It is better than ack faster （ and grep Not on an order of magnitude ）
• It will ignore .gitignore and .hgignore The matching file in
• If there are files you want to ignore , You need to add them to .ignore In file
• It has shorter command names :-)

install

ubuntu Direct installation ：

sudo apt install silversearcher-ag

Basic use

ag The basic use of is very direct ： Follow the command with what you want to search character string that will do , It will search all text files in the current directory , And return the result .

ag Module

Output ：

You can see , The output will be clearly highlighted , and , It's really , Very fast .

.ignore The file name specified in the file will be skipped , No search . Just write in the file name you want to ignore ：

# .ignore
model.py
trainer.py

Detailed format and command options

Here are some ag Common parameter options and their meanings ：

Options	function
-s / -i / -S	Case sensitive / Insensitivity / Intelligent case determination （ Default ）, That is, case sensitivity is turned on when there is uppercase , Otherwise it's not sensitive
-c	count, Output several matching strings in each file
-A / -B / -C [NUM]	after / before / context, Show matching to string [ after / front / Before and after ] NUM That's ok , Default 2 That's ok
-a	Search all files , Include .ignore Ignored files , Don't include hidden files
-D	Output ridiculous amounts of debugging info. Not useful unless you´re actually debugging. （ This sentence is the original manual , laugh ）
-f	Track soft links , The default is not to track
-g [PATTERN]	Output match PATTERN The name of the file
-G [PATTERN]	Only search for file name matches PATTERN File contents of
-l / -L	Only output can / The contents cannot match the file name of the successful file , Do not output line content
-m [NUM]	Only before output NUM The content of the second successful match , Skip the rest , The default is 0, That is, all outputs
-r / -n	yes / No, enter the directory for recursive search , Recursive search will be performed by default
-o	Only the part of the line that matches successfully
-p [PATH]	Provide the specified .ignore Path to file , Default to current directory
-Q	Will not PATTERN Parse according to regular expressions
-u	Search all files , Including binary files , But I still ignore .ignore Wait for the documents
-U	Ignore VCS ignore file （ Include .gitignore, .hgignore）, But I will still consider .ignore, The content of the first two will be searched , however .ignore The content in will still be ignored
-w	Match only the whole word
-V	Output version information
-v	Match all lines that do not contain the specified string
z	Search the contents of the compressed file

Other options ：

Options	function
--ackmate	By AckMate Output results in parsed format
--hidden	Search for hidden files , But it will not search for ignored files , I.e -a contrary
--depth [NUM]	Search directory depth ,-1 For unlimited , The default is 25
--ignore PATTERN	Ignore name matching to PATTERN Contents of files or directories , I.e -G contrary
--[no]break	Whether there are blank lines between different files of search results , Default blank line
--[no]color	Whether there is color highlight , The default is
--column	Output column number

This is basically all , There are also some parameters that are not very commonly used , All option parameters can man ag Check it out. .