1. 安装Git
在Debian系统上,首先需要安装Git工具(若未安装),可通过以下命令完成:
sudo apt update && sudo apt install git
安装完成后,建议配置全局用户名和邮箱(用于提交记录标识):
git config --global user.name "Your Name"
git config --global user.email "your_email@example.com"
2. 初始化本地Git仓库
进入JavaScript项目的根目录,运行以下命令初始化仓库:
cd /path/to/your/javascript-project
git init
这会在项目目录中创建.git隐藏文件夹,用于存储版本控制的历史信息和配置。
3. 忽略不必要的文件
创建.gitignore文件,排除无需版本控制的文件(如node_modules/目录、依赖文件、日志文件等),避免仓库体积过大。示例.gitignore内容:
node_modules/
dist/
*.log
.env
将该文件保存到项目根目录即可。
4. 添加文件到暂存区与提交
将项目文件添加到Git暂存区(git add .表示添加所有文件,也可指定具体文件如git add src/index.js):
git add .
然后提交暂存区的更改到本地仓库,并附上清晰的提交信息(描述本次修改的内容):
git commit -m "Initial commit: Set up JavaScript project structure"
5. 关联远程仓库(可选但推荐)
若需将项目托管到远程平台(如GitHub、GitLab),需先在平台上创建空仓库(勿勾选“Initialize with README”),复制其HTTPS或SSH URL(如https://github.com/username/js-project.git)。然后在本地仓库中添加远程地址:
git remote add origin <remote_repository_url>
首次推送时,设置本地main分支(或master分支,取决于仓库默认分支)跟踪远程分支:
git push -u origin main
后续可直接使用git push同步本地更改到远程仓库。
6. 分支管理与协作(可选)
为隔离开发任务(如新功能、Bug修复),建议创建分支:
git checkout -b feature/new-login # 创建并切换到新分支
开发完成后,切换回主分支并合并:
git checkout main
git merge feature/new-login
若合并时出现冲突,需手动编辑冲突文件(Git会标记冲突位置),解决后重新提交:
git add conflict-file.js
git commit -m "Resolve merge conflict in feature/new-login"
最后推送合并后的主分支到远程仓库:
git push origin main