VSCode识别扩展String接口代码报错，ts-node运行正常如何修复？

问题场景 #

为全局String类型扩展test方法后，VSCode提示类型错误，但使用npx ts-node运行代码完全正常。

核心原因 #

VSCode的TypeScript语言服务未正确识别全局类型扩展的定义，或配置文件未被正确加载。

解决方案 #

1. 确保类型定义处于全局作用域

检查types.d.ts文件，不要添加export/import语句（否则文件会被当作模块，全局接口扩展失效）。当前你的文件写法是正确的：

// types.d.ts
interface String {
    test: () => string
}

2. 优化tsconfig.json配置

将files字段替换为include，确保所有相关的TypeScript文件（包括类型定义）都被TypeScript服务识别：

// tsconfig.json
{
    "compilerOptions": {
        "target": "ESNext",
        "moduleResolution": "NodeNext",
        "baseUrl": ".",
        "paths": {
            "@tools/*": ["tools/*"],
            "@core/*": ["core/*"]
        }
    },
    "include": ["types.d.ts", "**/*.ts"] // 替换原有的files字段
}

3. 重启VSCode的TypeScript服务

按Ctrl+Shift+P（Windows）或Cmd+Shift+P（Mac）打开命令面板，输入并执行TypeScript: Restart TS Server，强制刷新语言服务，让它重新读取配置和类型文件。

4. 确认VSCode使用项目本地的TypeScript版本

确保项目已安装本地TypeScript依赖：

npm install typescript --save-dev

你的settings.json已配置"typescript.tsdk": "node_modules\\typescript\\lib"，此配置会让VSCode优先使用项目本地的TypeScript版本，避免与全局版本不一致导致的识别问题。

内容的提问来源于stack exchange，提问作者Jean Paul Sánchez Mendoza