Neovim环境下coc-tsserver实现Next.js自动导入失效咨询

配置逻辑说明 #

coc-tsserver 的自动导入能力核心依托 TypeScript 原生的模块类型扫描机制，并非由 ESLint 触发。手动编写导入语句无报错、但遗漏导入时无法自动补全的问题，本质是 tsserver 没有建立完整的 Next.js 模块索引，而非 ESLint 配置缺失。

具体配置步骤 #

1. 修正 coc-tsserver 基础运行配置 #

编辑 coc 全局配置（对应 coc-settings.json 文件），确保以下项配置正确：

• 强制 tsserver 使用项目本地安装的 TypeScript 版本，设置 "tsserver.pluginSource": "project"，避免全局 TypeScript 版本和项目版本不匹配，导致类型扫描范围异常
• 开启包导入扫描开关，设置 "tsserver.preferences.includePackageJsonAutoImports": "on"，强制扫描 node_modules 下所有依赖包的导出声明，将可自动导入的模块加入候选列表
• 检查 tsserver.preferences.autoImportFileExcludePatterns 配置项，确认未将 node_modules/next 相关路径加入排除列表

2. 补全项目 TypeScript 配置 #

检查项目根目录的 tsconfig.json，避免因配置缺失导致 Next.js 内置模块声明无法被识别：

• 保留 Next.js 自动生成的 next-env.d.ts 文件，不要手动删除，该文件是 Next.js 内置模块的类型声明入口
• 确保 include 数组覆盖 Next.js 的类型扫描路径，默认配置为："include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"]
• 确认 compilerOptions 中开启 "esModuleInterop": true，避免模块解析时的兼容性问题

3. 排查配置冲突 #

• 调整 coc-eslint 扩展的功能边界，仅保留代码诊断、格式修正能力，不要开启扩展自带的自动导入补全逻辑，避免和 tsserver 原生自动导入功能冲突
• 不要手动在全局配置中硬编码特定组件的导入路径，这类自定义规则会打断 tsserver 正常的模块索引流程

异常排查流程 #

配置完成后若功能仍未生效，按顺序执行以下操作：

• 重新安装项目依赖，确保 node_modules/next 路径下的类型文件完整，不存在安装缺漏问题
• 执行 :CocCommand tsserver.reloadProjects 命令，强制 tsserver 全量重新扫描项目模块，跳过增量扫描的缓存逻辑
• 检查项目根路径是否被 coc-tsserver 正确识别为项目根目录，避免因根路径判断错误，导致 node_modules 扫描路径偏移

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