goland typescript自动导入需手动开启:在“设置→语言与框架→typescript→代码生成”中勾选三项——“在代码补全时添加typescript导入”“带有自动导入工具提示”“即时添加明确的导入”。

GoLand 默认不自动插入 import 语句,必须手动开启对应语言的自动导入开关,否则即使补全了符号,import 也不会出现——这是最常被忽略的前提。
TypeScript 自动导入开关在哪开
GoLand 的 TypeScript 自动导入不是全局默认启用的,它藏在「设置 → 语言与框架 → TypeScript → 代码生成」里。关键要勾选三项:
-
在代码补全时添加 TypeScript 导入:输入过程中按Ctrl+Space补全一个未导入的符号(比如useEffect),会立刻插入import { useEffect } from 'react' -
带有自动导入工具提示:光标停在红色波浪线的未解析符号上(如axios.get),会弹出带「Import」选项的悬浮提示 -
即时添加明确的导入:粘贴一段含未导入符号的代码(例如从文档复制的zod.object(...)),只要该符号只在一个地方可导出,GoLand 就自动加import
注意:即时添加明确的导入 对歧义场景(比如多个 @types/xxx 同时存在)会直接跳过,不报错也不提示——它只做“唯一来源”判定。
使用 JSON Schema 验证 JSON 数据,从示例 JSON 生成 schema,并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
JavaScript(ES6)自动导入需要语言级别支持
JS 的自动导入依赖项目语言版本设为 ECMAScript 6 或更高。如果 import 不触发,先检查:
- 打开
设置 → 语言与框架 → JavaScript,确认语言版本是ECMAScript 6+ - 若项目用
require+module.exports,自动导入不会生效——它只识别 ES6export/import语法 - 浏览器环境需额外勾选
使用文件扩展名(在设置 → 语言与框架 → JavaScript → 代码样式 → Imports),否则补全后生成的是import { foo } from './bar',但浏览器报Failed to resolve module specifier
自动导入失败的三个典型信号
不是配置没生效,就是环境或符号本身有问题:
- 补全列表里有符号,但按下
Enter后没加import→ 检查是否勾选了对应语言的「在代码补全时添加」选项,且当前文件后缀是.ts或.js(不是.jsx或.tsx被误判为 JSX) - 光标悬停无导入提示,但
Alt+Enter能唤出「Import」→ 说明带有自动导入工具提示未勾选,或当前符号属于全局变量(如window、localStorage) - 明明装了
@types/react,但useState补全不出 → 确认node_modules/@types/react在项目中可见,且未被标记为「Excluded」(右键目录 →Mark Directory as → Excluded会切断类型索引)
自动导入本质是 IDE 基于已知模块路径和导出声明做的静态推断,它不运行代码、不读 package.json 的 exports 字段,也不处理动态 import()。一旦路径别名(@/components)没配好,或者 tsconfig.json 的 baseUrl/paths 未被 GoLand 识别,导入就会静默失败——这时候得先调通路径映射,自动导入才可能工作。










