VSCode中import报错、F2重命名不跨文件、跳转失效的根源是语言服务未正确解析路径或符号：需检查tsconfig/jsconfig是否存在且配置baseUrl与paths、确保文件在作用域内、重启语言服务。
VSCode 里 import 报错、F2 重命名不跨文件、跳转失效 —— 这些不是编辑器坏了，而是语言服务没认出你的路径规则或符号定义。 核心问题通常卡在三处：别名没配对、tsconfig/jsconfig 缺失或错配、语言服务没加载。下面直接说怎么动刀。
为什么 import 路径标红但运行正常？
这是 VSCode 的 TypeScript/JavaScript 语言服务在“解析模块”阶段失败，和打包工具（如 Vite/Webpack）能否运行无关。常见表现：Cannot find module '@/components/Button'，但项目能正常启动。
- 检查项目根目录是否存在
tsconfig.json或jsconfig.json；若无，新建一个 - 确认配置含
"baseUrl": "."和"paths"映射，例如：{"compilerOptions": {"baseUrl": ".", "paths": {"@/*": ["src/*"]}}} - 确保该配置文件在工作区根目录（即你通过「File → Open Folder」打开的文件夹），不是子目录里
- 改完配置后必须执行「Developer: Restart Language Server」或关闭再重开窗口，否则缓存不刷新
F2 重命名只改当前文件，不更新 import 名？
重命名依赖语言服务识别“这是一个导出的、可被其他文件引用的符号”。如果只改了局部变量或函数内部参数，那是正常行为；但如果 export function apiRequest() 在 A.ts 里，B.ts 中 import { apiRequest } from './A' 却没跟着变，说明链路断了。
- 确保导出是具名导出：
export function apiRequest()，而不是export default function()（后者重命名后类型信息易丢失） - 导入也必须是具名导入：
import { apiRequest } from './A'；若用import * as utils from './A'，重命名不会触达utils.apiRequest - 检查 A.ts 和 B.ts 是否都在同一 tsconfig/jsconfig 作用域下（比如 B.ts 不在
"include"列表里，或被"exclude"掉了） - 按 F2 前先保存所有相关文件（
Ctrl+S），否则语言服务可能读的是旧 AST
批量替换导入路径时正则怎么写才安全？
全局搜索替换是临时救急手段，但容易误伤字符串和注释。用正则前务必确认目标路径结构统一，且只在明确可控范围内操作。
- 将
from '../utils/api'改为from '@/utils/api'，推荐正则：from\s+['"]\.\./utils/(.*?)['"]
→ 替换为：from '@/utils/$1'
- 避免匹配到
require('../utils/api')或注释里的路径，可在正则开头加^或限定上下文（如加import前缀） - 启用「Match Case」和「Match Whole Word」降低误替风险
- 执行前点开「Replace All in Files」预览列表，逐个核对路径是否合理；尤其注意
../../深度变化后别名是否仍覆盖
重命名后类型引用没更新，尤其是 node_modules 里的类型？
TS 语言服务默认不主动加载第三方库的类型定义，除非你显式安装或启用自动获取。
- 若报错
Cannot find name 'XXX'且来自 npm 包，先运行npm install -D @types/xxx（如@types/react） - 在
tsconfig.json中启用自动类型获取："typeAcquisition": {"enable": true} - 如果类型来自带
paths映射的本地包（如import { foo } from 'mylib/utils'），需确保mylib的package.json含"types"字段，且其index.d.ts可被解析 - 重启 TS Server 后，观察状态栏右下角是否出现「TypeScript 5.x」字样，而非「Loading...」或报错图标
最常被忽略的一点：路径别名和重命名能力是两套机制，但高度耦合——paths 配错了，F2 就找不到跨文件引用；baseUrl 没设，连本文件内的相对路径都解析不了。别跳过配置验证这一步，它比重装插件管用十倍。
