开始前准备

终端、命令、路径
和项目目录分别是什么

解决“命令在哪里输入”和“为什么工具找不到项目”的问题。

预计阅读 9 分钟公开免费核验于 2026.08.19
内容目录 当前:第 03
开始前准备6
Agent 基础5
工具安装与配置6
模型与接口5
进阶专题5
本文目录 3 个部分

大家好,我是云途。安装失败时,真正的问题经常不是命令写错,而是命令在错误的目录里执行。

我们先把终端、Shell、路径和当前目录这四件事分清楚。

四个名字对应四件不同的事

终端是窗口,Shell 解释命令,路径指出位置,项目目录限定工作范围。终端输入窗口Shell解释命令路径指出位置项目限定范围
终端是窗口,Shell 解释命令,路径指出位置,项目目录限定工作范围。
终端

输入命令并查看输出的窗口。VS Code 也内置终端。

Shell

真正解释命令的程序,例如 zsh、bash 或 PowerShell。

路径

文件或文件夹在电脑中的位置。绝对路径从根位置写起,相对路径从当前目录算起。

项目目录

你允许 Agent 读取和修改的工作范围。打开正确项目,比先输入提示词更重要。

只记住四个安全命令

查看位置与内容SHELL
pwd          # 当前在哪里
ls           # 当前目录有什么
cd path      # 进入指定目录
cd ..        # 返回上一级
Windows PowerShell 中可使用 pwd、dir 和 cd 完成同类检查。

执行安装、启动或 Git 命令前,先用 pwdls 确认位置。看到项目的 package.json.git 或主要源码目录,再继续。

让 Agent 先报告工作范围

请先告诉我当前工作目录、识别到的项目根目录,以及你准备读取和修改的范围;现在不要改文件。

这句任务说明能提前发现路径错误。涉及多个同名项目、历史备份或正式版时,必须使用绝对路径确认目标。

完成检查

你已经能确认 Agent 在哪里工作

  • 能找到终端并识别当前 Shell。
  • 会用 pwd、ls 和 cd 确认目录。
  • 运行命令前能看见项目根目录的关键文件。

官方依据与延伸阅读

VS Code integrated terminalVS Code workspace