以下内容面向在 Windows 上从零开始搭建 React 基础开发环境，强调稳定与可复现（版本明确、工具可控）。

1. 在“操作系统：Windows”上为“技术栈：React”建立基础开发环境（目标版本：Windows 11 23H2，Node.js 20.11）

• 操作系统要求
  • Windows 11 23H2（建议使用 x64 或 ARM64 原生架构，与 Node 架构一致）
  • 验证方法：按 Win+R 输入 winver 或在「设置 > 系统 > 关于」查看 Windows 规格为 23H2
• Node.js 管理策略
  • 使用 nvm-windows 管理并固定 Node 的精确版本（例如 20.11.1），确保切换与长期复现
  • 使用 Corepack 固定 pnpm 主版本并可进一步锁定补丁版本
• 包管理与工程初始化
  • 使用 pnpm 9（通过 Corepack 准备），在项目 package.json 中声明 "packageManager" 确保团队一致
  • 使用 Vite + React + TypeScript 初始化项目，并将 TypeScript 5 作为 devDependency 固定版本

2. 需要安装的关键工具

• 编译器/解释器
  • Node.js 20 LTS（精确到 20.11.1，通过 nvm-windows 管理）
  • TypeScript 5（建议作为项目 devDependency 固定版本，例如 5.4.x）
• 包管理器
  • pnpm 9（通过 Corepack 安装与版本固定）
• IDE/编辑器
  • Visual Studio Code（建议安装 ESLint、Prettier、ES7 React Snippets 等扩展）
• 辅助工具
  • Git（版本控制）
  • nvm-windows（Node 版本管理，确保版本可复现）
  • 可选：Windows Terminal 或 PowerShell 7（更佳终端体验）

3. 分步操作说明与命令列表（包含前置条件、安装步骤、版本验证、环境变量配置）

前置条件与系统检查

• 确认 Windows 版本：按 Win+R 输入 winver，确认为 23H2
• 使用 PowerShell（建议管理员权限）或 Windows Terminal 进行以下操作
• 如公司网络有代理，请提前准备代理地址，后续可在 npm/pnpm 中配置

安装 Git

• 命令：
  • winget install Git.Git
• 验证：
  • git --version
• 推荐基础配置（可选，避免换行符问题）：
  • git config --global user.name "Your Name"
  • git config --global user.email "you@example.com"
  • git config --global core.autocrlf false
  • git config --global core.filemode false

安装 nvm-windows（用于固定 Node 版本）

• 命令：
  • winget install CoreyButler.NVMforWindows
• 关闭并重新打开终端后验证：
  • nvm version
• 如 winget 不可用：到 https://github.com/coreybutler/nvm-windows/releases 下载 nvm-setup.exe 安装

通过 nvm 安装并启用 Node.js 20.11.1

• 安装精确版本：
  • nvm install 20.11.1
• 启用该版本：
  • nvm use 20.11.1
• 验证：
  • node -v 应为 v20.11.1
  • npm -v 应为 10.x（随 Node 20）
• 可选：设置为默认版本（在 nvm-windows 下，“最近一次的 use”即系统默认）
  • nvm list 查看已安装版本

启用 Corepack 并安装 pnpm 9

• 启用 Corepack（Node 20 已包含 Corepack）：
  • corepack enable
• 安装并固定 pnpm 主版本（两种策略，二选一）：
  • 若需固定到主版本 9（允许后续补丁升级）：corepack prepare pnpm@9 -g
  • 若需完全可复现（固定到具体补丁版本，示例）：
    • corepack prepare pnpm@9.0.0 -g
    • 说明：将 9.0.0 替换为团队确认的 9.x.y 具体版本
• 验证：
  • pnpm -v 期望输出为 9.x.y
• 可选：为 Windows 缩短 pnpm 存储路径，减少长路径问题：
  • pnpm config set store-dir C:\pnpm-store

安装 Visual Studio Code 与扩展

• 安装 VS Code：
  • winget install Microsoft.VisualStudioCode
• 验证：
  • code --version
• 安装常用扩展（在命令行）：
  • code --install-extension dbaeumer.vscode-eslint
  • code --install-extension esbenp.prettier-vscode
  • code --install-extension xabikos.JavaScriptSnippets 或 dsznajder.es7-react-js-snippets
• 在 VS Code 设置中将终端设置为 PowerShell 或 Windows Terminal（可选）

创建并配置 React + TypeScript 项目（使用 Vite）

• 新建工作目录：
  • mkdir C:\work\react && cd C:\work\react
• 使用 pnpm 创建 Vite 项目（推荐固定 create 工具版本，确保模板一致）：
  • 用 pnpm dlx （一次性执行，显式指定版本）：
    • pnpm dlx create-vite@5.0.0 my-react-app -- --template react-ts
    • 说明：如需更高版本，替换为团队确认的 create-vite@5.x.y，保持一致性
  • 进入项目：
    • cd my-react-app
• 在 package.json 中声明包管理器版本（确保团队一致，VS Code 也会识别）：
  • 将 "packageManager" 字段设置为 "pnpm@9" 或 "pnpm@9.x.y"
• 安装依赖：
  • pnpm install
• 固定 TypeScript 版本（示例使用 5.4.x，按团队决定具体补丁）：
  • pnpm add -D typescript@5.4.5
  • 验证 TypeScript：
    • npx tsc -v 或 pnpm exec tsc -v
• 运行开发服务器：
  • pnpm dev
  • 浏览器访问 http://localhost:5173（Vite 默认端口）

版本验证与可复现性要点

• 操作系统：
  • winver 查看为 23H2
• Node：
  • node -v 输出 v20.11.1
  • where node 确认路径指向 nvm 管理的目录（通常 C:\Program Files\nodejs 或 NVM_SYMLINK）
• npm：
  • npm -v 输出 10.x（随 Node 20）
• pnpm：
  • pnpm -v 输出 9.x.y（与 Corepack prepare 一致）
• TypeScript：
  • pnpm exec tsc -v 输出 5.x.y（与 devDependency 一致）
• Vite（项目内）：
  • 查看 package.json 中 vite 版本；如需固定，使用 pnpm add -D vite@5.x.y 并保持 create-vite 与 vite 的兼容矩阵
• packageManager：
  • package.json 中 "packageManager": "pnpm@9.x.y" 可被 Corepack识别并强制使用该版本

环境变量与路径说明（nvm-windows 会自动配置，如需手工检查）

• 系统环境变量应存在：
  • NVM_HOME（例如 C:\Users<User>\AppData\Roaming\nvm）
  • NVM_SYMLINK（例如 C:\Program Files\nodejs）
• PATH 包含：
  • %NVM_HOME%
  • %NVM_SYMLINK%
• 检查（PowerShell）：
• 若遇路径未生效：
  • 重新登录或在管理员 PowerShell 执行：
    • setx NVM_HOME "C:\Users<User>\AppData\Roaming\nvm"
    • setx NVM_SYMLINK "C:\Program Files\nodejs"
    • 将 "%NVM_HOME%;%NVM_SYMLINK%" 添加到系统 PATH 后重启终端

常见问题与建议

• 架构一致性：在 ARM64 设备上请安装 ARM64 版本的 nvm/Node/VS Code，避免 x64 仿真带来的路径和性能问题
• 权限与执行策略：若某些命令需要管理员权限，请使用“以管理员身份运行”的 PowerShell/Terminal
• 代理环境（如公司网络）：
  • npm config set proxy http://user:pass@host:port
  • npm config set https-proxy http://user:pass@host:port
  • pnpm config set proxy http://user:pass@host:port
• 项目锁定：
  • 将 pnpm-lock.yaml 纳入版本控制，确保依赖解析可复现
• 编辑器一致性：
  • 在项目中新增 .editorconfig 与 ESLint/Prettier 配置，统一缩进、换行与语法规则

通过以上步骤，你将获得在 Windows 11 23H2 上基于 Node.js 20.11 的可复现 React 开发环境，并在团队中用 Corepack + pnpm + packageManager 字段确保一致性。

以下指南旨在在 macOS 14 Sonoma 上搭建稳定、可复现的 Java 基础开发环境，使用 JDK 17.0.10，并配套 Maven 3.9 与 IntelliJ IDEA Community。

1. 在 macOS 14 Sonoma 上建立 Java 基础开发环境（JDK 17.0.10）

• 目标版本与架构：
  • 操作系统：macOS 14 Sonoma
  • Java 开发工具包：OpenJDK 17.0.10（Adoptium Temurin 构建）
  • 推荐架构识别：arm64（Apple Silicon M1/M2/M3）或 x86_64（Intel）
• 稳定性与可复现策略：
  • 使用 SDKMAN 管理与固定 Java/Maven 版本（便于版本固定与切换）
  • 可选：使用 Adoptium 官方 .pkg 安装精确版本（不依赖 Homebrew 版本更新）
  • IDE 版本不影响构建稳定性，但建议固定外部 Maven/JDK 路径供 IDE 使用

2. 需要安装的关键工具

• 编译器/运行时：
  • OpenJDK 17.0.10（Adoptium Temurin 构建）
• 包管理器/构建工具：
  • Apache Maven 3.9.x（建议 3.9.6，当前 3.9 系列稳定）
• IDE/编辑器：
  • IntelliJ IDEA Community（建议通过 Homebrew Cask 或 JetBrains 官网安装）
• 前置工具：
  • Xcode Command Line Tools（含 git、make 等基础工具）
  • SDKMAN（用于精确管理 JDK 与 Maven 版本）
  • 可选：Homebrew（用于安装 IDE、常用工具，不用于 JDK/Maven 版本固定）

3. 分步操作说明与命令列表

A. 前置条件与环境检查

• 确认系统版本与架构：
  • sw_vers
  • uname -m
  • 输出示例：arm64 为 Apple Silicon，x86_64 为 Intel
• 安装 Xcode Command Line Tools（含 git 等）：
  • xcode-select --install
  • 按提示完成安装（若已安装会提示已就绪）

B. 安装 SDKMAN（用于固定 Java/Maven 版本）

• 安装与初始化（默认 shell 为 zsh）：
  • curl -s "https://get.sdkman.io" | bash
  • source "$HOME/.sdkman/bin/sdkman-init.sh"
• 持久化到 zshrc（确保新终端自动加载）：
  • echo 'export SDKMAN_DIR="$HOME/.sdkman"' >> ~/.zshrc
  • echo '[[ -s "$SDKMAN_DIR/bin/sdkman-init.sh" ]] && source "$SDKMAN_DIR/bin/sdkman-init.sh"' >> ~/.zshrc
  • 重新加载：source ~/.zshrc

C. 安装并固定 JDK 17.0.10（Temurin）

• 列出可用版本（可选）：
  • sdk list java
• 安装精确版本并设为默认：
  • sdk install java 17.0.10-tem
  • sdk default java 17.0.10-tem
• 配置 JAVA_HOME 与 PATH（指向当前 SDKMAN 默认 Java）：
  • echo 'export JAVA_HOME="$HOME/.sdkman/candidates/java/current"' >> ~/.zshrc
  • echo 'export PATH="$JAVA_HOME/bin:$PATH"' >> ~/.zshrc
  • source ~/.zshrc
• 版本验证：
  • java -version
  • 期望输出包含：
    • openjdk version "17.0.10" 以及 Temurin/HotSpot 标识
  • javac -version
  • 期望输出：javac 17.0.10

可选：不使用 SDKMAN 的精确 JDK 安装（Adoptium .pkg）

• Apple Silicon (arm64)：
  • 访问：https://github.com/adoptium/temurin17-binaries/releases/tag/jdk-17.0.10%2B7
  • 下载：OpenJDK17U-jdk_aarch64_mac_hotspot_17.0.10_7.pkg
• Intel (x86_64)：
  • 下载：OpenJDK17U-jdk_x64_mac_hotspot_17.0.10_7.pkg
• 安装后设置 JAVA_HOME：
  • 对于 .pkg 安装，常用：
    • export JAVA_HOME=$(/usr/libexec/java_home -v 17)
    • echo 'export JAVA_HOME=$(/usr/libexec/java_home -v 17)' >> ~/.zshrc
    • echo 'export PATH="$JAVA_HOME/bin:$PATH"' >> ~/.zshrc
    • source ~/.zshrc
• 验证：
  • java -version（同上）

D. 安装并固定 Maven 3.9（推荐 3.9.6）

• 使用 SDKMAN 安装并设为默认：
  • sdk install maven 3.9.6
  • sdk default maven 3.9.6
• 验证：
  • mvn -version
  • 期望输出包含：
    • Apache Maven 3.9.6
    • Java version: 17.0.10
    • OS name: Mac OS X; OS version: 14.x; Arch: arm64 或 x86_64

可选：手动安装 Maven 3.9.6（无需 SDKMAN）

• 下载二进制包：
  • https://archive.apache.org/dist/maven/maven-3/3.9.6/binaries/apache-maven-3.9.6-bin.tar.gz
• 解压并配置 PATH：
  • mkdir -p ~/opt
  • tar -xzf ~/Downloads/apache-maven-3.9.6-bin.tar.gz -C ~/opt
  • echo 'export MAVEN_HOME="$HOME/opt/apache-maven-3.9.6"' >> ~/.zshrc
  • echo 'export PATH="$MAVEN_HOME/bin:$PATH"' >> ~/.zshrc
  • source ~/.zshrc
• 验证同上：mvn -version

E. 安装 IntelliJ IDEA Community

• 使用 Homebrew Cask（若未安装 Homebrew）：
  • 安装 Homebrew：
    • /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  • 添加到 PATH（如终端提示）并验证：
    • brew --version
  • 安装 IntelliJ IDEA Community：
    • brew install --cask intellij-idea-ce
• 或者从 JetBrains 官网下载并安装：
  • https://www.jetbrains.com/idea/download/ 选择 Community 版（macOS）
• 首次启动配置（确保 IDE 使用外部固定版本 JDK/Maven）：
  • 打开 Preferences > Build, Execution, Deployment > Build Tools > Maven：
    • Maven home directory：选择 ~/.sdkman/candidates/maven/current（或手动安装路径）
    • JDK for importer：选择 ~/.sdkman/candidates/java/current（或 /usr/libexec/java_home -v 17 返回的路径）
  • 新建项目时：
    • Project SDK：选择 JDK 17（指向上述路径）

F. 开发环境验证示例

• 创建并编译一个 Java 17 项目：
  • mkdir -p ~/workspace/hello-java && cd ~/workspace/hello-java
  • cat > src/Hello.java <<'EOF' public class Hello { public static void main(String[] args) { System.out.println("Hello, Java 17!"); } } EOF
  • javac src/Hello.java && java -cp src Hello
  • 期望输出：Hello, Java 17!
• 使用 Maven 构建（快速示例）：
  • mvn -version（再次确认）
  • mvn archetype:generate -DgroupId=com.example -DartifactId=demo -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false
  • cd demo && mvn clean package
  • 期望生成 target/demo-1.0-SNAPSHOT.jar 并构建成功

G. 常见冲突与排查

• 多个 JDK 并存导致版本不一致：
  • which java 和 echo $JAVA_HOME 检查指向是否为 ~/.sdkman/candidates/java/current
  • 若 /usr/bin/java 在前，确保 PATH 将 $JAVA_HOME/bin 放在前面
• Maven 使用的 Java 版本不对：
  • mvn -version 输出中 Java version 不为 17.0.10 时，检查 JAVA_HOME 与 PATH，再执行 source ~/.zshrc
• IntelliJ 未使用外部 Maven/JDK：
  • 在 Preferences 中明确选择 Maven home 与 Project SDK 指向上述固定路径

至此，您已在 macOS 14 Sonoma 上建立了可复现的 Java 17.0.10 开发环境，并配套 Maven 3.9 与 IntelliJ IDEA Community。建议将上述配置提交到团队文档，并在项目根目录使用 SDKMAN 的 .sdkmanrc（sdk env）固定版本，进一步提升团队一致性。