Node.js项目在Linux上如何进行版本控制

在Linux环境下做Node.js开发，版本控制这件事，说简单也简单，说复杂也确实有不少门道。简单之处在于，只要搞定Git和nvm这两样工具，事情就成了一半。Git管代码，nvm管Node.js版本，这两兄弟配合好了，无论团队多少人，项目跑起来都不会因为环境不一致而出幺蛾子。下面，我们就把这个流程拆开揉碎了讲清楚。

一、准备工作：装好“两板斧”

1. 安装Git：代码的“时光机”

Git在Linux社区中扮演着基石角色，大多数发行版其实都自带。如果你的系统里没有，用包管理器装一下就行，命令很直接：

• Debian/Ubuntu的用户：sudo apt-get update && sudo apt-get install git
• RHEL/CentOS/Fedora的用户：sudo yum install git（或者用dnf install git）

装完后别急着走，敲一句git --version，看到版本号，才算大功告成。

2. 安装nvm：Node.js的“版本切换器”

Node.js版本迭代太快了，项目A可能还在用14.x，项目B已经上了20.x。nvm的核心价值就在于，它能让你在同一台机器上轻松切换和管理多个Node.js版本。安装也简单，一行命令搞定：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash

装完之后，别忘了重载一下Shell配置，比如source ~/.bashrc（如果你用的是zsh，就改成~/.zshrc）。最后，用nvm --version检验一下，确保它已经在线了。

二、核心流程：给项目套上“缰绳”

1. 初始化Git仓库：从“无版”到“有版”

进入你的项目根目录，执行：

git init

这一步会在文件夹里生成一个隐藏的.git目录，项目的版本控制之旅，就从这里开始。

2. 锁定Node.js版本：不许“串门”

如何保证所有开发者，包括未来的你，用的都是同一个Node.js版本？答案就在.nvmrc文件里。

• 在项目根目录下，创建一个.nvmrc文件，里面只写版本号：

  echo "18.17.1" > .nvmrc

• 当有新同事或者你在另一台机器上克隆项目后，进入目录，只需敲一句nvm use，nvm就会自动读取这个文件并切换到指定版本。如果本地没装这个版本，系统会提示你运行nvm install安装，非常省心。

3. 提交代码：拍下第一张“快照”

先把所有文件（排除.gitignore里指定的文件）加到暂存区：

git add .

如果你只想提交src/目录下的改动，可以把.换成src/。接着，生成第一个提交：

git commit -m "Initial commit: Set up Node.js project structure"

一个好的提交信息，就像给这张“快照”贴了标签，以后回来翻看时才不会一头雾水。

4. 连接远程仓库：让代码“上云”

在GitHub或GitLab上创建好远程仓库后，你需要把本地仓库和它关联起来：

git remote add origin 

然后，把你的main分支（也可能是master）推送到远程服务器：

git push -u origin main

加上-u参数，以后你再想推送，只需直接git push，不用每次都指定分支了。

三、日常维护：分支与依赖的艺术

1. 分支管理：别在主干上直接“动刀”

无论是开发新功能还是修Bug，都建议创建一个新分支。这是一种好习惯，能有效避免混乱。

• 创建并切换到新分支（比如feature/login）：

  git checkout -b feature/login

• 切换已有分支：git checkout
• 功能开发完毕，先切回main分支，再把新功能合并进来：

  git checkout maingit merge feature/login

2. 依赖锁定：确保环境“千人一面”

这才是版本控制的精髓所在。光有代码版本控制还不够，依赖是否一致也是个坑。你用的是A版本，同事用的是B版本，代码跑起来就是两个结果。

• 使用npm init -y快速生成package.json，记录项目依赖和脚本。
• 但问题的关键是package-lock.json这个文件。它锁定了每一个依赖包的精确版本。所以，务必把它俩都提交到Git仓库：

  git add package.json package-lock.jsongit commit -m "Add package.json and lock dependencies"

• 以后，无论谁克隆了项目，只需运行npm install，就能安装一套完全相同的依赖，这才是杜绝“在我电脑上明明是好的”这种问题的根本办法。

把这几步串联起来，一个可靠的Node.js项目版本控制体系就搭建好了。它就像一套精密的齿轮系统，既能隔离不同项目的依赖冲突，又能确保环境的一致性，让团队协作变得清晰而高效。