macOS Sonoma 14.2.1执行code .命令报错，求助排查遗漏点

• 确认VSCode自带的Shell命令是否安装
  打开VSCode，按下Cmd+Shift+P调出命令面板，搜索并执行Shell Command: Install 'code' command in PATH。执行完成后重启终端，再次尝试code .。这是VSCode官方提供的添加shell命令的方式，比手动修改PATH更可靠。

• 排查code命令的路径关联
  在终端执行which code，查看输出的路径：

  • 如果无任何输出，说明code命令未被添加到PATH中，回到上一步重新执行VSCode的Shell命令安装。
  • 如果输出路径指向dotnet相关文件而非VSCode的可执行文件，说明存在命令冲突，需要删除错误的链接或调整PATH顺序。

• 手动创建软链接
  如果VSCode的Shell命令安装失败，可手动创建软链接：

  1. 确认VSCode的实际可执行路径：/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code
  2. 在终端执行：

     sudo ln -s /Applications/Visual\ Studio\ Code.app/Contents/Resources/app/bin/code /usr/local/bin/code
     

  3. 输入系统密码后执行，重启终端再测试code .

• 检查PATH顺序是否存在冲突
  终端执行echo $PATH，查看输出中/usr/local/bin的位置：

  • 如果dotnet相关路径排在/usr/local/bin之前，系统会优先查找dotnet的code相关命令，导致冲突。
  • 可临时测试调整PATH顺序：PATH="/usr/local/bin:$PATH" code .，若能正常打开VSCode，需修改shell配置文件（如.zshrc或.bash_profile），将/usr/local/bin移到dotnet路径之前。

• 验证VSCode的权限设置
  右键点击/Applications/Visual Studio Code.app，选择「显示简介」，查看底部的权限面板，确保当前用户拥有读写权限。若权限不足，可添加当前用户并赋予读写权限，或重新安装VSCode（安装时避免使用sudo）。

内容的提问来源于stack exchange，提问作者Baldur Logi