如何在ts-node中正确使用Triple-Slash Directives

报错核心原因 #

你遇到的ReferenceError本质是对三斜杠指令的作用边界理解有误：

• 三斜杠指令仅在TypeScript类型检查阶段生效，它的作用是告诉TS编译器在做类型校验时，需要把指定路径文件的类型信息纳入当前编译上下文，完全不会处理运行时的代码引入、合并逻辑。
• 执行tsc -d不报错，是因为编译器通过/// <reference path="Myconsole.ts" />找到了MyConsole的类型定义，类型校验环节顺利通过；但编译输出的test.js里根本没有包含Myconsole.ts中定义MyConsole命名空间的实际代码，运行时自然找不到对应变量。
• 编译后JS文件里残留的三斜杠行会被JS运行时当成普通注释完全忽略，不可能靠它加载.ts文件，注释不会产生任何执行逻辑。
• 同文件定义的MyConsole2能正常调用，是因为它的代码被直接编译进了test.js，运行时存在对应变量。

三斜杠指令的适用场景 #

三斜杠指令不是import/export的替代语法，它是TypeScript早期没有原生模块化方案时的过渡产物，现代TS开发中适用场景非常有限：

• 给无import/export的全局脚本文件声明类型层面的依赖关系，仅做类型检查关联，运行时代码需要手动通过script标签、打包工具合并等方式引入。
• 引入全局类型包，比如/// <reference types="node" />，告知编译器加载对应npm包的全局类型定义，同样仅作用于类型层面。
• 旧项目中配合outFile配置，手动指定多文件合并编译时的加载顺序，这是唯一能让三斜杠指令影响编译输出代码的场景。

对应需求的实现方案 #

根据项目技术选型，二选一即可：

方案1：保留全局命名空间写法，配合outFile合并编译（仅适合无打包工具的旧项目） #

如果要继续用命名空间+三斜杠引用的写法，需要配置TS编译器把所有依赖文件合并为单个JS文件输出，三斜杠指令会告知编译器文件的合并顺序：

1. 新增tsconfig.json配置：

{
  "compilerOptions": {
    "target": "ES5",
    "module": "AMD", // 仅AMD/System模块模式支持outFile多文件合并
    "outFile": "./dist/bundle.js", // 合并后输出的单文件路径
    "declaration": true
  },
  "include": ["*.ts"]
}

2. 保持现有test.ts的三斜杠引用写法不变，执行tsc命令后，编译器会按依赖顺序把Myconsole.ts和test.ts的代码合并到bundle.js中，直接运行该合并后的文件即可正常执行。
3. 注意：ts-node默认不支持这种多文件合并的执行模式，直接运行ts-node test.ts会始终报变量不存在的错误。

方案2：使用标准ES模块语法（所有新项目推荐，无需三斜杠指令） #

抛弃全局命名空间和三斜杠引用，使用ECMAScript标准的import/export语法，ts-node、tsc、所有现代打包工具都原生支持，不会出现类型检查正常但运行时报错的问题：

1. 修改Myconsole.ts，导出命名空间：

// Myconsole.ts
export namespace MyConsole {
  export function log(msg: string) {
    console.log(msg);
  }
}

2. 修改test.ts，删除三斜杠指令，用标准import引入依赖：

// test.ts
import { MyConsole } from './Myconsole';

MyConsole.log("log"); // 类型检查、运行时均可正常识别

namespace MyConsole2 { 
  export function foo(msg: string) {
    console.log(msg);
  }
}

MyConsole2.foo("ging");

3. 此时直接执行ts-node test.ts即可正常运行，tsc编译也会自动处理依赖关系，无需额外配置合并规则。

额外注意 #

不要在已经使用import/export的ES模块文件中使用三斜杠path指令，这种不符合规范的写法极易出现类型校验通过但运行时崩溃的问题。绝大多数现代TS项目不需要用到三斜杠指令，优先使用标准ES模块语法即可。

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