Report error if code precedes /// reference

a.ts:

'use strict'
/// <reference path='b.d.ts'/>

var x: Foo;

b.d.ts:

interface Foo { x: string; }
declare module "b" {
        export = Foo;
}

D:\test\refs\a> tsc a.ts
a.ts(4,8): error TS2304: Cannot find name 'Foo'.

There's no mention in section 11.1.1 of the spec that /// references must be the first thing in a file in order to work, although I do remember us deciding that was the case at one point. If that is the rule we should update the spec appropriately. We should also add an error to the compiler or else you may spend awhile trying to figure this out since we don't provide much (read: anything) in the way of diagnostics for debugging reference resolution.

使用 a.ts、b.d.ts 和 tsc a.ts 重现该案例，然后阅读规范第 11.1.1 节以及编译器的引用解析诊断信息。确定文档化规则是否要求引用必须位于前面，并将 done 定义为更新规范和/或针对顺序错误报告明确的编译器错误。