如何让VS Code自动导入优先选择本地模块而非node_modules？

一、原生配置调整（无需扩展） #

1. 配置路径别名（关键前提） #

在项目根目录的tsconfig.json或jsconfig.json中添加路径映射，确保本地模块能通过别名被VS Code识别：

{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@/*": ["app/*"] // 匹配你项目的实际本地目录结构
    }
  },
  "include": ["app/**/*"]
}

2. 调整VS Code导入偏好设置 #

打开VS Code设置（快捷键Ctrl+,/Cmd+,），搜索并修改对应配置：

• TypeScript项目：设置typescript.preferences.importModuleSpecifier为non-relative，让VS Code优先选择非相对的别名路径，而非node_modules中的包。
• JavaScript项目：设置javascript.preferences.importModuleSpecifier为non-relative。
• 额外开启typescript.suggest.paths（或javascript.suggest.paths）为true，确保路径别名被纳入自动导入候选列表。

3. 临时屏蔽冲突包（可选） #

如果上述设置仍不生效，可在tsconfig.json中添加exclude配置，暂时屏蔽node_modules中冲突的包：

{
  "exclude": ["node_modules/class-variance-authority"]
}

二、扩展推荐（原生配置无法满足时） #

如果原生配置无法解决优先级问题，推荐以下扩展：

• Auto Import - ES6, TS, JSX, TSX：支持自定义导入优先级，可在扩展设置中把本地路径别名加入优先列表，强制自动导入时选择本地模块。
• Path Intellisense：增强路径补全能力，配合别名配置，让本地模块的补全候选排在node_modules包之前。
• Import Helper：可自定义导入规则，通过配置文件指定本地模块的优先级，自动替换错误的导入路径。

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