导航
打印工作目录
pwd
pwd含义
打印终端当前工作目录的绝对路径。
使用场景
在执行依赖于位于项目文件夹中的命令之前运行它。
示例
pwd请求示例
检查终端当前所在的目录。
编程
常用终端命令
整理编辑、运行、测试和调试 Web 项目时常用的终端命令。
33 个命令
导航
列出文件。
ls
ls含义
列出当前目录中的文件和文件夹。
使用场景
用于确认预期的文件（例如 package.json、src 或 next.config.mjs）是否存在。
示例
ls请求示例
列出当前项目文件夹中的文件。
导航
更改目录
cd
cd ~/projects/my-web-app含义
将终端移动到另一个文件夹。
使用场景
在运行特定于项目的命令（例如 `npm run build`）之前，使用它。
注意
如果您位于错误的文件夹中，则命令可能会失败，即使该命令本身是正确的。
示例
cd ~/projects/my-web-app请求示例
在运行命令之前，移动到项目文件夹。
导航
clear screen
clear
clear含义
清除可见的终端输出，而不会更改文件或命令历史记录。
使用场景
在重新运行命令时，如果旧的输出看起来很嘈杂，则使用它。
示例
clear请求示例
在重新运行构建之前，清除终端。
文件和文件夹
显示文件内容。
cat
cat package.json含义
打印文件的内容到终端。
使用场景
用于小型文件，例如 `package.json`、配置文件或小型文本文件。
注意
对于非常大的文件，最好使用 sed、rg 或分页器，而不是打印所有内容。
示例
cat package.json请求示例
显示 package.json 脚本。
文件和文件夹
显示选定的行。
sed
sed -n '1,120p' src/components/SiteHeader.tsx含义
可以打印文件中选定的行。
使用场景
用于检查源代码文件中的一个部分，而无需打开整个文件。
示例
sed -n '1,120p' src/components/SiteHeader.tsx请求示例
显示 SiteHeader.tsx 的前 120 行。
文件和文件夹
make directory
mkdir
mkdir -p src/app/[locale]/reference/terminal-commands含义
创建一个新的文件夹。 `-p` 选项还会创建缺失的父文件夹，并在文件夹已存在时避免失败。
使用场景
在添加新的页面文件夹或资源文件夹之前，使用它。
示例
mkdir -p src/app/[locale]/reference/terminal-commands请求示例
为终端命令页面创建路由文件夹。
文件和文件夹
复制文件
cp
cp .env.example .env.local含义
将文件或文件夹复制到另一个位置。
使用场景
用于从示例文件创建本地配置，或复制模板。
注意
如果目标文件已存在，cp 命令可以覆盖它。
示例
cp .env.example .env.local请求示例
仅当不会覆盖本地设置时，才复制示例 env 文件。
文件和文件夹
移动或重命名。
mv
mv old-name.ts new-name.ts含义
移动文件或文件夹，或者在目标位于同一文件夹时重命名它。
使用场景
在更改文件名、路由文件夹名称或移动资源时使用。
注意
重命名路由文件夹会更改 URL。
示例
mv old-name.ts new-name.ts请求示例
重命名此文件，如果需要，并更新导入语句。
安全操作
删除文件。
rm
rm unused-file.ts含义
删除文件。 使用 `-r` 可以递归删除文件夹。
使用场景
仅当文件被有意从项目中删除时使用。
注意
rm is destructive. Check the path carefully before running it.
示例
rm unused-file.ts请求示例
在删除此文件之前，请说明将删除的内容。
搜索与检查
ripgrep 搜索。
rg
rg -n "errorMessageGuide" src含义
快速搜索文件中的文本。
使用场景
用于在编辑之前，查找导入、组件、slug、CSS 类或旧名称。
示例
rg -n "errorMessageGuide" src请求示例
搜索此组件被导入的位置。
搜索与检查
快速列出已跟踪的文件。
rg --files
rg --files src/app含义
快速列出文件路径，同时尊重常见的忽略规则。
使用场景
用于查找页面文件、组件和库，而无需扫描构建输出。
示例
rg --files src/app请求示例
在 src/app 下列出参考页面文件。
搜索与检查
find paths
find
find src -name 'page.tsx'含义
按照路径、名称或其他文件属性搜索文件系统。
使用场景
当通过文件名模式进行搜索，而不是通过文本内容进行搜索时使用。
示例
find src -name 'page.tsx'请求示例
查找所有 page.tsx 路由文件。
搜索与检查
统计行数或单词数
wc
wc -l src/lib/terminal-commands.ts含义
统计行数、单词数或字节数。
使用场景
用于估算文件大小，或在与其他命令结合使用时，计算搜索结果的数量。
示例
wc -l src/lib/terminal-commands.ts请求示例
统计此数据文件中有多少行。
包
安装依赖项
npm install
npm install含义
安装 package.json 和 package-lock.json 文件中列出的包。
使用场景
在克隆项目或缺少依赖项时，使用它。
注意
如果依赖项的版本解析方式不同，它可能会更改 package-lock.json 文件。
示例
npm install请求示例
仅当缺少 node_modules 时，才安装依赖项。
开发服务器
启动开发服务器
npm run dev
npm run dev含义
运行项目的本地开发服务器脚本。
使用场景
使用它在编辑时在浏览器中测试页面。
注意
正在运行的开发服务器会持续占用终端会话，直到停止。
示例
npm run dev请求示例
启动开发服务器，并告诉我本地 URL。
包
production build
npm run build
npm run build含义
运行生产构建脚本，并捕获许多编译、路由和类型问题。
使用场景
在部署或添加新页面之前运行它。
示例
npm run build请求示例
运行生产构建，并总结警告或错误。
包
代码检查。
npm run lint
npm run lint含义
运行项目的 lint 脚本，以捕获样式和静态代码问题。
使用场景
当您需要快速反馈时，在构建之前运行它。
示例
npm run lint请求示例
运行 lint 工具，并仅显示可操作的错误。
包
检查 Node 版本
node -v
node -v含义
打印已安装的 Node.js 版本。
使用场景
使用它，当项目需要特定的 Node 版本时。
示例
node -v请求示例
在解释此警告之前，检查 Node.js 版本。
包
运行包命令。
npx
npx next info含义
运行来自已安装或临时下载的 npm 包中的命令。
使用场景
用于单次工具命令，当不存在包脚本时。
注意
npx can download packages from the network if they are not installed.
示例
npx next info请求示例
解释这个 npx 命令是否需要网络访问。
Git
检查 Git 状态
git status
git status --short含义
显示当前分支以及已更改、已暂存或未跟踪的文件。
使用场景
在编辑、提交、拉取或切换分支之前运行它。
示例
git status --short请求示例
检查 Git 状态，并总结已更改的文件。
Git
显示代码差异。
git diff
git diff -- src/components/SiteHeader.tsx含义
展示已更改文件的逐行差异。
使用场景
使用它在提交之前查看确切的更改内容。
示例
git diff -- src/components/SiteHeader.tsx请求示例
审查此任务的差异。
Git
查看提交历史
git log
git log --oneline -5含义
展示提交历史。
使用场景
使用它来查看最近的工作，或找到要检查的提交。
示例
git log --oneline -5请求示例
显示最近的五个提交。
Git
场景变化
git add
git add src/lib/terminal-commands.ts含义
选择要包含在下一次提交中的更改。
使用场景
使用明确的路径进行有针对性的提交。
示例
git add src/lib/terminal-commands.ts请求示例
仅暂存与此终端命令页面相关的文件。
Git
保存提交。
git commit
git commit -m "Add terminal command reference"含义
将阶段性更改记录到 Git 历史中。
使用场景
在审查已暂存的更改后，使用它。
示例
git commit -m "Add terminal command reference"请求示例
使用清晰的消息提交已暂存的更改。
开发服务器
停止运行的命令
Ctrl+C
在开发服务器终端中按下 Ctrl+C。含义
停止当前正在运行的终端命令。
使用场景
使用它在关闭终端或更改端口之前停止本地开发服务器。
注意
在命令正在运行的终端会话中使用。
示例
在开发服务器终端中按下 Ctrl+C。请求示例
停止正在运行的开发服务器。
开发服务器
列出打开的文件和端口。
lsof
lsof -i :3001含义
可以显示哪个进程正在使用端口。
使用场景
使用它，当开发服务器出现 EADDRINUSE 错误时。
示例
lsof -i :3001请求示例
找到正在使用 3001 端口的进程。
开发服务器
列出进程。
ps
ps aux含义
显示正在运行的进程。
使用场景
用于检查正在运行的开发工具、服务器或后台进程。
示例
ps aux请求示例
检查 Next.js 开发服务器是否仍在运行。
安全操作
通过 PID 停止进程
kill
kill 12345含义
通过进程 ID 发送信号以停止进程。
使用场景
在服务器在正常中断不可用时继续运行时使用。
注意
仔细检查 PID，以避免停止错误的进程。
示例
kill 12345请求示例
在终止进程之前，请告诉我 PID 属于哪个进程。
网络
发送 HTTP 请求。
curl
curl -I http://localhost:3001/ko含义
从终端发送 HTTP 请求并打印响应。
使用场景
用于检查本地或已部署的 URL 是否返回 200、404、500 或重定向。
示例
curl -I http://localhost:3001/ko请求示例
使用 curl 检查此页面是否返回 200。
网络
检查网络连接
ping
ping 172.30.1.55含义
检查主机是否对基本的网络数据包做出响应。
使用场景
将其用作网络可达性的粗略检查，而不是 Web 应用程序的健康检查。
示例
ping 172.30.1.55请求示例
检查此设备是否可以访问开发机器的 IP 地址。
搜索与检查
查找可执行命令。
which
which node含义
显示哪个可执行文件将用于某个命令名称。
使用场景
当机器上可能存在不同的 Node、npm 或工具版本时使用。
示例
which node请求示例
检查正在使用的 Node 可执行文件。
安全操作
更改文件权限
chmod
chmod +x script.sh含义
更改文件上的读取、写入或执行权限。
使用场景
使用它，当需要使本地脚本可执行时。
注意
避免进行广泛的权限更改，例如 chmod -R 777。
示例
chmod +x script.sh请求示例
解释此脚本中最安全的权限更改。