命令行的行为

如何控制输出文件中的排序（-- out）？

输出文件的排序遵循预处理后输入文件的顺序。

编译器执行预处理，主要是为了解决所有的三斜线指令和模块导入。在这个过程中，额外的文件将会被将入到编译过程中。

这个过程开始于一个给定的根文件，这些是在命令行或者是 tsconfig.json 文件中 files 指定文件名，这些根文件按照指定的顺序进行预处理。在一个文件添加到这个列表之前，将处理所有的三斜线引用和模块导入语法，并包括它们的目标。三斜线引用和导入语法按照它们在文件中出现的顺序，以深度优先的方式解析。

请参考有关三斜线指令在新窗口打开的更多信息，和模块在新窗口打开导入语法的信息。

Exported variable [name] has or is using private name [name] 是什么错误？

当你使用 --declarartion 编译选项的时候，可能会出现这个错误，因为编译器试图生成与你定义模块完全匹配的声明文件：

假设你有这样一段代码：

/// MyFile.ts
class Test {
  // ... other members ....
  constructor(public parent: Test) {}
}

export let t = new Test('some thing');

为了生成声明文件，编译器必须为 t 写一个类型：

/// MyFile.d.ts, auto-generated
export let t: ___fill in the blank___;

成员 t 有类型 Test，但是类型 Test 并不是可见的，因为它没有导出，因此我们不能写 t: Test。

在这个非常简单的例子里，我们可以用一个对象字面量重写 Test's 的形状。但是对于绝大多数情况，这并不能正常工作。如代码里所写，Test 的形状是自引用的，不能重写为匿名函数。如果 Test 有任何私有或受保护的成员，这同样也不能正常工作。因此，与其让你通过编写一个真实的类来获得 65% 的成功而后开始抛出错误，我们仅仅是在一开始的时候就抛出错误（你以后会发现）并为你省去不必要的麻烦。

为了避免这些错误：

• 导出相关类型中使用的声明
• 当编写声明的时候，显示的为编译器指定类型注解

为什么添加 --outDir 属性后，当在添加一个新文件时，会把所有的输出删除

--outDir 指定输出的「根」目录。编译器需要此属性，用来将资源映射输出到根目录。如果 --rootDir 没有被指定，编辑器将会自己计算出一个。它根据常见的路径计算，它是所有输入文件的最长公共前缀。显然，当在较短路径前缀中添加新文件时，--rootDir 将会被修改。

为了确保添加一个新文件时，输出不会被修改，你应该在命令行中或 tsconfig.json 指定一个 --rootDir。