企业官网建设流程全解析

Neovim Vue 配置完整指南：nvim-lspconfig 中三步搭好 vue_ls + vtsls 双服务器

【免费下载链接】nvim-lspconfigQuickstart configs for Nvim LSP项目地址: https://gitcode.com/GitHub_Trending/nv/nvim-lspconfig

在 Neovim 里打开.vue文件，光标停在<script>里却毫无补全，这是文件格式和语言服务器不匹配的典型信号：Vue 单文件组件一半是 TypeScript、一半是模板，单个服务器覆盖不了全部。nvim-lspconfig 现在的做法是两个服务器分工协作——官方vue_ls负责模板与样式部分，vtsls负责 TypeScript 部分。本文从这个分工讲起，给你一套能直接落地的三步配置。

一个 vue_ls 为什么不够：v3.0.0 改了什么

当前版本的 Vue 支持由vue_ls承担，不再依赖早期教程里的 volar。仓库里的 volar.lua 已简化成一行转发代码加一条弃用提示：老配置里写的vim.lsp.enable('volar')仍能运行，但每次都会触发弃用警告，建议直接改写成新名字。

真正的变化在语言服务器本体：自 v3.0.0 起，Vue 语言服务器移除了 takeover mode。过去一个服务器可以"接管".vue文件的全部语言功能；现在它固定运行在 hybrid mode，只管 HTML 与 CSS 这类模板区域的诊断和补全。TypeScript 相关的请求则走转发链路——vue_ls的on_init里注册了tsserver/request处理器，遇到 TS 请求就在当前 buffer 里找ts_ls或vtsls客户端转交，重试十次仍找不到就直接报错提示缺少 TS 服务器。

所以结论很明确：只启用vue_ls时，.vue文件的<script>区域是"裸"的，必须再启用一个 TypeScript 服务器（官方推荐 vtsls），补全、跳转、类型检查才完整。

三步搭好 Vue 智能开发环境

第一步，安装两个服务器。全局装一条 npm 命令即可；如果你用 mason.nvim，把vue_ls和vtsls加进ensure_installed交给它统一托管，下面的手动步骤都可以跳过。

npm install -g @vue/language-server @vtsls/language-server

第二步，在 Neovim 配置里启用两者，两行调用：

vim.lsp.enable('vue_ls') vim.lsp.enable('vtsls')

第三步，做桥接。这一步是让 vtsls 知道"vue 文件里的 TS 也归我管"。核心是在 vtsls 的settings.vtsls.tsserver.globalPlugins里注册@vue/typescript-plugin：插件的location指向 vue-language-server 包内node_modules/@vue/language-server的路径（mason 托管时取 mason 安装路径，npm 全局安装可用npm root -g定位），languages必须显式包含'vue'，configNamespace固定为'typescript'；同时给 vtsls 的filetypes追加'vue'。

local vue_plugin = { name = '@vue/typescript-plugin', location = '/path/to/vue-language-server/node_modules/@vue/language-server', languages = { 'vue' }, -- 必须显式列出，只在 filetypes 里加 vue 不够 configNamespace = 'typescript', } vim.lsp.config('vtsls', { settings = { vtsls = { tsserver = { globalPlugins = { vue_plugin } } } }, filetypes = { 'typescript', 'javascript', 'javascriptreact', 'typescriptreact', 'vue' }, })

如果 Neovim 启动偏慢、而项目里只有少数文件是 Vue，可以把上面两行 enable 挪进一个 FileType 自动命令里，仅在打开.vue文件时才拉起这两个服务器，日常启动开销为零。

两种特例：Vue 2 老项目与大型 monorepo

vue_ls 默认只按 Vue 3 处理语法，Vue 2 老项目需要两步修正。其一，在 vue_ls 配置里把settings.vue.target设为 2：

vim.lsp.config('vue_ls', { settings = { vue = { target = 2 } }, })

其二，项目依赖里的@vue/compiler-sfc要用 2.x 版本，别沿用默认的 3.x，否则模板区域的诊断会大面积报语法错误。

monorepo 则是 vtsls 的主场：它原生支持 monorepo，会自动定位到你当前正在编辑的 package 对应的tsconfig.json或jsconfig.json，不需要为每个子包起一个服务器实例，内存占用保持在单实例水平。建议把各子包的 TypeScript 版本统一，并放在 workspace 根目录，二进制位置只解析一次。另外注意官方提示：vtsls和ts_ls不建议同时启用，选一个即可。

智能提示不生效？用症状反查原因

出了问题先别急着重装，对照下面三种最常见的形态反查，基本能覆盖九成故障：

收尾

Neovim 的 Vue 支持现在就是这套格局：vue_ls 管模板、vtsls 管类型，靠 typescript-plugin 串起来；三步配置加上 Vue 2 的 target 设置，就是日常要掌握的全部内容。更多参数与默认值可直接翻 doc/configs.md，两个服务器的完整实现分别在 vue_ls.lua 和 vtsls.lua，值得各花两分钟读一遍。

【免费下载链接】nvim-lspconfigQuickstart configs for Nvim LSP项目地址: https://gitcode.com/GitHub_Trending/nv/nvim-lspconfig