diff --git a/README.md b/README.md index 7ccf7f7..a5fe273 100644 --- a/README.md +++ b/README.md @@ -28,17 +28,14 @@ docker run -d --name rawmark \ ## 开发 -需要 Go 1.27+ 与 Node 24+。开发时不必构建前端或 Docker 镜像，开两个终端： +需要 Go 1.27+ 与 Node 24+。开发时不必构建前端或 Docker 镜像，一键启动： ```sh -# 终端 1：后端（-tags dev 不嵌入前端资源，数据放在仓库下的 .dev-data/） -RAWMARK_DATA=.dev-data RAWMARK_ADDR=127.0.0.1:8080 go run -tags dev ./cmd/rawmark - -# 终端 2：前端（热更新，/api 与 WebSocket 转发到 127.0.0.1:8080） -cd web && npm install && npm run dev +scripts/dev.sh # 后端 go run -tags dev + 前端 Vite 热更新，Ctrl+C 同时退出 +scripts/dev.sh --host # 前端监听所有网卡，手机访问 http://<电脑 IP>:5173 ``` -浏览器打开 http://localhost:5173 ，启动码在 `.dev-data/setup-code.txt`。手机调试用 `npm run dev -- --host`，再访问 `http://<电脑 IP>:5173`。 +浏览器打开 http://localhost:5173 ，启动码在 `.dev-data/setup-code.txt`。端口与数据目录可用 `API_PORT`、`WEB_PORT`、`RAWMARK_DATA` 覆盖，详见 `scripts/dev.sh --help`。 检查： diff --git a/scripts/dev.sh b/scripts/dev.sh new file mode 100755 index 0000000..b5aae39 --- /dev/null +++ b/scripts/dev.sh @@ -0,0 +1,93 @@ +#!/usr/bin/env bash +# 一键启动开发环境：Go 后端（go run -tags dev）+ Vite 前端（热更新），Ctrl+C 同时退出。 +# +# 用法：scripts/dev.sh [--host] +# --host 前端监听所有网卡，便于手机/平板通过局域网访问 +# +# 环境变量： +# RAWMARK_DATA 开发数据目录，默认 <仓库>/.dev-data +# API_PORT 后端端口，默认 8080（Vite 代理读取同一变量） +# WEB_PORT 前端端口，默认 5173 +set -euo pipefail + +ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)" +cd "$ROOT" + +export RAWMARK_DATA="${RAWMARK_DATA:-$ROOT/.dev-data}" +export API_PORT="${API_PORT:-8080}" +WEB_PORT="${WEB_PORT:-5173}" +VITE_ARGS=(--port "$WEB_PORT" --strictPort) + +for arg in "$@"; do + case "$arg" in + --host) VITE_ARGS+=(--host) ;; + -h | --help) + sed -n '2,10p' "$0" | sed 's/^# \{0,1\}//' + exit 0 + ;; + *) + echo "未知参数：$arg（可用 --host、--help）" >&2 + exit 1 + ;; + esac +done + +# Go 默认安装位置可能不在非登录 shell 的 PATH 中 +[[ -d /usr/local/go/bin ]] && export PATH="$PATH:/usr/local/go/bin" + +fail() { + echo "错误：$*" >&2 + exit 1 +} + +command -v go >/dev/null || fail "未找到 go，请安装 Go 1.27 或更高版本" +command -v node >/dev/null || fail "未找到 node，请安装 Node.js 24 或更高版本" +command -v npm >/dev/null || fail "未找到 npm" + +port_in_use() { + if command -v ss >/dev/null; then + ss -ltn "sport = :$1" | grep -q LISTEN + else + (exec 3<>"/dev/tcp/127.0.0.1/$1") 2>/dev/null + fi +} +port_in_use "$API_PORT" && fail "端口 $API_PORT 已被占用（后端）" +port_in_use "$WEB_PORT" && fail "端口 $WEB_PORT 已被占用（前端）" + +# 依赖缺失或 package-lock.json 有更新时才安装 +if [[ ! -d web/node_modules || web/package-lock.json -nt web/node_modules/.package-lock.json ]]; then + echo "==> 安装前端依赖" + (cd web && npm install --no-fund --no-audit) +fi + +# 退出时结束本脚本启动的所有子进程（包括 go run 编译出的服务进程） +cleanup() { + trap - EXIT INT TERM + echo + echo "==> 正在停止" + kill 0 2>/dev/null || true +} +trap cleanup EXIT INT TERM + +# 给两路日志加前缀，便于区分 +prefix() { sed -u "s/^/[$1] /"; } + +echo "==> 启动后端 http://127.0.0.1:$API_PORT（数据目录 $RAWMARK_DATA）" +RAWMARK_ADDR="127.0.0.1:$API_PORT" go run -tags dev ./cmd/rawmark 2>&1 | prefix server & + +# 等后端就绪后再启动前端，避免首次编译期间前端请求失败 +for _ in $(seq 1 120); do + curl -fs "http://127.0.0.1:$API_PORT/api/v1/health" >/dev/null 2>&1 && break + sleep 0.5 +done +curl -fs "http://127.0.0.1:$API_PORT/api/v1/health" >/dev/null 2>&1 || fail "后端 60 秒内未就绪，请查看上方 [server] 日志" + +if [[ -f "$RAWMARK_DATA/setup-code.txt" ]]; then + echo "==> 首次使用：启动码在 $RAWMARK_DATA/setup-code.txt" +fi + +echo "==> 启动前端 http://localhost:$WEB_PORT" +(cd web && exec npx vite "${VITE_ARGS[@]}") 2>&1 | prefix web & + +# 任一进程退出（如后端崩溃）即整体停止 +wait -n diff --git a/web/vite.config.ts b/web/vite.config.ts index ec0a9c6..6ba7ca8 100644 --- a/web/vite.config.ts +++ b/web/vite.config.ts @@ -11,8 +11,8 @@ export default defineConfig({ }, worker: { format: 'es' }, server: { - // 开发时把 API 与 WebSocket 转发给本地 Go 服务 - proxy: { '/api': { target: 'http://127.0.0.1:8080', ws: true } }, + // 开发时把 API 与 WebSocket 转发给本地 Go 服务（端口与 scripts/dev.sh 的 API_PORT 一致） + proxy: { '/api': { target: `http://127.0.0.1:${process.env.API_PORT ?? 8080}`, ws: true } }, }, test: { environment: 'node' }, })