update

Author: adoyle-h

.editorconfig

@@ -8,7 +8,7 @@ end_of_line = lf
 trim_trailing_whitespace = true
 insert_final_newline = true
 
-[{build,*.js}]
+[*.{js,mjs}]
 indent_size = 4
 ; this option just works with prettier, not implemented with editorconfig
 max_line_length = 100

others/complex-and-small-bug-with-cd.md

@@ -0,0 +1,99 @@
+# 一个复杂的小 bug: cd 补全问题
+
+如果你同时在使用 [fnm](https://github.com/Schniz/fnm)，[bash-completion](https://github.com/scop/bash-completion), bash-it 的 [aliases.completion.bash](https://github.com/Bash-it/bash-it/blob/master/completion/available/aliases.completion.bash) 这三个工具，你会遇到一个 BUG。
+
+## BUG 描述
+
+使用 cd 按 Tab 补全路径时，每个路径都会额外加上一个空格。
+
+比如 `cd /<Tab>` 然后选中 /usr，补全后变成 `cd /usr <光标位置>`。但正常期望的应该是 `cd /usr<光标位置>`。
+
+## 复现问题
+
+省略，懒得写。
+
+## 排错关键
+
+当同时使用 fnm, bash-completion, bash-it 的 aliases.completion.bash：
+
+```sh
+> complete -p cd
+complete -F _comp_complete_minimal cd
+
+> alias cd
+alias cd='__fnmcd'
+
+> complete -p __fnmcd
+complete -F _comp_complete_minimal __fnmcd
+```
+
+当同时开启 bash-completion 和 bash-it 的 aliases.completion.bash，不使用 fnm：
+
+```sh
+> complete -p cd
+complete -o nospace -F _comp_cmd_cd cd
+
+> alias cd
+-bash: alias: cd: not found
+
+> complete -p __fnmcd
+-bash: complete: __fnmcd: no completion specification
+```
+
+当同时开启 bash-completion 和 fnm，不使用 bash-it 的 aliases.completion.bash：
+
+```sh
+> complete -p cd
+-bash: complete: cd: no completion specification
+
+> alias cd
+alias cd='__fnmcd'
+
+> complete -p __fnmcd
+-bash: complete: __fnmcd: no completion specification
+```
+
+当同时开启 bash-it 的 aliases.completion.bash 和 bash-completion, fnm，不使用 bash-completion：
+
+```sh
+> complete -p cd
+-bash: complete: cd: no completion specification
+
+> alias cd
+alias cd='__fnmcd'
+
+> complete -p __fnmcd
+-bash: complete: __fnmcd: no completion specification
+```
+
+## 原因分析
+
+根因不在 bash-completion 也不在 bash-it，而在于 fnm 的 `--use_on_cd` 参数。
+
+fnm 的[初始化](https://github.com/Schniz/fnm#bash)这么写：`eval "$(fnm env --use-on-cd --shell bash)"`
+
+然而在 [`fn use_on_cd`](https://github.com/Schniz/fnm/blob/1a58394b53c918fa130e22116056f7b4f8e4997c/src/shell/bash.rs) 可以看到这段。
+
+```sh
+__fnmcd() {{
+    \cd "$@" || return $?
+    __fnm_use_if_file_found
+}}
+
+alias cd=__fnmcd
+__fnm_use_if_file_found
+```
+
+`_comp_complete_minimal` 是 bash-completion 源码里定义的。
+
+由于 `alias cd='__fnmcd'` 的存在，aliases.completion.bash 会把 cd 的补全函数用 __fnmcd 的补全函数代替。
+
+而 aliases.completion.bash 也会给 __fnmcd 添加一个 `complete -F _comp_complete_minimal __fnmcd`
+
+这就导致了 `complete -F _comp_complete_minimal cd`。
+
+## 解决办法
+
+不要用 --use-on-cd 参数。这功能只是在 cd 目录时自动查找是否存在 .node-version 或 .nvmrc 文件，自动切换 node 版本用的。
+
+`eval "$(fnm env --shell bash)"`

others/curl-fail-fast.md

@@ -0,0 +1,15 @@
+# curl 快速失败
+
+`curl -f` 有助于快速判断错误。如果不加 `-f` 参数，curl 执行后的 exit code 永远都是 0。这在编写 shell 脚本时可能会引发问题。
+
+比如请求错误的链接地址时，
+
+`curl -Lo docker.bash https://raw.githubusercontent.com/docker/cli/no-master/contrib/completion/bash/docker`
+
+curl 命令执行成功。得到的 docker.bash 的文件内容是 `404: Not Found`。
+
+`curl -fLo docker.bash https://raw.githubusercontent.com/docker/cli/no-master/contrib/completion/bash/docker`
+
+curl 命令执行失败。并且会打印 `curl: (56) The requested URL returned error: 404`，并且 exit code 会是 56。
+
+加上 `-f` 参数，curl 会识别 http response header 的状态码。

others/editorconfig.md

@@ -0,0 +1,19 @@
+# editorconfig
+
+## 易错的文件匹配
+
+- ❌ `[/file]` 不能用 `/` 开头
+- ✅ `[file]` `[./file]`
+
+- ❌ `[abc,*.sh]` 多文件必须要有 `{}`
+- ✅ `[{abc,*.sh}]` `[{*.sh,abc}]` 可以正常使用
+- ❌ `[{*.sh,abc/}]` `[{*.sh,abc/*}]`, `*.sh` 的匹配会失效，这应该是个 bug
+- ✅ `[{**/*.sh,abc/}]` `[{**/*.sh,abc/*}]`, 可以正常使用
+
+- `[*.lua]`，`[*.{lua}]`，`[**/*.lua]` 都会递归匹配所有目录下的 `*.lua`
+- `[./*.lua]` 不会递归匹配，只匹配根目录下的 `*.lua`
+- `[*/*.lua]` 只匹配一层目录下 `*.lua`，不匹配二层及以下子目录的 `*.lua`
+
+- ❌ `folder` `folder/` 不会对 `folder/` 目录下的文件生效
+- ✅ `folder/*` 只匹配一层目录下的文件，不匹配二层及以下子目录的文件
+- ✅ `folder/**` 递归匹配所有文件

shell/bash-tricks.md

@@ -353,3 +353,12 @@ https://superuser.com/a/1348950/1776434
 ## [ ] 与 [[ ]] 的区别
 
 https://stackoverflow.com/a/3427931/4622308
+
+## `${var+x}` 和 `${var:+x}` 的区别
+
+`${var+x}` 和 `${var:+x}` 是 Bash 中的两种不同的参数扩展方式，它们的行为略有不同：
+
+- **`${var+x}`** 只要 `var` 被设置（无论是否为空），都会返回 `x`。
+- **`${var:+x}`** 只有当 `var` 被设置且不为空时，才会返回 `x`；否则返回空。
+
+两者主要用于不同的场景：`${var+x}` 用于检测变量是否被设置，而 `${var:+x}` 用于检测变量是否既被设置又有值。

shell/printf-array.md

@@ -1,4 +1,6 @@
-# `printf '%s\n' $@` 为何可以打印多行？
+# printf 打印多行
+
+## `printf '%s\n' $@` 为何可以打印多行？
 
 比如 `f() { printf '%s\n' $@; }`，当执行 `f 1 2 3` 时会分行打印 1 2 3。
 
@@ -12,3 +14,9 @@
 
 - https://pubs.opengroup.org/onlinepubs/9699919799/utilities/printf.html
 - https://stackoverflow.com/a/39690101/4622308
+
+## printf -- '\n' 打印多行
+
+`printf 'a\nb\nc\n'` 可以打印多行。但当字符串以 `-` 开头，比如 `printf '-a\n-b\n--c\n'`，就会报错“无效的选项”。
+
+应当写 `printf -- '-a\n-b\n--c\n'`。