本地环境

环境配置的作用

本地环境记录项目所需的初始化与常用操作，帮助新工作树具备相同依赖。它不替代包管理器锁文件、项目 README 或权限配置；命令仍在真实主机上运行。

先确认项目要求

1. 从仓库文档和锁文件确认运行时、依赖管理器及版本。
2. 找出现有的安装、构建、测试和服务启动入口。
3. 区分一次性初始化与每次开发都要执行的操作。
4. 列出必须由你提供的外部服务与凭据。

创建与选择环境

在项目的本地环境设置中选择配置。环境可定义默认初始化脚本和平台专用脚本，并提供可重复执行的操作。工作树使用所选择的配置，选择信息可保存在该检出的 Git worktree 配置中。

为团队共享配置时，只保存命令与非敏感参数。路径应以检出目录为基准，避免写死某位开发者的绝对路径。

编写初始化脚本

#!/usr/bin/env bash
set -euo pipefail

# 使用仓库实际采用的依赖安装命令。
npm ci
npm run build

这是使用 npm 锁文件项目的示例；仓库采用其他工具时使用其真实入口。初始化脚本应尽量可重复执行，失败时非零退出，不隐藏安装错误。平台不同的命令分开维护。

初始化与常用操作

初始化适合安装依赖、生成可重建文件和准备开发资源；常用操作适合启动应用、执行测试和打开预览。不要把清理数据库、迁移生产数据或发布藏在自动初始化里。

失败后继续处理

初始化失败后已创建的工作树目录仍会保留。检查失败命令、依赖版本和网络，再在同一目录修复并验证；不要把“重试”变成重复创建检出或重复执行不可逆操作。

凭据与外部资源

环境配置文件不是凭据保险库。让必要凭据通过组织批准的方式提供给执行进程；只记录必需变量名称。并行环境分别选择服务端口、测试数据和临时资源，避免工作树之间相互覆盖。