后端运行环境与依赖隔离
运行后端前，要明确使用哪个语言版本、哪个项目环境和哪些依赖。环境隔离避免不同项目互相污染。
- 能说明当前项目到底使用哪一个运行时和哪一套依赖。
- Python/Java/Node 等运行环境与代码的关系
- 建立隔离环境，安装一个 HTTP 客户端库，并从依赖清单重新安装验证。
- 完成 5.1「亲手调用一次真实 API」
FOUNDATION
必须理解
运行后端前，要明确使用哪个语言版本、哪个项目环境和哪些依赖。环境隔离避免不同项目互相污染。
后端代码依赖特定运行时、版本和第三方包。项目级隔离让同一台电脑上的多个项目互不污染，也让别人能根据清单重建相同环境。
不同项目像不同实验，每个实验有自己的器材清单和配比。把所有材料倒进公共箱，迟早不知道哪种版本属于哪个实验。
任务应用主线使用项目内 Node.js 与 npm 依赖；课程也识别 Python 虚拟环境和 Java 构建工具，让读者理解“环境隔离”是跨语言概念。
Python/Java/Node 等运行环境与代码的关系
运行时就是实际执行代码的程序，比如 Node.js、Python 解释器或 Java 虚拟机。终端最后找到的是哪个程序、哪个版本，会直接影响项目能不能跑。
基础概念
运行时是实际读取并执行代码的程序，例如 Node.js、Python 解释器或 Java 虚拟机 JVM。语言源码必须进入兼容运行时，版本会决定可用语法和 API。
进一步理解
终端根据 PATH 找到某个可执行程序，同名命令可能指向不同安装位置。`node --version` 只说明当前终端找到的版本，不说明其他窗口或部署环境相同。
Java 源码通常先编译成字节码再由 JVM 执行，TypeScript 也需转换成 JavaScript；“代码文件存在”并不代表系统知道用什么运行。
任务后端声明需要 Node 22；开发机、构建环境和托管平台都要满足，否则可能在语法、模块或原生依赖处失败。
编辑器显示的语言模式不是运行时。安装 TypeScript 扩展不会自动安装 Node，也不会决定部署使用哪个版本。
这一小节记住：先确认真正执行代码的程序、路径和版本。
虚拟环境或项目级依赖
项目需要的第三方包应该写进自己的依赖清单，而不是依赖你电脑上“以前好像装过”。换台机器时，清单才是可靠依据。
基础概念
项目级依赖把某个项目所需的第三方包和版本限制在该项目上下文；Python 虚拟环境、Node 的依赖目录和 Java 构建工具都在解决可隔离与可声明的问题。
进一步理解
全局安装会让项目依赖电脑的历史状态，换机器后无法知道缺了什么。项目清单则把需要的库、版本和脚本留在源码旁。
不同语言实现方式不同：Python 虚拟环境包含独立解释器环境，Node 常按项目解析 node_modules，Maven/Gradle 根据构建文件解析 Java 依赖。
任务应用把数据库客户端列进 package.json；另一项目可以使用不同版本，两者不必争抢一个全局安装。
隔离环境不等于容器，也不自动隔离数据库与网络；它主要控制运行时和代码依赖的来源。
这一小节记住：依赖属于项目，应由项目清单重建，而不是依靠“这台电脑以前装过”。
依赖清单、锁定版本和可复现安装
可复现安装的意思是：拿到同一份源码和锁文件，别人也能装出兼容环境。升级依赖要单独做、单独测，别在修其它问题时顺手全升。
基础概念
可复现安装是使用相同源码、依赖清单、锁文件和兼容运行时，能够重建功能等价的环境。锁定版本减少每次安装重新选择依赖带来的漂移。
进一步理解
可复现不只看顶层包，间接依赖也会改变行为。锁文件记录完整解析结果，持续集成可用干净环境验证清单是否真的足够。
升级应作为独立变更：先看发布说明，更新有限范围，运行测试，再提交新的锁文件。排错时顺手全升会同时改变太多变量。
在新目录拉取任务应用后按锁文件安装，再运行构建与测试；若失败，比较 Node、系统和环境变量而不是立即重装一切。
相同锁文件不能消除所有平台差异，原生模块、CPU 和系统库仍可能不同；可复现是缩小变量，不是绝对复制。
这一小节记住：版本、清单、锁文件和验证命令共同定义可重建环境。
AI COLLABORATION
AI 如何参与
遇到版本问题时先让 AI 检查可执行文件路径、版本和当前环境，而不是连续重装。
推荐协作顺序
- 1
先把实际 Node 路径、版本和项目目录发给 AI。
- 2
让它对照 package.json 与锁文件寻找差异。
- 3
只在证据指向安装问题时重装项目依赖，并保留原有包管理器。
我在 Windows 的 Next.js 项目遇到“本机能运行，另一台电脑失败”。请先让我提供 node --version、npm --version、当前路径、package.json、锁文件和完整错误，再按证据排查。禁止先删除锁文件、全局安装或升级所有依赖。
先确认实际运行时和项目上下文，再针对错误提出最小变化，不通过反复重装掩盖原因。
人工检查清单
- 确认命令在项目目录执行，使用现有包管理器与锁文件，不混用 npm、pnpm、yarn。
- 让 AI 先列出实际可执行文件路径、版本、项目清单和锁文件差异，再提出最小实验。
- 在干净项目环境重跑原失败命令，确认修复不依赖某个全局安装。
COMMON TRAPS
常见误区
错误不是需要隐藏的失败，而是帮助你看清系统边界的证据。下面三类问题在 AI 辅助学习中最常出现。
全局安装解决所有问题
- 你会看到
- 自己电脑能运行，换台电脑立刻找不到依赖。
- 为什么发生
- 全局安装让当前电脑看似正常，却把关键依赖藏在项目之外，其他环境无法根据源码恢复。
- 怎样纠正
- 把依赖写进项目清单，让安装过程可以重现。
混用多个包管理器
- 你会看到
- npm、pnpm 和 yarn 的锁文件同时存在，安装结果每次不同。
- 为什么发生
- 不同包管理器使用不同锁文件与解析规则，混用会让同一提交产生不一致依赖树。
- 怎样纠正
- 沿用项目已有的包管理器和锁文件。
报错就删除锁文件
- 你会看到
- 短暂绕过冲突，却把整个依赖树升级成未知版本。
- 为什么发生
- 删除锁文件改变整个依赖集合，原错误可能暂时消失，却失去对真实根因的判断。
- 怎样纠正
- 先读错误与版本差异，锁文件修改应是明确决策。
HANDS-ON
动手任务
建立隔离环境，安装一个 HTTP 客户端库，并从依赖清单重新安装验证。
- 完成 5.1「亲手调用一次真实 API」
跟着做
- 01
记录 Node 和 npm 的实际路径与版本。
- 02
查看 package.json 中 engines、scripts 和 dependencies。
- 03
解释 package-lock.json 与 node_modules 的区别。
- 04
在新练习目录按锁文件安装依赖。
- 05
运行开发与构建命令，比较两种环境输出。
能说明当前项目到底使用哪一个运行时和哪一套依赖。
用表格对比 Node 项目依赖、Python 虚拟环境和 Java Maven 的对应概念。
离开本课前，自问四件事
- 运行时、语言源码和编辑器插件有什么区别？
- 项目级依赖隔离在 Node、Python 与 Java 中分别如何体现？
- 可复现安装至少依赖哪些信息？
- 为什么升级依赖应该单独进行并单独验证？
确认完成后，会同步更新学习中心的课程学习进度。