文章目录

0 前言

Node.js 版本管理工具主要有 nvm 和 fnm 两种选择:

  • fnm: Rust 编写, 启动速度快, 跨平台支持好, 内存占用小, 推荐优先使用
  • nvm: 社区成熟稳定, 文档和生态丰富, 但 shell 脚本实现导致启动较慢, 且不原生支持 Windows

两者都支持 .nvmrc 和 .node-version 文件, 可根据项目自动切换版本.

Node.js 包管理工具主要有 npm, yarn, pnpm, bun 四种选择:

  • pnpm: 硬链接 + 符号链接共享依赖, 安装速度快, 磁盘占用最小, 严格的依赖隔离避免幽灵依赖, 推荐优先使用
  • bun: Zig 编写的全能工具 (运行时 + 包管理 + 打包 + 测试), 安装速度极快, 但生态较新, 部分 Node.js API 兼容性待完善
  • yarn: Facebook 开发, 并行安装速度快, lockfile 可靠, 但 v1 和 v2+ 架构差异大, 功能与 npm 趋同
  • npm: Node.js 内置, 零配置开箱即用, 生态最成熟, 但安装速度较慢, node_modules 扁平化导致幽灵依赖问题

1 安装 nodejs

sudo apt update
sudo apt install -y unzip
curl -fsSL https://fnm.vercel.app/install | bash
source ~/.bashrc

fnm install 24 # 安装 v24 的最新版
fnm default 24 # 设置全局默认的 node 版本为 v24

修改 ~/.bashrc, 添加 --use-on-cd 参数, 可以在切换目录的时候自动识别 .nvmrc 和 .node-version, fnm 可以自动切换版本

# fnm
FNM_PATH="${HOME}/.local/share/fnm"
if [ -d "$FNM_PATH" ]; then
  export PATH="$FNM_PATH:$PATH"
  eval "`fnm env --use-on-cd`"
fi

2 安装 pnpm

npm install -g pnpm
pnpm setup
source ~/.bashrc

# 镜像源 (国内推荐 npmmirror, 海外保持官方源)
pnpm config set --global registry https://registry.npmmirror.com
pnpm config set --global registry https://registry.npmjs.org

3 安装组件

pnpm install -g @anthropic-ai/claude-code
pnpm install -g @google/gemini-cli
pnpm install -g @openai/codex

# 单次运行, 类似 npx
pnpm dlx ccg-workflow

# 检查更新
pnpm outdated -g

# 全局更新
pnpm update -g --latest

以上