命令、文件和配置

命令进入终端

终端是您为计算机输入指令的窗口。在 Visual Studio Code 中，首先使用文件 → 打开文件夹打开您的 supastack 文件夹，然后选择终端 → 新终端。新终端在该文件夹中启动。在 Windows 上，使用终端 + 按钮旁边的菜单选择 PowerShell。在 macOS 或 Linux 终端中使用 macOS/Linux 块。

仅粘贴命令块的内容，一次一个命令，然后按 Enter。请勿粘贴周围的 Markdown 反引号、PS C:\... 等提示或示例输出。以#开头的行是解释；他们不管理任何东西。等待每个安装命令完成，然后再输入下一个命令。服务器命令持续运行，并且在您停止它之前不会返回新的提示。

检查终端正在使用哪个文件夹

存储库根是指包含 package.json、pnpm-workspace.yaml、apps 和 packages 的顶级 supastack 文件夹。除非步骤另有说明，否则请在此处运行命令。下面的命令打印当前文件夹；文件列表应显示 package.json。在 Windows PowerShell pwd 和 ls 中也可以使用。

如果列表仅显示 apps/web 或 apps/mobile 的内容，请键入 cd ../.. 并按 Enter 键返回到根目录。如果它显示您的主文件夹，请键入 cd，后跟一个空格和克隆的完整路径，当包含空格时用引号引起来。在编辑器中打开项目文件夹并创建新终端通常更容易。

pwd
ls

配置位于文件中，而不是终端中

像 AI_PROVIDER=fake 这样的块是配置文本。在编辑器中打开命名的 .env 文件，找到以 AI_PROVIDER= 开头的行，替换其值并使用 Ctrl + S（macOS 上的 Command + S）保存。 KEY=value 形式中，每个设置占一行。不要添加 Markdown 反引号。避免在一个文件中重复复制同一密钥。

使用 root .env 执行数据库迁移命令，使用 apps/web/.env.local 执行 Next.js Web 服务器，使用 apps/mobile/.env.local 执行 Expo。 Next 和 Expo 在它们自己的应用程序文件夹中运行，并且不会自动加载 root .env。如果数据库连接发生更改，请更新 root .env 和 apps/web/.env.local 中的 DATABASE_URL，以便迁移和服务器使用相同的数据库。保持示例文件不变以供将来参考。

名称以点开头的文件可能隐藏在您的文件管理器中；编辑器的资源管理器显示了它们。确保文件名完全是 .env.local，而不是 .env.local.txt。这些本地文件可以包含密码，并且被排除在 Git 之外；不要上传它们或将其内容粘贴到支持消息中。

• 查找各个设置的含义

保持服务器运行；使用另一个终端来执行命令

开发服务器在您工作时为您的应用程序提供服务。当教程说打开 localhost:3000 时，将其终端保持打开状态。 localhost 表示这台计算机； :3000 是端口，就像应用程序使用的编号门。将 URL 放入浏览器的地址栏，而不是终端。

要在服务器处于活动状态时运行另一个命令，请在编辑器中选择 Terminal → New Terminal。新终端是同一项目的一个单独窗口。要停止服务器，请选择其终端并按 Ctrl + C 一次。在 Windows 上，如果询问终止批处理作业，请键入 Y 并按 Enter。等待正常提示后再重新启动。

编辑 Web 环境设置后，使用以下命令停止并重新启动 Web 服务器。保存源文件通常会自动刷新页面，但环境更改需要重新启动。编辑 Expo 设置后，停止 Expo，然后运行 ​​corepack pnpm --filter @supastack/mobile start --clear 重新启动并清除其缓存的包。

corepack pnpm --filter @supastack/web dev

阅读失败并寻求有用的帮助

如果安装返回红色错误文本，请停止该步骤。阅读第一个错误，而不是继续启动应用程序。找不到命令通常意味着缺少工具；没有package.json通常意味着错误的文件夹； ECONNREFUSED通常表示所需的服务器或数据库未运行； EADDRINUSE 表示另一个进程已使用该端口。

寻求帮助时，请提供您的操作系统、指南 URL 和步骤号、您输入的确切命令以及第一条错误消息。删除任何数据库 URL 的密码、API 密钥、令牌和密码部分。不要发送您的 .env 文件。错误的屏幕截图可能会有所帮助，但可复制的文本更容易诊断。

• 解决特定设置失败