附录 C 常用命令速查
附录 C 常用命令速查
磨刀不误砍柴工。Vue 3 开发涉及很多工具——Vite、npm/pnpm、Git、Vue Router、Pinia 等。每个工具都有一套自己的命令,靠脑子记肯定记不住。这一章把最常用的命令整理成速查表,方便随时查阅。
C.1 Vite / npm / pnpm / yarn 常用命令
Vite 命令
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
| # 创建项目
pnpm create vite@latest my-app --template vue
pnpm create vite@latest my-app --template vue-ts # TypeScript 版本
# 开发模式(启动开发服务器)
pnpm dev
npm run dev
# 构建生产版本
pnpm build
# 预览构建产物(本地测试)
pnpm preview
# 预览构建产物(指定端口)
pnpm preview --port 3000
|
npm 命令
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
| # 初始化项目
npm init -y
# 安装依赖
npm install # 安装 package.json 中的所有依赖
npm install vue # 安装单个包
npm install -D typescript # 安装到 devDependencies
npm install -g @vue/cli # 全局安装
# 更新依赖
npm update vue
npm update # 更新所有依赖
# 删除依赖
npm uninstall vue
npm remove vue
# 查看
npm list # 查看已安装的包
npm list --depth=0 # 只看顶层依赖
npm view vue versions # 查看某个包的所有版本
# 运行脚本
npm run dev
npm run build
npm run test
# 缓存
npm cache clean --force # 清除 npm 缓存
|
pnpm 命令
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
| # 安装
pnpm install # 安装所有依赖
pnpm add vue # 安装单个包
pnpm add -D typescript # 安装到 devDependencies
pnpm add -g pnpm # 全局安装
# 更新
pnpm update
pnpm up vue
# 删除
pnpm remove vue
pnpm rm vue
# 其他
pnpm list # 查看已安装包
pnpm store status # 查看 pnpm 全局 store 状态
pnpm store prune # 清理未引用的包
pnpm init # 初始化项目(相当于 npm init -y)
|
yarn 命令
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
| # 安装
yarn install # 安装所有依赖
yarn add vue # 安装单个包
yarn add -D typescript # 安装到 devDependencies
# 更新
yarn upgrade
yarn up vue
# 删除
yarn remove vue
# 其他
yarn list # 查看已安装包
yarn init # 初始化项目
|
C.2 Pinia / Vue Router 命令
Pinia
Pinia 没有独立的 CLI 命令,主要是代码层面的 API:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
| // 创建 store
import { defineStore } from 'pinia'
export const useCounterStore = defineStore('counter', {
state: () => ({ count: 0 }),
actions: { increment() { this.count++ } }
})
// 使用 store
const store = useCounterStore()
store.increment()
console.log(store.count)
// $reset() 重置 state(选项式写法)
store.$reset()
// $patch 批量修改
store.$patch({ count: 10, name: '新名字' })
// $subscribe 订阅 state 变化
store.$subscribe((mutation, state) => {
console.log('state 变了')
})
// $onAction 监听 actions
store.$onAction(({ name, args }) => {
console.log(`action ${name} 被调用,参数:`, args)
})
|
Vue Router
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
| // 编程式导航
router.push('/user/123') // 跳转(留下历史记录)
router.replace('/about') // 替换(不留下历史记录)
router.go(-1) // 后退
router.go(1) // 前进
// 获取当前路由
const route = useRoute()
console.log(route.params.id) // 动态路由参数
console.log(route.query.page) // query 参数
console.log(route.path) // 当前路径
// 动态添加路由
router.addRoute({ path: '/new', component: NewPage })
// 动态删除路由
router.removeRoute('UserDetail')
|
C.3 Git 常用命令
基础配置
1
2
3
4
5
6
7
8
9
10
| # 设置用户名和邮箱
git config --global user.name "小明"
git config --global user.email "xiaoming@example.com"
# 生成 SSH 密钥
ssh-keygen -t ed25519 -C "xiaoming@example.com"
# 查看配置
git config --list
git config user.name
|
基础操作
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
| # 初始化仓库
git init
# 克隆仓库
git clone https://github.com/username/repo.git
git clone -b dev https://github.com/username/repo.git # 克隆指定分支
# 添加文件到暂存区
git add . # 添加所有文件
git add src/App.vue # 添加指定文件
git add -p # 交互式添加(选择性地添加修改的某一部分)
# 提交
git commit -m "feat: 添加用户登录功能"
git commit -am "fix: 修复列表翻页bug" # add + commit 合并(仅限已跟踪的文件)
# 查看状态
git status
git status -s # 简洁模式
# 查看差异
git diff # 工作区 vs 暂存区
git diff --staged # 暂存区 vs 最新提交
git diff HEAD # 工作区 vs 最新提交
git diff dev..main # dev 和 main 分支的差异
|
分支操作
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
| # 查看分支
git branch # 本地分支
git branch -a # 本地 + 远程分支
git branch -r # 仅远程分支
# 创建分支
git branch dev # 创建 dev 分支(不切换)
git checkout -b dev # 创建并切换到 dev 分支
git switch -c dev # 同上,git switch 是新语法
# 切换分支
git checkout dev
git switch dev
git checkout - # 切换到上一个分支
# 合并分支
git merge dev # 把 dev 合并到当前分支
# 删除分支
git branch -d dev # 安全删除(已合并才允许删除)
git branch -D dev # 强制删除
|
远程操作
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
| # 查看远程仓库
git remote -v
# 添加远程仓库
git remote add origin https://github.com/username/repo.git
# 推送
git push origin main # 推送到远程 main 分支
git push -u origin dev # -u 设置上游分支,以后可以直接 git push
git push # 推送当前分支到上游
# 拉取
git pull origin main # 拉取并合并
git fetch origin # 仅获取远程更新,不合并
# 删除远程分支
git push origin --delete dev
|
暂存与恢复
1
2
3
4
5
6
7
8
9
10
11
12
13
14
| # 暂存当前修改(不提交)
git stash # 暂存所有修改
git stash save "WIP: 用户模块"
git stash -u # 包括未跟踪的文件
# 恢复暂存
git stash pop # 恢复并删除 stash
git stash apply # 恢复但不删除 stash
git stash list # 查看 stash 列表
git stash drop # 删除 stash
# 恢复某个文件到某个版本
git checkout HEAD -- src/App.vue # 丢弃工作区的修改
git restore src/App.vue # 同上,git restore 是新语法
|
查看历史
1
2
3
4
5
6
7
8
9
| # 查看提交历史
git log
git log --oneline # 简洁模式
git log --graph # 图形化显示分支
git log -n 5 # 只看最近 5 条
# 查看某个文件的修改历史
git log -p src/App.vue
git blame src/App.vue # 按行查看最后修改人
|
标签操作
1
2
3
4
5
6
7
8
9
10
11
| # 创建标签
git tag v1.0.0
git tag -a v1.0.0 -m "第一个正式版本"
# 推送标签
git push origin v1.0.0
git push origin --tags # 推送所有标签
# 查看标签
git tag
git show v1.0.0
|
撤销操作
1
2
3
4
5
6
7
8
9
10
11
12
13
14
| # 撤销暂存
git reset HEAD src/App.vue # 把暂存区的文件移出暂存
# 撤销提交(保留工作区修改)
git reset --soft HEAD~1 # 撤销上一次提交,修改保留在暂存区
git reset --mixed HEAD~1 # 撤销上一次提交,修改保留在工作区(默认)
git reset --hard HEAD~1 # 撤销上一次提交,所有修改都丢弃(危险!)
# 撤销工作区修改
git checkout -- src/App.vue
git restore src/App.vue
# 反做某个提交
git revert HEAD # 创建一个新提交来撤销上一个提交
|
附录小结
本章整理了 Vue 3 开发中最常用的命令速查:
- Vite:dev、build、preview
- npm:install、update、run
- pnpm:add、remove、store
- Git:add/commit/push/pull、branch、stash、log、reset、revert
建议把这些命令打印出来贴在工位旁边,用多了自然就记住了。