Perspective项目示例运行问题解析：node_modules路径缺失的解决方案

问题背景

在Python Tornado和Rust Axum等示例中，开发者可能会遇到一个常见问题：代码中引用的node_modules目录不存在。这个问题源于Perspective项目的特殊工作区结构设计，需要按照特定方式运行示例才能正常工作。

根本原因

Perspective项目采用了pnpm工作区(workspace)的组织方式，这是一种现代JavaScript包管理方案。在这种结构下：

1. 所有依赖都安装在项目根目录的node_modules中
2. 子项目通过工作区引用共享这些依赖
3. 示例代码设计为在项目构建后从工作区根目录运行

解决方案

正确运行示例的方法是使用pnpm从工作区根目录启动：

pnpm run start python-tornado-streaming

对于Rust Axum示例，同样需要从项目根目录运行：

pnpm run start rust-axum

技术细节

1. pnpm工作区特性：pnpm通过符号链接将依赖集中管理在根node_modules，子项目共享这些依赖，避免重复安装。

2. 构建依赖关系：Perspective的核心功能需要先构建WebAssembly模块和JavaScript包，这些构建产物会被示例代码引用。

3. 路径解析：示例中使用的相对路径(如../../node_modules)是基于从项目根目录运行的假设设计的。

最佳实践建议

1. 始终从项目根目录运行示例
2. 在开发前完整阅读项目的开发文档
3. 确保已执行过项目构建步骤(pnpm build)
4. 对于定制化开发，可以修改示例中的路径引用，但要注意保持与构建产物的相对位置关系

总结

理解现代JavaScript项目的工作区管理方式是解决这类问题的关键。Perspective项目通过pnpm工作区实现了高效的依赖管理，开发者需要适应这种结构才能正确运行各种语言绑定的示例程序。