SuperAPI AI 工具集

editor-setup

编程与开发

查看项目

更新于 10-16 03:14

技能介绍

用途:在 macOS 上安装代码编辑器、让命令行启动器可用,并应用一份小而稳妥的 settings 基线。默认组合是 VS Code(生态最大)与 Cursor(AI 优先的 fork,安装时会导入 VS Code 设置,从而保持同步),Zed(快速原生)按需安装;只想要其中一个时可跳过另一半。不适用:终端模拟器(Ghostty/iTerm2/Warp)归 mac-dev-apps;JetBrains IDE 通过 mac-dev-apps 安装 jetbrains-toolbox cask 后在其中管理;Neovim 配置不在范围内;项目级 linter/formatter/LSP 问题属项目工作;EDITOR/git editor 变量归 zsh-setup 或 git-ssh-identity。

主要能力与用法:安装命令为 brew install --cask visual-studio-code cursor(zed 按需)。cask 会把 code 与 cursor 链接到 brew 的 bin,需在新 shell 中用 --version 验证;若缺失(如 .dmg 安装),用命令面板(⇧⌘P)执行“Shell Command: Install 'code' command in PATH”,Cursor 内同样;Zed 用其自身的面板命令安装 zed。设置基线必须合并而非整体替换:先备份 cp settings.json settings.json.bak.$(date +%Y%m%d%H%M%S),路径为 ~/Library/Application Support/Code/User/settings.json。前三个键会在保存时改写源文件,需与用户确认,并对 Markdown 豁免行尾空格(应为硬换行),如 [markdown] 下 files.trimTrailingWhitespace 为 false;不强制全局统一格式化器,按语言设置。扩展仅安装用户确认的,如 editorconfig、gitlens、remote-ssh、docker,并按实际语言装官方扩展,用 Brewfile 的 vscode "publisher.ext" 记录。跨机同步二选一:Settings Sync 手动登录,或把 settings.json 放进 dotfiles 仓库。Cursor 首次启动可导入 VS Code 设置与扩展(应放在基线合并之后),设置位于 ~/Library/Application Support/Cursor/User/settings.json,扩展用 cursor --install-extension,AI 功能需手动登录账号。Zed 设置是 ~/.config/zed/settings.json,键不同,不能照抄 VS Code。

验证与限制:新 shell 中 code --version;code --list-extensions 与确认集合一致;打开临时 JSON 文件加空白后保存,应自动格式化。完成标准为编辑器已装、CLI 在新 shell 可用、基线已合并且旧设置已备份、确认的扩展已装、同步机制已选定或明确跳过。注意两套同步机制会互相覆盖,只能选一;某些环境下 code 仅安装终端可用;settings.json 含注释时用文本编辑而非 jq;Cursor 与 VS Code 会争抢文件类型默认打开关联;Electron 编辑器自行更新,brew upgrade 会跳过。