开发环境与调试总览（2025）
本篇汇总 Node.js、IDE、虚拟化、Docker、网络调试等基础设施搭建要点，并融入现代工具（Volta、asdf、VS Code Dev Containers、Cloud IDE、AI 辅助调试）。
环境清单
- Node.js 运行时：推荐使用 LTS（当前 LTS：20.x，Active：22.x）。采用版本管理工具（nvm、Volta、asdf）便于多项目共存。
- IDE/编辑器：VS Code + 插件体系（ESLint、Prettier、GitLens、Copilot/Cursor）、JetBrains 系列、Neovim。
- 虚拟化/容器：本地虚拟机（VirtualBox、UTM、Parallels）、Docker Desktop、Colima/Lima；云开发环境（GitHub Codespaces、Gitpod）。
- Linux 基础：熟悉 Shell、包管理器（apt/yum/dnf）、文件权限、systemd、日志查看。
Node.js 与包管理
安装路径
- 官方安装包：https://nodejs.org/en
- Homebrew：
brew install node@20 - nvm（适合多版本）：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
sh
- Volta（跨平台、自动项目配置）：
curl https://get.volta.sh | bash
包管理与镜像
corepack enable启用官方包管理代理，安装 pnpm/yarn。- 国内镜像：
npm config set registry https://registry.npmmirror.com。 nrm快速切换源；pnpm适合 monorepo。- 使用
npm audit、pnpm audit、snyk定期扫描依赖安全。
IDE 与调试
- VS Code：推荐扩展
ESLint、Prettier、Debugger for Chrome、Thunder Client、Docker、Dev Containers、CodeLLDB、GitHub Copilot。 - JetBrains WebStorm：使用 Toolbox 管理，启用 TS Server、HTTP Client、Docker 插件。
- AI 助手：Copilot、Cursor、通义灵码、ByteDance Doubao 提升调试效率，但需保持代码审查。
本地虚拟化与云环境
- 虚拟机：用于模拟 Linux 生产环境，建议 2C4G+40G 磁盘；配置 Docker、Kubernetes、数据库。
- Docker/Container：
- macOS：Docker Desktop、Colima（轻量替代）、Rancher Desktop。
- Linux：
curl -fsSL https://get.docker.com | sh；使用docker compose v2管理多容器。 - Windows：WSL2 + Docker Desktop；启用虚拟化支持。
- 国内镜像加速：在
~/.docker/daemon.json（或 Docker Desktop Settings → Docker Engine）中配置registry-mirrors，例如：{ "registry-mirrors": [ "https://docker.m.daocloud.io", "https://hub-mirror.c.163.com", "https://mirror.ccs.tencentyun.com" ] }json
Reload Docker 后生效；阿里云、华为云等亦提供专属镜像地址，可在控制台生成并替换。
- Dev Containers：
.devcontainer目录定义统一环境；适用于多人协作、CI/CD。 - Cloud IDE：GitHub Codespaces、Gitpod、阿里云 Cloud IDE 支持从浏览器直接开发。
网络与调试工具
curl、httpie、wget、grpcurl- 浏览器 DevTools：Network、Performance、Lighthouse、Recorder
- 抓包：Charles、Proxyman、Fiddler、mitmproxy
- 日志 & 监控：
journalctl、dmesg、htop、bpytop
自动化与脚本
- Shell（bash/zsh/fish）脚本化常用任务。
- 使用
Makefile、just、taskfile.yml管理命令。 - 结合 CI/CD（GitHub Actions、GitLab CI、Jenkins、飞书 CI）执行 lint/test/build/deploy。
安全与合规注意
- 对项目使用
.nvmrc/.node-version标明 Node 版本。 - 配置
.npmrc/.pnpmfile.cjs管控registry与预处理。 - 对终端命令启用别名/函数时注意安全（避免覆盖系统命令）。
- 虚拟机/容器开放端口时配置防火墙与访问控制。
更多细节请参考子目录：
brew.md（包管理）、shell.md（Shell 选择与美化）、VM固定IP设置.md（虚拟机网络）等。根据团队情况选择合适方案，定期更新工具链。
↑