通配符与 Glob 匹配：与正则的分野与落地

正则：匹配"任意文本内容"（正则表达式 → 字符串任意位置）
Glob：匹配"文件名/路径结构"（模式 → 整条路径）

- 语义锚定：glob 天然"匹配整条路径"，正则默认子串匹配（要 ^ $ 包）
- 路径感知：glob 能区分"/"与文件片段，正则没有路径概念
- 可读性：*.md 比 ^.*\.md$ 直观得多

*.md        # 只匹配当前目录的 .md（不匹配 sub/x.md）

# Shell 展开
echo *.md             # 展开成匹配到的文件列表
ls src/*.ts

[abc]        → a 或 b 或 c
[a-z]        → 小写字母
[0-9]        → 数字
[!a-z]       → 非小写字母
[[]          → 字面量 [

find . -name "*.md"     # find 自己匹配（引号防止 shell 展开）
ls *.md                 # shell 展开后再传给 ls

import re, fnmatch

pattern = "a*"
# 正则：匹配"含 a 后跟任意"的子串
print(re.match("a*", "baaaa"))      # 匹配空（开头没有 a）
print(bool(re.search("a*", "baaaa")) )  # 匹配到子串 "aaaa"

# glob：匹配"整个名字以 a 开头"
print(fnmatch.fnmatch("baaaa", "a*"))   # False
print(fnmatch.fnmatch("apple", "a*"))   # True

import fnmatch
print(fnmatch.translate("*.md"))
# '(?s:.*\\.md)\\Z'  ← 实现上锚定到末尾

src/**/*.ts          → src/a.ts、src/ui/button.ts、src/ui/x/y.ts
**/*.md              → 任意层级的 .md
src/**/test.ts       → src/test.ts、src/ui/test.ts

- Python glob：`**` 只在 recursive=True 时生效
- Node fast-glob/minimatch：`**` 默认生效
- Shell：`**` 需 shopt -s globstar（bash）
- gitignore：`**` 有特殊规则（见下节）

shopt -s globstar     # bash 开启递归通配
echo **/*.md          # 递归列出 md

import glob
glob.glob("src/**/*.ts", recursive=True)   # Python 要显式 recursive

node_modules/      → 匹配任意层级的 node_modules 目录（末尾 / 限定目录）
*.log              → 任意层级的 .log 文件（* 不跨 / 但模式可出现在任意位置）
/build/            → 仅根目录的 build
a/b               → 仅根下 a/b（无前导 / 的含斜杠模式锚定到根）

1. 尾斜杠 = 只匹配目录
2. 无斜杠模式 = 任意层级（*.log 匹配 a/b.log）
3. 含斜杠模式 = 相对根（build/ 只匹配根 build/）
4. 通配符里的 * 不匹配 /，但 ** 可以跨层级

!important.log    → 重新包含被忽略的
*.log
!important.log    → 忽略所有 .log 但保留 important.log
# 注意：无法重新包含父目录被忽略的文件

git check-ignore -v path/to/file    # 看哪条规则命中
git status --ignored                 # 查看被忽略清单

import glob
glob.glob("*.py")                     # 当前目录
glob.glob("src/**/*.py", recursive=True)  # 递归
glob.glob("[a-c]*.py")                # 集合
# 返回按实现排序的实际文件路径

import fnmatch
fnmatch.fnmatch("report2026.md", "report*.md")   # True
fnmatch.filter(files, "*.md")                    # 过滤列表
# 注意：fnmatch 处理的是"名字"，不含路径语义（* 会跨 / ！）

import fg from "fast-glob";
const files = await fg("src/**/*.ts", { onlyFiles: true, ignore: ["**/*.spec.ts"] });

// minimatch（单名字匹配，语义接近 fnmatch）
import mm from "minimatch";
mm("src/ui.ts", "src/*.ts");          // true

ls *.md; echo src/**/*.ts   # globstar 才递归
find . -name "*.md" -type f # find 自身匹配

echo {a,b,c}.md        # a.md b.md c.md
cp src/{index,main}.ts dest/
echo {1..5}.txt        # 1.txt ... 5.txt
# brace 展开发生在通配之前：{a,b}.md → a.md b.md 再分别匹配

shopt -s extglob
@(a|b).md        # 恰好 a 或 b
+(a|b).md        # 一个或多个
*(a|b).md        # 零个或多个
?(a|b).md        # 零或一个
!(a|b).md        # 非 a 也非 b

@(a|b)   ≈  (?:a|b)
+(x)     ≈  x+
*(x)     ≈  x*
?(x)     ≈  x?
!(x)     ≈  负向前瞻

echo *.md            # 不匹配 .foo.md
echo .*              # 匹配隐藏文件（但也会匹配 . 和 ..）
# Python glob 也不匹配隐藏文件，除非显式 .*

src/**/*.ts 与 src/*.ts 重叠 → 用 ignore 去重（fast-glob 的 ignore）
排除构建产物：src/**/!(*.spec).ts

递归 glob 要遍历全目录树 → 大仓库（node_modules/万级文件）耗时秒级
优化：限定深度（/*/*.ts）、用 ignore 剪枝（fast-glob 的 ignore 会跳目录）、只 files/只 dirs
避免：把整个仓库 **/* 再 filter

# 陷阱：recursive glob 会遍历整个树
for f in glob.glob("**/*", recursive=True):   # 百万文件 → 慢
    if f.endswith(".py"): ...

# 优化：直接用有剪枝的库或限制深度

□ 以为 * 匹配隐藏文件 → 漏掉 .env/.gitignore 类配置
□ 以为 ** 在 Python 默认开启 → recursive=True 忘传
□ 大目录递归没 ignore 剪枝 → 扫描卡死

□ 路径语义明确：*.md 到底想匹配"当前目录"还是"任意层级"？
  明确就写 ./*.md（仅当前）或 **/*.md（任意）
□ 目录用尾斜杠：dist/ 表示目录本身及内容
□ 排除用 ! 且放在忽略规则之后
□ 用 .md 而非 .MD（跨平台大小写？gitignore 默认敏感）
□ 别用脆弱模式：src/**/* 在很多实现里匹配"目录本身"

// tsconfig.json include 用相对、明确
"include": ["src/**/*.ts", "vite.config.ts"],
"exclude": ["dist", "node_modules", "**/*.spec.ts"]

git check-ignore -v dist/index.html   # gitignore 命中检查
# 用 dry-run 工具模拟 glob（fast-glob/fnmatch）验证配置