VS Code（Mac）命令行参数异常：执行命令时创建新文件而非执行命令

架构老林

2026-5-20

解决VS Code code -h/code -v 创建文件而非执行命令的问题

看起来你遇到的问题是因为zsh里对code命令的配置不正确，导致参数被当成文件名传递给VS Code，而不是让VS Code的CLI来处理这些参数。下面是具体的排查和解决步骤：

第一步：检查当前code命令的定义
在终端执行以下命令，看看code是别名、函数还是官方的CLI脚本：
```
type code
```
如果输出显示是别名（比如code is an alias for open -a "Visual Studio Code"）或者自定义函数，那这就是问题根源——这种写法会把-h/-v这类参数当作要打开的文件名，自然会创建新文件。
第二步：安装/恢复官方code CLI
首先确保你已经安装了VS Code官方提供的code命令：
1. 打开VS Code，按下Cmd+Shift+P打开命令面板
2. 搜索并执行Shell Command: Install 'code' command in PATH
  这个操作会在/usr/local/bin下创建一个指向VS Code CLI的符号链接，它能正确处理命令行参数。
第三步：清理冲突的zsh配置
打开你的~/.zshrc和~/.zprofile文件，查找所有和code相关的别名或函数定义，比如类似这样的行：
```
alias code='open -a "Visual Studio Code"'
```
删除这些自定义配置，保存文件后执行以下命令重新加载配置：
```
source ~/.zshrc
source ~/.zprofile
```
第四步：测试修复效果
现在在终端执行code -v或code -h，应该就能正常显示VS Code的版本信息或帮助文档，而不会再创建奇怪的文件了。