JavaScript 的内置函数（如 Promise、Array.prototype.map）并非用 JavaScript 编写，而是由浏览器引擎（如 V8、SpiderMonkey）以 C++ 实现，其 TypeScript 声明文件（.d.ts）仅提供类型接口，不包含真实逻辑源码。
javascript 的内置函数（如 promise、array.prototype.map）并非用 javascript 编写，而是由浏览器引擎（如 v8、spidermonkey）以 c++ 实现，其 typescript 声明文件（`.d.ts`）仅提供类型接口，不包含真实逻辑源码。
在 Java 等静态语言中，IDE 通过跳转可直接查看标准库的 Java 源码；但在 JavaScript 生态中，这种“所见即所得”的源码导航并不适用——因为绝大多数全局对象（Promise、JSON、fetch、Array.from 等）根本不存在等价的 JavaScript 源文件。
为什么 .d.ts 文件不是源码？
当你在 VS Code 中按 Ctrl+Click（或 Cmd+Click）跳转到 Promise 定义时，看到的是类似以下的 TypeScript 类型声明：
// lib.es2015.promise.d.ts（节选）
interface Promise<T> {
then<TResult1 = T, TResult2 = never>(
onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null,
onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | null
): Promise<TResult1 | TResult2>;
// ... 其他方法声明
}这只是一个契约描述（type-only interface），用于编译期类型检查，不包含任何运行时行为。它不等同于 Java 的 Promise.java，也不对应可执行的 JS 脚本。
真实实现位于何处？
JavaScript 引擎的内置功能由底层 C/C++ 实现：
立即学习“Java免费学习笔记（深入）”；
- V8（Chrome / Node.js）：Promise 相关逻辑位于 src/builtins/promise-*（TQ 宏语言 + C++）、src/js/promise.js（部分 JS 层胶水代码，非核心逻辑）；
- SpiderMonkey（Firefox）：实现在 js/src/builtin/Promise.cpp；
- JavaScriptCore（Safari）：位于 Source/JavaScriptCore/runtime/PromiseConstructor.cpp。
⚠️ 注意：这些代码高度依赖引擎架构，包含大量宏、汇编优化和 GC 交互逻辑，不建议初学者直接阅读源码来理解语义。
更高效、可靠的学习路径
优先查阅权威文档
MDN Web Docs 提供了准确、完整、带示例的行为规范说明：
→ MDN Promise 文档
→ ECMAScript 规范（抽象操作级定义）-
借助 Polyfill 理解语义逻辑
虽然 polyfill（如 es6-promise）无法替代原生性能，但其纯 JS 实现清晰展示了 Promise A+ 规范的关键状态流转与调度逻辑：// 简化版 Promise 构造器核心逻辑（示意） function Promise(executor) { this.state = 'pending'; this.value = undefined; this.reason = undefined; this.onFulfilledCallbacks = []; this.onRejectedCallbacks = []; const resolve = (value) => { if (this.state === 'pending') { this.state = 'fulfilled'; this.value = value; this.onFulfilledCallbacks.forEach(cb => cb(value)); } }; executor(resolve, (reason) => { /* ... */ }); } -
VS Code 配置增强（有限辅助）
- 安装 Built-in Source Navigation 扩展（实验性支持跳转至 V8 内置函数注释）；
- 在 jsconfig.json 中启用 "allowJs": true 和 "checkJs": true，提升对混合 JS/TS 项目的推导能力；
- 但需明确：仍无法跳转到 C++ 实现，仅可能链接到引擎中的 JS 胶水层或规范注释。
总结
JavaScript 开发者应建立正确认知：.d.ts 是类型契约，不是源码；内置功能的真实实现深埋于引擎 C++ 层。与其耗费精力逆向阅读复杂 C++ 代码，不如善用 MDN、ECMA 规范与高质量 polyfill 来掌握语义与用法。真正的“源定义”，在规范中；可靠的“行为参考”，在文档里；而高效的工程实践，始于对分层抽象的尊重——类型系统负责安全，引擎负责性能，开发者专注逻辑。
