GIT-LS-FILES(1) (NAME) git-ls-files - (SYNOPSIS) git ls-files [-z] [-t] [-v] [-f] [-c|--cached] [-d|--deleted] [-o|--others] [-i|--ignored] [-s|--stage] [-u|--unmerged] [-k|--killed] [-m|--modified] [--resolve-undo] [--directory [--no-empty-directory]] [--eol] [--deduplicate] [-x |--exclude=] [-X |--exclude-from=] [--exclude-per-directory=] [--exclude-standard] [--error-unmatch] [--with-tree=] [--full-name] [--recurse-submodules] [--abbrev[=]] [--format=] [--] [...] (DESCRIPTION) . . (OPTIONS) -c, --cached . ( -c/-s/-d/-o/-u/-k/-m/--resolve-undo .) -d, --deleted (unstaged deletion) -m, --modified ( ) -o, --others ( ) -i, --ignored (ignored) . -c -o . ( -c) . <<>> ( -o) . --exclude* . -s, --stage (mode bits) (stage) . --directory <<>> ( ) . -o/--others . --no-empty-directory . --directory . -u, --unmerged ( --stage --cached ). -k, --killed / . --resolve-undo resolve-undo resolve-undo . ( resolve-undo <> ) -z \0 . (OUTPUT) . --deduplicate (stage) --deleted --modified . -t --unmerged --stage . -x , --exclude= pattern . pattern (shell wildcard) . (EXCLUDE PATTERNS) . -X , --exclude-from= . --exclude-per-directory= . Porcelain --exclude-standard . --exclude-standard : .git/info/exclude .gitignore . --error-unmatch ( ). --with-tree= --error-unmatch ( ) . -s -u . -t . git- status(1) --porcelain git-diff-files(1) --name-status git-status(1) --short git-diff(1) --name-status . ( ). : H skip-worktree S skip-worktree M R C K / ? U resolve-undo -v -t assume unchanged ( git-update- index(1)). -f -t fsmonitor valid ( git-update- index(1)). --full-name . . --recurse-submodules ls-files . --cached --stage . --abbrev[=] . --abbrev= . --debug . . --eol . <> <> ( core.autocrlf ) . <<-text>> <> <> <> <> <<>> . <<>> . <<>> <<-text>> <> <> <> <> . . <> <> . (<>>) (<>>) (<>>) . --sparse (sparse) . <> <>. --format= %(fieldname) . %% % %xXX ( XX ) XX %x00 \0 (NUL) %x09 \t (TAB) %x0a \n (LF) . --format -s -o -k -t --resolve-undo --eol . -- . . . (OUTPUT) git ls-files --stage : [ ] git ls-files --eol : i/w/attr/ git ls-files --unmerged git ls-files --stage . mode/SHA-1 O A B . ( porcelain) . ( git-read-tree(1) ) -z <<>> core.quotePath ( git- config(1)). -z NUL . --format %(fieldname) . <> <> <<--format>> : git ls-files --format='%(objectname) %(path)' (FIELD NAMES) --format= %(fieldname) . <> : objectmode (mode) . objecttype (object type) . objectname ( ) . objectsize[:padded] ( commit tree <<->> ). () <<%(objectsize:padded)>> . stage (stage) . eolinfo:index, eolinfo:worktree ( --eol ) . eolattr ( --eol ) . path (pathname) . (EXCLUDE PATTERNS) git ls-files ( --others --ignored ) << >> . gitignore(5) . : 1. --exclude= . . 2. --exclude-from= . . 3. --exclude-per-directory= git ls-files .gitignore . . . --exclude --exclude-from . --exclude-per-directory . Porcelain --exclude-standard . --exclude-standard --exclude-per-directory=.gitignore : 1. core.excludesfile ( ) $XDG_CONFIG_HOME/git/ignore. 2. $GIT_COMMON_DIR/info/exclude. --exclude-from=. (SEE ALSO) git-read-tree(1) gitignore(5) (GIT) git(1) Git 2.55.0 2026-06-29 GIT-LS-FILES(1)