homebrew cask安装的图形应用默认不直接放入/applications，需手动创建符号链接：sudo ln -sf "实际.app路径" "/applications/应用名.app"，链接指向caskroom中latest子目录下的.app，升级时自动生效。

homebrew 默认不把图形应用（如 vs code、docker desktop）直接放进 /applications，而是装在 /opt/homebrew/caskroom/（apple silicon）或 /usr/local/caskroom/（intel），再通过符号链接把可执行文件暴露到 /usr/local/bin 或 /opt/homebrew/bin。但 macos 的「访达」只认 /applications 里的 .app 包，所以要让 cask 安装的应用出现在「启动台」或「访达 → 应用程序」里，得手动创建指向 .app 的软链接。

确认 Cask 应用的实际安装路径

Homebrew Cask 把每个图形应用解压到自己的子目录中，结构类似：

• /opt/homebrew/Caskroom/visualstudiocode/latest/Visual Studio Code.app
• /opt/homebrew/Caskroom/docker/latest/Docker.app

你可以用这条命令快速查出某个应用的完整 .app 路径：

brew cask info visualstudiocode
ls -d /opt/homebrew/Caskroom/visualstudiocode/*/Visual\ Studio\ Code.app

创建指向 /Applications 的符号链接

终端执行以下命令（以 VS Code 为例）：

macos-suite-readonly

macOS 只读查询：Mail 未读、Calendar 日程、Notes 搜索、Stocks 行情（输出 JSON）。

下载

sudo ln -sf "/opt/homebrew/Caskroom/visualstudiocode/latest/Visual Studio Code.app" "/Applications/Visual Studio Code.app"

注意点：

• 必须用 sudo，因为 /Applications 是系统目录，普通用户无写入权限
• -sf 表示强制覆盖已存在的同名链接，避免报错
• 源路径（第一个参数）要用双引号包裹，防止空格（如 "Visual Studio Code.app"）导致命令中断
• 目标路径（第二个参数）也建议带 .app 后缀，确保 macOS 正确识别为应用

验证和后续维护

链接建好后：

• 打开「访达 → 应用程序」，能看到图标；右键「显示简介」里「位置」会显示实际路径
• 在终端运行 open -a "Visual Studio Code" 可正常启动
• 当 Homebrew 升级该应用（brew upgrade --cask visualstudiocode），latest 目录会自动切换到新版本，你不用重做链接——只要没删旧版，链接始终有效

如果某天发现图标打不开，先检查 ls -l /Applications/Visual\ Studio\ Code.app 看链接是否还指向有效的路径，再确认对应 Caskroom 子目录是否存在。