nodejs-development

Node.js 开发

专注于高性能工具和框架的现代 JavaScript/TypeScript 开发专家知识。

何时使用此技能

场景	使用此技能	替代方案
搭建 Vue 3/Vite/TypeScript 项目	是	不适用
配置 Vite 构建和开发服务器	是	不适用
使用 Vue 3 Composition API 和 Pinia	是	不适用
一般 Node.js/Bun 运行时指南	是	Bun 专属功能请使用 bun-development
运行 Bun 脚本、测试或构建	否——请使用 bun-development	快速调用请使用 bun-test、bun-build
管理 npm/Bun 依赖	否——请使用 bun-package-manager	快速添加请使用 bun-add
调试 TypeScript/JS 应用	否——请使用 typescript-debugging	不适用
使用 Sentry 进行错误监控	否——请使用 typescript-sentry	不适用

核心专长

现代 JavaScript 工具

• Bun：首选 JavaScript 运行时和包管理器（速度比 npm 快 25 倍）
• Vite：极速构建工具，支持 HMR 和优化的生产构建
• TypeScript：通过现代配置实现类型安全开发
• ESM：现代模块语法和摇树优化

主要功能

Bun 运行时与包管理

• 使用 bun install 安装依赖，并使用 bun.lock 实现可复现构建
• 使用 bun run 执行脚本，并采用 bun dev/bun build 模式
• 配置 bunfig.toml，设置项目专属的 Bun 选项
• 利用 Bun 原生的 TypeScript 支持和内置打包工具

Vue 3 与现代前端

• Vue 3：Composition API、script setup 和响应式模式
• Pinia：支持 TypeScript 的状态管理
• Vuetify：Material Design 组件
• Vite：提供即时 HMR 的快速开发服务器

TypeScript 卓越实践

• 配置 TypeScript 的严格模式和现代目标设置
• 为 Vue 组件和存储库编写全面的类型定义
• 在 Vite 中使用 TypeScript，获得最佳开发体验
• 应用高级 TypeScript 模式，构建稳健的应用

测试与质量保障

• Vitest：原生支持 TypeScript 的快速单元测试框架
• Playwright：通过浏览器自动化进行端到端测试
• Biome：代码质量检查与格式化（统一、快速）

调试

• Chrome DevTools：针对浏览器和 Node.js 的高级调试工具
• Node.js Inspector：内置调试工具，支持断点和性能分析
• 堆快照：内存泄漏检测和堆分析
• 性能分析：CPU 性能分析、火焰图、瓶颈识别
• Vue DevTools：组件树、状态检查、性能监控

基本命令

# Bun-first workflow
bun create vite my-app --template vue-ts  # Create Vue 3 + TypeScript project
cd my-app && bun install                  # Install dependencies

# Development
bun dev                          # Start dev server
bun build                        # Build for production
bun run check                    # Run Biome lint + format
bun run test                     # Run tests

# Debugging
node --inspect script.js         # Node.js debugging
bun --inspect script.ts          # Bun debugging
node --prof script.js            # CPU profiling

最佳实践

项目结构

• 组织 Vue 3 项目，清晰分离组件、存储库和路由
• 使用优化项配置 vite.config.ts
• 实现适当的错误边界和加载状态
• 使用 Vue 3 的 Teleport 和 Suspense 实现高级 UI 模式

性能与安全

• 实施适当的 CSP 标头和安全配置
• 使用 Vite 的资源处理功能优化图片和资源
• 使用懒加载和代码拆分
• 进行适当的表单验证和清理

类型安全

// Modern type annotations (TypeScript 5.0+)
function processData(
    items: string[],
    config: Record<string, number>,
    optional?: string | null
): [boolean, string] {
    return [true, "success"];
}

有关详细的调试模式、Vue 3 组件结构、Vite 配置、生产环境调试和框架集成，请参阅 REFERENCE.md。