运行时与工具链：从 npm 到编译器

先记住这张地图

你不需要重新学习“程序是什么”，但必须重新画出代码到运行状态的路径。JS/TS 通常由 Node.js 读取模块并在运行时执行，TypeScript 还要先经过类型检查或转译；Python 由解释器加载模块，常用虚拟环境锁定依赖；C++ 则把源文件编译成目标文件，再链接成可执行文件。三者都能启动服务、训练数据管线或机器人节点，但错误出现的时间不同：拼错的导入可能在 Node/Python 启动时暴露，C++ 的声明错误通常在编译阶段暴露，ABI 或动态库不匹配又可能推迟到启动阶段。

迁移时先问三个问题：入口是谁调用的，依赖从哪里来，修改后哪一步必须重新执行。不要把“能在我的终端跑起来”误认为工具链已经可复现。AI 项目要记录 Python 版本、CUDA/CPU 约束和模型包版本；机器人项目要记录编译器、系统库和目标架构。一个清晰的启动命令，本质上是团队共享的运行契约。

{ "scripts": { "start": "node src/index.js" } }

cmake -S . -B build
cmake --build build
./build/app

学习目标

• 能描述 JS/TS、Python 与 C++ 从源码到运行的关键阶段和常见错误时机。
• 能检查运行时/编译器版本、依赖环境、入口和构建目标，复现一条启动路径。
• 能把“代码错误”和“工具链/环境错误”分层诊断，而不是先重装所有依赖。

从解释到编译：心智模型的差别

npm run 只是查表后启动一个进程，不会替你保证 Node 版本；python -m app.cli 会按模块路径解析包，当前工作目录和虚拟环境会影响结果；cmake --build 可能只重编译受影响的目标，并在链接时合并库。把这些步骤拆开看，遇到问题就能判断是源码、依赖、构建缓存还是运行环境，而不是盲目重装。

# 用最小命令验证“入口—依赖—运行时”
node --version
node src/index.js --input sample.json
python -m app.cli --input sample.json
cmake -S . -B build && cmake --build build && ./build/app sample.json

工程上要固定什么

提交 lockfile 或依赖约束，给 Python 使用明确的虚拟环境和 requirements，给 C++ 写清 CMake target 和编译标准。不要把生成的 dist、build 当成唯一真相；真正可复现的是源码、配置、依赖版本和构建命令的组合。对于跨平台项目，先在干净环境运行一次启动命令，再把缺失步骤写进 README 或 CI。

常见错误与排错顺序

看到“模块找不到”，先确认执行目录和入口，再检查依赖是否安装到了当前环境；看到 C++ 的链接错误，区分“找不到声明”与“找不到实现”，前者看头文件，后者看 target 链接关系。若本地能跑、CI 失败，比较运行时版本和环境变量，不要先修改业务逻辑。把完整命令、版本输出和第一处错误保存下来，通常比最后一行堆栈更有价值。

实际对照三条启动路径

选择同一份最小逻辑，在三个项目中分别定位入口、执行命令和依赖来源。Node 直接由运行时加载模块，Python 由当前解释器加载包，C++ 需要先编译并链接出可执行文件；TypeScript 还要区分类型检查与转译阶段。

node --version
python --version
cmake --version

这些版本输出只是一部分证据：还要确认命令实际来自哪个安装位置、Python 是否处于目标虚拟环境、CMake 生成的是哪个配置，以及 Node 执行的是源码还是构建产物。把这些信息与项目启动命令一起记录，才足以比较本机与 CI。

运行验证与环境诊断

依次执行一个最小程序、项目测试和正式构建。若 Node/Python 在启动时失败，检查入口、模块路径和依赖；若 C++ 编译失败，先区分编译错误与链接错误；若构建成功但启动失败，再查看动态库、运行目录和配置。不要把一次 --version 成功当作项目已经可构建。

迁移仓库时也应保存锁文件、编译选项与依赖安装说明；仅仅记录“用了最新版本”无法复现。验证要从干净构建目录开始，确认构建产物确实由当前源文件生成，而不是旧缓存刚好让程序启动。

共享诊断记录至少包括：命令、当前目录、运行时/编译器版本、依赖锁文件、构建模式、退出码和第一处错误。这样同事可以在相同环境重现，而不需要根据最后一行猜测。

迁移练习

打开一个你熟悉的 Node.js 项目，写出从命令到程序运行经过的步骤，再设计一个 Python 或 C++ 版本。请记录运行时版本、依赖安装位置、入口参数，以及修改一个源文件后实际执行了哪些重新构建步骤。最后故意在错误的目录运行命令，观察并记录错误信息。

命令 -> package script -> node -> 入口模块 -> 依赖模块。Python 是命令 -> 虚拟环境解释器 -> 模块入口；C++ 通常新增源文件 -> 编译 -> 链接 -> 可执行文件 -> 运行。

小结

迁移语言时，入口、依赖隔离、构建/链接和运行环境都需要重新确认。把完整启动路径记录下来，再进入语法与类型课程；后续遇到错误可先判断它属于哪一个阶段。