qmk_firmware/zh-cn/cli_tab_complete.md
2022-01-18 18:26:21 +00:00

33 lines
1.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# QMK Tab补全
<!---
original document: 0.15.12:docs/cli_tab_complete.md
git diff 0.15.12 HEAD -- docs/cli_tab_complete.md | cat
-->
在使用Bash 4.2及更高版本、Zsh或FiSH时可以启用QMK CLI的Tab补全功能可以实现对 `qmk` 参数中的开关、键盘、文件等参数的自动补全。
## 设置
有以下几种启用Tab补全的方法。
### 仅当前用户生效
将以下内容添加到文件 `.profile``.bashrc` 的末尾:
source ~/qmk_firmware/util/qmk_tab_complete.sh
若你的 `qmk_firmware` 存放在其它路径,以上路径也需要调整。
### 系统级的符号关联
若想让所有本地用户都可以实现Tab补全可以按如下方法添加符号连接到 `qmk_tab_complete.sh` 脚本:
`ln -s ~/qmk_firmware/util/qmk_tab_complete.sh /etc/profile.d/qmk_tab_complete.sh`
### 系统级的脚本拷贝
有时符号连接的方案无效可以改用拷贝文件到指定位置的方案。但须留意该Tab补全脚本可能会不定时更新你需要定期重新拷贝一次该脚本。
cp util/qmk_tab_complete.sh /etc/profile.d