在 Debian 上进行 JS 版本控制
在 Debian 环境中，“JS 版本控制”通常包含两类目标：一是用 Git 对 JavaScript 源码进行版本控制；二是管理 Node.js 运行时与依赖的版本，确保开发与生产一致。下面给出可直接执行的步骤与最佳实践。
一、代码版本控制 Git 基础流程
- 安装与配置
- 安装：sudo apt update && sudo apt install git
- 配置：git config --global user.name “Your Name”、git config --global user.email “your_email@example.com”
- 仓库初始化与日常操作
- 初始化：git init
- 跟踪与提交：git add .、git commit -m “Initial commit”
- 远程与同步：git remote add origin 、git push -u origin main（若主分支为 master，替换为 master）
- 协作常用：git pull origin main、git status、git log
- 分支与合并
- 开发分支：git checkout -b feature/x
- 合并回主干：git checkout main、git merge feature/x
以上流程适用于任何 JavaScript 项目（前端或后端），是团队协作与持续交付的基础。
二、Node.js 与依赖的版本管理
- 选择策略
- 优先选择 Node.js LTS（如 18.x、20.x），兼顾稳定性与安全性；避免随意使用 Current 版本。
- 保持 开发与生产 Node 版本一致，减少“在我机器上能跑”的问题。
- 安装与切换 Node.js 的常用方式
- 使用 nvm（灵活、多版本并存，推荐）
- 安装：curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
- 使用：nvm install 18、nvm use 18、nvm alias default 18
- 使用 NodeSource 仓库（系统级安装指定版本）
- 示例：curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
- 安装：sudo apt-get install -y nodejs
- 使用 Volta（跨项目工具链管理）
- 安装：curl https://get.volta.sh | bash
- 使用：volta install node@18、volta pin node@18
- 依赖与锁文件
- 初始化：npm init -y
- 安装依赖：npm install （生产）、npm install -D （开发）
- 锁定版本：确保纳入 package-lock.json（或 yarn.lock）并提交到 Git，保证一致性
- 升级与维护：npm outdated、npm update、必要时使用 npm ci 进行干净安装
以上方法覆盖主流的 Node 版本管理与依赖锁定实践，适用于不同规模的项目与团队。
三、推荐的项目级配置与协作规范
- 版本锁定与一致性
- 将 package.json 与 package-lock.json（或 yarn.lock）纳入 Git；禁止提交 node_modules。
- 在 CI/生产环境使用 npm ci 而非 npm install，确保锁文件精确复现依赖树。
- 运行时版本约定
- 在仓库根目录放置 .nvmrc（示例：18 或 20），便于团队执行 nvm use 快速对齐版本。
- 如需跨机器一致性，可在 package.json 中添加 engines 字段（提示性约束）：
- 示例：“engines”: { “node”: “>=18 <21” }
- 变更记录与发布
- 采用 语义化版本（SemVer） 管理应用或库的版本；通过 npm version patch|minor|major 自动更新版本与标签，并配合 git push --follow-tags 推送。
- 基础 .gitignore 建议
- 忽略：node_modules/、.env、.env.local、dist/、.DS_Store 等与环境或构建产物相关的文件
四、快速上手清单
- 安装工具：sudo apt update && sudo apt install git
- 新建项目并初始化
- mkdir my-js-app && cd my-js-app
- git init
- npm init -y
- 选择 Node 版本
- 使用 nvm：nvm install 18 && nvm use 18 && nvm alias default 18
- 或创建 .nvmrc 写入 18 并在项目根目录执行 nvm use
- 安装依赖与锁定
- npm install express
- 确认 package-lock.json 已生成并提交到 Git
- 首次提交与远程推送
- git add .
- git commit -m “feat: init project with express”
- git remote add origin
- git push -u origin main
- 后续协作
- 开发分支：git checkout -b feature/login
- 合并与发布：完成后回到 main，git merge feature/login，按需 npm version patch 并推送
