本篇教程旨在帮助初学者在主流操作系统(Windows、macOS、Linux)上完成Git和Node.js的安装与基础配置,并掌握最核心的常用命令。
1. 写在前面
在开始编程之旅前,搭建一个高效的开发环境是第一步。Git 是目前最流行的版本控制系统 ,它能帮你记录代码的每一次变更,让你可以随心所欲地穿梭在代码的历史版本中,并与团队成员无缝协作。而 Node.js 则是一个 JavaScript 运行时环境,它让 JavaScript 突破了浏览器的限制,可以运行在服务器上,是现代前端与后端开发不可或缺的基础工具。本文将手把手带你安装并配置这两个工具。
2. Git 的安装与配置
Git 是一个开源的分布式版本控制系统,用于敏捷高效地处理任何或小或大的项目 。
2.1 在不同操作系统上安装 Git
Windows
-
下载安装包:访问 Git 官方网站 (https://git-scm.com/download/win),系统会自动推荐适合你 Windows 版本(64位或32位)的安装程序。
-
运行安装程序 :双击下载的
.exe文件。在安装选项中,有几个关键步骤需要注意:- 选择安装路径 :建议避免中文或空格路径,例如
C:\Git或D:\DevTools\Git。 - 选择组件 :推荐勾选
Git Bash Here和Git GUI Here,这会在右键菜单中添加便捷入口,方便在任何目录下打开 Git 命令行 。 - 调整 PATH 环境 :选择
Git from the command line and also from 3rd-party software。这个选项会将 Git 添加到系统环境变量中,让你可以在 CMD 或 PowerShell 中直接使用git命令 。 - 配置行结束符转换 :如果你主要在 Windows 下开发,选择默认的
Checkout Windows-style, commit Unix-style line endings即可,这有助于避免不同操作系统间换行符不一致引发的问题。
- 选择安装路径 :建议避免中文或空格路径,例如
-
验证安装 :安装完成后,打开 Git Bash (或在 CMD/PowerShell 中),输入以下命令:
bashgit --version如果看到类似
git version 2.4x.x.windows.1的输出,则说明安装成功 。
macOS
-
方法一:使用 Homebrew 安装(推荐)
- 如果你还没有安装 Homebrew,可以先在终端安装它。
- 在终端中执行命令:
brew install git。
-
方法二:使用官方安装包
- 访问 Git 官网下载页面,下载 macOS 版的安装程序
.dmg并运行。
- 访问 Git 官网下载页面,下载 macOS 版的安装程序
-
验证安装 :
bashgit --version
Linux
不同的 Linux 发行版使用不同的包管理器 。
-
Debian / Ubuntu :
bashsudo apt update sudo apt install git -
Fedora (22 及以上版本):
bashsudo dnf install git -
CentOS / RHEL :
bashsudo yum install git -
验证安装 :
bashgit --version
2.2 Git 的首次配置
安装完成后,你需要告诉 Git 你的身份信息。这一步至关重要,因为每次提交代码时,Git 都会将这些信息嵌入到记录中 。
bash
# 设置全局用户名和邮箱(替换成你的)
git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"
--global 参数代表这是一次全局配置,会影响你当前电脑上的所有 Git 仓库。如果想为某个特定项目设置不同的身份,可以在该项目目录下使用 --local 参数。
查看配置信息:
bash
# 查看所有全局配置
git config --global --list
# 或者查看特定项
git config user.name
git config user.email
其他实用配置(可选):
-
设置默认编辑器 (例如将默认的 nano 改为 VS Code):
bashgit config --global core.editor "code --wait" -
启用颜色输出 :让 Git 的命令行输出更美观易读 。
bashgit config --global color.ui auto -
设置命令别名 :减少敲击键盘的次数,例如将
git status简化为git st。bashgit config --global alias.st status git config --global alias.co checkout git config --global alias.br branch
2.3 Git 常用命令大全
掌握了安装和配置后,就可以开始使用 Git 了。下面将常用命令按功能分类 。
初始化与克隆
git init:在当前目录下初始化一个新的 Git 仓库,会生成一个隐藏的.git文件夹。git clone <仓库地址>:从远程服务器(如 GitHub、GitLab)克隆一个已有的仓库到本地。例如:git clone https://github.com/yourname/your-project.git。
日常提交与修改 (Working with Changes)
这是最核心的工作流:修改 -> 暂存 -> 提交。
git status:最常用的命令之一。查看当前工作区和暂存区的状态(哪些文件被修改了、哪些是新加的、哪些已暂存)。git add <文件名>:将指定的文件添加到 暂存区 ,准备提交。例如:git add index.html。git add .:将当前目录下所有变动(包括新建、修改、删除)的文件添加到暂存区 。git commit -m "提交说明":将暂存区中的所有文件提交到本地仓库,并附上一段清晰的说明信息 。git commit -a -m "说明":这是一个快捷方式,可以跳过git add步骤,直接将所有已被Git追踪的文件的修改提交(但对新文件无效)。
分支管理
分支让你可以并行开发功能,互不干扰 。
git branch:列出本地所有分支。当前所在分支前会有一个*号。git branch <分支名>:创建一个新的分支。git checkout <分支名>:切换到指定的分支。git checkout -b <分支名>:创建并立即切换到新分支,这是最常用的操作。git merge <分支名>:将指定分支的历史合并到当前所在分支。
远程仓库操作
与 GitHub/GitLab 等服务器进行交互 。
git remote -v:查看当前仓库配置的远程仓库地址。git push origin <分支名>:将本地指定分支的提交推送到远程仓库origin上。第一次推送时,可能需要加上-u参数建立关联:git push -u origin main。git pull:从远程仓库获取最新代码,并自动合并 到当前分支。相当于git fetch+git merge。git fetch:仅从远程仓库下载最新代码到本地,但不会自动合并,让你有机会先查看差异 。
查看历史与差异
git log:查看详细的提交历史。配合--oneline可以简化显示 。git reflog:"后悔药"神器。查看所有分支的所有操作记录(包括已被删除的提交),当你误操作丢失代码时,可以通过它找回。git diff:查看工作区中尚未暂存的修改内容 。git diff --staged:查看已暂存但尚未提交的修改内容。
撤销与恢复
git restore <文件>:撤销工作区中对某个文件的修改(危险操作,会丢失未提交的修改!)。git restore --staged <文件>:将文件从暂存区移回工作区,也就是撤销git add操作 。git reset HEAD~1:撤销最近的一次提交,但保留修改内容在工作区 。git reset --hard <提交ID>:极其危险的命令。强制将当前分支、工作区和暂存区都回退到指定的历史版本,之后的修改会全部丢失 。
临时保存
git stash:将当前未提交的工作(已跟踪文件的修改)暂时保存起来,让你可以切换到其他分支处理紧急事务 。git stash pop:恢复之前临时保存的工作,并从stash列表中删除该记录 。
3. Node.js 的安装与配置
Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行时环境,它让前端开发者可以用 JavaScript 写后端代码,同时也是现代前端工程化(如 Webpack)的基础 。
3.1 在不同操作系统上安装 Node.js
Windows & macOS
-
下载安装包 :访问 Node.js 官方网站 (https://nodejs.org/)。
- 左侧的 LTS (Long Term Support) 版本:推荐大多数用户下载。它稳定性高,bug 少,适合生产环境 。
- 右侧的 Current 版本:包含最新特性,但可能不够稳定,适合尝鲜者。
-
运行安装程序 :
- 双击下载的
.msi(Windows) 或.pkg(macOS) 文件。 - 关键步骤 :在安装向导中,务必确保勾选
Node.js runtime、npm package manager以及Add to PATH选项 。Add to PATH会自动配置环境变量,让你可以在命令行中直接使用node和npm命令。
- 双击下载的
-
验证安装 :安装完成后,打开终端(CMD、PowerShell 或终端),输入以下两个命令:
bashnode -v # 输出示例: v18.18.0 npm -v # 输出示例: 9.8.1如果能正常显示版本号,则代表 Node.js 和 npm(Node 包管理器)都已成功安装 。
Linux
对于 Linux,使用包管理器可能不会安装到最新版,更推荐使用 NodeSource 官方源或 nvm(Node Version Manager,节点版本管理器)安装。
方法:使用 NodeSource 二进制包(以 Ubuntu/Debian 为例)
bash
# 下载并执行 NodeSource 安装脚本(以安装 Node.js 18 LTS 为例)
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
# 安装 Node.js
sudo apt-get install -y nodejs
方法:使用 nvm(推荐开发者使用)
nvm 可以让你在同一台电脑上安装并切换多个 Node.js 版本,非常方便。
- 安装 nvm:参考其官网的安装脚本。
- 安装 Node.js LTS 版本:
nvm install --lts - 使用该版本:
nvm use --lts
3.2 Node.js 的优化配置 (npm 镜像加速)
npm 是 Node.js 自带的包管理器,但其默认的官方源在国外,下载速度可能很慢。建议将其替换为国内的淘宝镜像源 。
bash
# 设置 registry 为淘宝源
npm config set registry https://registry.npmmirror.com
# 验证是否设置成功
npm config get registry
# 如果返回 https://registry.npmmirror.com/,则代表配置成功
3.3 Node.js 和 NPM 常用命令大全
掌握这些命令,你就可以轻松管理项目依赖了 。
Node.js 相关命令
node -v:查看 Node.js 版本。node:在终端中直接进入 Node.js 的 REPL (交互式解释器) 环境,可以实时执行 JavaScript 代码。按两次Ctrl + C退出。node <文件名>.js:执行一个 JavaScript 文件。例如:node app.js。
NPM 包管理命令
npm -v:查看 npm 版本。npm init:初始化一个新项目 。会通过向导式问答在当前目录下生成一个package.json文件,这个文件记录了项目的元数据和所有依赖信息 。npm init -y:使用默认值快速生成package.json文件。
安装与卸载依赖
npm install:最常用的命令之一 。会根据项目根目录下的package.json和package-lock.json文件,安装所有列出的依赖到node_modules文件夹 。npm install <包名>:安装指定的包到当前项目的node_modules文件夹,并记录到package.json的dependencies(生产环境依赖)中。- 例如:
npm install express
- 例如:
npm install <包名> --save-dev:将包安装为开发依赖 (devDependencies),通常用于构建工具、测试框架等只在开发阶段需要的包。- 例如:
npm install webpack --save-dev
- 例如:
npm install -g <包名>:全局安装 一个包。安装后的包可以在系统的任何地方通过命令行调用,例如npm install -g yarn。npm uninstall <包名>:卸载指定包 。
查看与管理
npm list:列出当前项目安装的所有依赖包及其版本 。npm list -g --depth 0:列出全局安装的包(只显示顶层)。npm outdated:检查项目中哪些依赖包已经过时,可以升级。npm update:更新所有包到符合package.json限制的最新版本。
运行脚本
-
npm run <脚本名>:执行package.json文件的scripts字段中定义的脚本 。json// package.json 示例 { "scripts": { "start": "node app.js", "test": "echo \"Error: no test specified\" && exit 1" } }- 执行
npm run start(或简写npm start) 就会运行node app.js。 npm test同理。
- 执行
4. 总结
至此,你已经成功在你的电脑上安装了 Git 和 Node.js,并掌握了它们最核心的常用命令。
- Git 是你代码的时光机 和协作桥梁 ,请务必牢记
add、commit、push、pull这一基本工作流,并养成频繁提交、清晰备注的好习惯。 - Node.js 和 npm 则是你构建现代应用的工具箱 。
package.json是项目依赖的清单,而npm install则是你获取这些工具的方式。
现在,你的开发环境已经准备就绪,可以开始动手写代码了!如果在使用中遇到问题,可以通过 git help <命令> 或 npm help <命令> 来随时查阅官方文档。