VSCode 设置指南

配置通过 GitHub 账号同步（Settings Sync）。 Cmd+Shift+P → Settings Sync: Turn On → 登录 GitHub → 选择同步项即可。 同步内容：设置、快捷键、插件、代码片段、UI 状态。

一、主题配置

切换方式：Cmd+K Cmd+T（颜色主题）、Cmd+Shift+P → File Icon Theme。

二、已安装插件

✅ = 当前启用中 ⚠️ = 配置冲突或未使用

AI 工具

语言支持

Vim 模拟

neovim 路径：/opt/homebrew/bin/nvim（v0.12.2） 配置文件：~/.config/nvim/init.lua 自定义绑定：Space f o 切换文件浏览器，Space t t 切换终端

格式化 / 代码质量

Markdown

打开预览：Cmd+K V 或 Cmd+Shift+P → Markdown Preview Enhanced: Open Preview

图表工具

开发工具

主题（仅装了，未必启用）

语言包

三、常用快捷键（Mac）

面板 / 视图

文件操作

编辑

搜索 / 跳转

多光标 / 选择

代码智能

二、自定义快捷键

keybindings.json

~/.config/nvim/init.lua（neovim leader 键）

Space 键被 neovim 拦截，必须在 neovim 配置里定义，不能用 VSCode keybindings。 修改后需 Cmd+Shift+P → Reload Window 生效。

三、neovim 拦截的按键（VSCode 对应功能失效）

滚动

跳转

窗口 / 分屏

编辑

不被 neovim 拦截（VSCode 仍有效）

• Cmd+ 任意键（Mac 专属）
• Ctrl+c、Ctrl+z（系统级）
• F1~F12

四、gopls 配置备忘（settings.json）

Inlay Hints 正确写法

"gopls": {
  "ui.inlayhint.hints": {           // Hierarchy=ui.inlayhint, Name=hints
    "assignVariableTypes": true,    // 变量类型提示
    "compositeLiteralFields": true, // 结构体字段名提示
    "parameterNames": true          // 调用参数名提示
  }
}

❌ 错误写法（会报 Invalid settings）："ui.inlayHints.X" 或 "hints.X"

避免双重格式化

删除 go.formatTool / go.formatOnSave，由 [go] 块统一走 gopls+gofumpt：

"gopls": { "formatting.gofumpt": true },
"[go]": { "editor.defaultFormatter": "golang.go", "editor.formatOnSave": true }

五、相关配置文件路径