microsoft / microsoft/TypeScript
SourceRoot documentation inconsistent
还没有人认领这个 Issue。
- 主要语言
- Go
- 星标
- 111k
- 派生
- 14.3k
- 平均合并
- 2 天 4 小时
- 30 天内合并 PR
- 132
描述
In the compiler options documentation is sourceRoot explained as follows:
Specifies the location where debugger should locate TypeScript files instead of source locations. Use this flag if the sources will be located at run-time in a different location than that at design-time. The location specified will be embedded in the sourceMap to direct the debugger where the source files will be located.
In the documentation of the extends property is explained that all path are relative to the file they originated in.
All relative paths found in the configuration file will be resolved relative to the configuration file they originated in.
I have understood that the path in sourceRoot is relative to the compiled files and points to the source files. sourceRoot is not relative to the configuration file it originates in. If I use a path relative to the configuration file, the source files are not found.
Expected behavior:
The documentation must be consistent or the path must be relative to the file they originated in.
贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
调研方向
先查看链接的编译器选项文档以及关于 extends 属性的 tsconfig.json 文档,然后验证 sourceRoot 路径是如何解析的。协调这两种解释,使文档所述的行为保持一致,或者明确记录实际的路径基准。
由索引模型根据 Issue 内容生成。
评估
- 技术栈
- typescript
- 领域
- documentation
- Issue 类型
- 文档
- 难度
- 3/5
- 预计耗时
- 1-2 天
- 活跃度
- 停滞
- 描述清晰度
- 基本清楚
- 新手友好度
- 35/100