在 ~/.zshrc 中添加 alias 并执行 source ~/.zshrc 即可生效；推荐集中放在文件靠后、加注释说明；语法为 alias 名字='命令'，等号无空格、值需引号；避免覆盖系统命令，建议小写命名；可拆分至 ~/.zsh_aliases 独立管理；用 alias gs 或 alias 验证是否生效。
直接在 ~/.zshrc 文件里添加 alias 行，保存后运行 source ~/.zshrc 就能生效。关键不是“怎么写”，而是怎么组织得顺手、不冲突、好维护。
在哪改：定位并编辑 .zshrc 文件
这是 zsh 的主配置文件，所有别名、插件、主题都从这里加载。
- 用命令打开：
vim ~/.zshrc（或用code ~/.zshrc用 VS Code 编辑） - 推荐把别名集中放在文件靠后位置，比如在
plugins=(...)下方另起一段，加个注释说明：# ? 自定义别名 - 改完必须执行
source ~/.zshrc才能让新别名立刻可用，否则新开终端才生效
怎么写：语法简单，但要注意命名和覆盖
格式固定：alias 名字='实际命令'，等号前后**不能有空格**，值要用单引号或双引号包住。
- 基础示例：
alias ll='ls -la'、alias ...='cd ../..' - 带参数的命令建议用函数替代，比如想让
gs等价于git status -s，直接写alias gs='git status -s'就行 - 避免覆盖系统命令：比如不要写
alias ls='ls --color=auto'（macOS 默认已带颜色），更不要写alias cd='echo haha'—— 这会彻底废掉cd - 大小写敏感：建议全小写 + 短横线，如
alias ncu='npm-check-updates'，避免Alias或NCU这类写法
怎么管：分组管理 + 按需加载
别名一多就难维护，可以按用途分类，甚至拆到独立文件里。
- 在
~/.zshrc末尾加一行：[[ -f ~/.zsh_aliases ]] && source ~/.zsh_aliases - 然后新建
~/.zsh_aliases，专门放所有别名，结构清晰也方便备份 - 常用分组参考：
• 开发类：alias be='bundle exec'、alias py='python3'
• 日常类：alias q='exit'、alias c='clear'
• 路径类：alias desk='cd ~/Desktop'、alias proj='cd ~/Projects'
怎么验：快速确认是否生效
别靠猜，用终端自己验证最准。
- 查某个别名是否已定义：
alias gs（显示gs='git status -s'就对了） - 看所有别名：
alias（不带参数，会列出全部） - 测试执行效果：比如输
ll，应该等价于ls -la，输出带隐藏文件的详细列表 - 如果提示
command not found，先检查拼写、引号、等号空格，再确认是否漏了source
