跨平台Hook兼容性指南

# 错误做法：硬编码路径分隔符 PATH_TO_CONFIG="./config/settings.json" # 在Windows上使用正斜杠可行（大多数程序支持） PATH_TO_BIN=".\tools\build.bat" # 在Unix上完全无效 # 推荐做法：使用编程语言的标准库处理路径 # Python示例（推荐用于跨平台脚本） import os import os.path as osp config_path = osp.join("config", "settings.json") # Windows上输出: config\settings.json # Linux/macOS上输出: config/settings.json # 如果是用户提供的输入路径，使用 os.path.normpath 规范化 user_input = "config//settings.json" normalized = osp.normpath(user_input) # 自动处理多余分隔符和平台差异 # 获取当前系统路径分隔符 print(f"路径分隔符: {os.sep}") # Windows: \, Linux/macOS: / print(f"路径列表分隔符: {os.pathsep}") # Windows: ;, Linux/macOS: :

# Shell脚本中获取用户主目录 # 错误做法：假设变量名 HOME_DIR=$HOME # Windows Git Bash中有效，但原生CMD/PowerShell中没有$HOME USER_DIR=%USERPROFILE% # 仅在Windows CMD中有效 # 推荐做法：使用条件判断 #!/bin/bash if [ -n "$HOME" ]; then USER_HOME="$HOME" elif [ -n "$USERPROFILE" ]; then USER_HOME="$USERPROFILE" else USER_HOME=$(dirname "$(realpath ~)" 2>/dev/null || echo "/tmp") fi echo "用户主目录: $USER_HOME" # 更可靠的方式：使用Python python3 -c "import os; print(os.path.expanduser('~'))" # Node.js方式 node -e "console.log(require('os').homedir())" # 常见用户目录对应关系： # Windows: C:\Users\用户名 # macOS: /Users/用户名 # Linux: /home/用户名

# 换行符差异详解 # Windows: CRLF (\r\n) —— 回车+换行 # macOS/Linux: LF (\n) —— 仅换行 # 旧版macOS (9.x及以前): CR (\r) # Git配置建议：让Git自动处理换行符 # 全局配置（建议所有项目使用） git config --global core.autocrlf input # Windows: core.autocrlf true （签出时CRLF，提交时LF） # macOS/Linux: core.autocrlf input （签出时LF，提交时LF） # 项目级配置（在.gitattributes中指定） cat > .gitattributes << 'EOF' # 所有文本文件自动规范化换行符 * text=auto # 特定文件类型指定换行符 *.sh text eol=lf # Shell脚本始终使用LF *.bat text eol=crlf # Windows批处理使用CRLF *.ps1 text eol=crlf # PowerShell脚本使用CRLF *.py text eol=lf # Python文件使用LF *.js text eol=lf # JavaScript文件使用LF *.json text eol=lf # JSON文件使用LF *.md text eol=lf # Markdown文件使用LF EOF # 检查文件换行符 # Linux/macOS: file命令 file script.sh # 输出: script.sh: Bourne-Again shell script, ASCII text executable # 使用file命令检查CRLF file script.sh # 如果包含CRLF: script.sh: ASCII text, with CRLF line terminators # 批量转换换行符 # LF → CRLF sed -i 's/$/\r/' script.sh # CRLF → LF sed -i 's/\r$//' script.sh # 使用dos2unix/unix2dos工具（如果已安装） dos2unix script.sh # CRLF → LF unix2dos script.sh # LF → CRLF

# Unix权限模型 # 权限位: rwx rwx rwx (owner/group/others) # chmod 755 = rwxr-xr-x # chmod 700 = rwx------ # 设置可执行权限（Linux/macOS） chmod +x hook-script.sh # 验证权限 ls -la hook-script.sh # 输出: -rwxr-xr-x 1 user group 1234 May 8 10:00 hook-script.sh # Windows权限模型 # Windows不依赖权限位来判断可执行性，而是通过： # 1. 文件扩展名（.exe/.bat/.ps1/.cmd表示可执行） # 2. NTFS ACL（访问控制列表） # 3. 文件关联（如.py文件通过Python解释器执行） # 跨平台权限检查函数（Shell） #!/bin/bash is_executable() { local file="$1" if [ "$(uname)" = "Darwin" ] || [ "$(uname)" = "Linux" ]; then [ -x "$file" ] && return 0 || return 1 elif [ "$(uname -o 2>/dev/null)" = "Msys" ] || \ [ -n "$WINDIR" ]; then # Windows上通过扩展名判断 case "$file" in *.exe|*.bat|*.cmd|*.ps1|*.com) return 0 ;; *) return 1 ;; esac fi return 1 } # Python方式（推荐） import os import platform def is_executable(filepath): if platform.system() == "Windows": ext = os.path.splitext(filepath)[1].lower() return ext in {".exe", ".bat", ".cmd", ".ps1", ".com"} else: return os.access(filepath, os.X_OK)

#!/bin/bash # 跨平台平台检测函数 # 适用于 Bash/Zsh (Git Bash, WSL, macOS, Linux) detect_platform() { local os="" local arch="" case "$(uname -s)" in Linux) os="linux" # 检测是否为WSL（Windows Subsystem for Linux） if grep -qi microsoft /proc/version 2>/dev/null; then os="wsl" fi ;; Darwin) os="macos" ;; CYGWIN*|MINGW*|MSYS*) os="windows" ;; *) os="unknown" ;; esac # 检测架构 case "$(uname -m)" in x86_64|amd64) arch="x64" ;; aarch64|arm64) arch="arm64" ;; i386|i686) arch="x86" ;; *) arch="unknown" ;; esac echo "${os}_${arch}" } PLATFORM=$(detect_platform) echo "当前平台: $PLATFORM" # 可能的输出: # linux_x64 — Linux x86_64 # macos_arm64 — macOS Apple Silicon # windows_x64 — Windows (Git Bash/MSYS2) # wsl_x64 — WSL Ubuntu等

#!/bin/bash # 跨平台命令执行模式示例 # 检测平台 OS="$(uname -s)" # 模式一：使用case语句执行不同命令 case "$OS" in Darwin) # macOS 命令 SED_CMD="sed -i ''" GREP_CMD="grep -E" FIND_CMD="find -E" ECHO_CMD="echo" ;; Linux) # Linux 命令 SED_CMD="sed -i" GREP_CMD="grep -P" FIND_CMD="find" ECHO_CMD="echo" ;; CYGWIN*|MINGW*|MSYS*) # Windows (Git Bash) SED_CMD="sed -i" GREP_CMD="grep -P" FIND_CMD="find" ECHO_CMD="echo" ;; *) echo "不支持的平台: $OS" exit 1 ;; esac # 使用平台特定的命令 $SED_CMD 's/foo/bar/g' config.txt # 模式二：直接使用if条件判断 if [ "$OS" = "Darwin" ]; then # macOS特定的处理 DEFAULT_GATEWAY=$(route -n get default | grep gateway | awk '{print $2}') elif [ "$OS" = "Linux" ]; then # Linux特定的处理 DEFAULT_GATEWAY=$(ip route | grep default | awk '{print $3}') else # Windows (Git Bash) DEFAULT_GATEWAY=$(netstat -rn | grep "0.0.0.0" | head -1 | awk '{print $3}') fi echo "默认网关: $DEFAULT_GATEWAY" # 模式三：尝试多个命令（fallback模式） # 先尝试macOS命令，失败则尝试Linux命令 if ! command -v realpath &>/dev/null; then # macOS没有realpath，使用greadlink（如果安装了coreutils） if command -v greadlink &>/dev/null; then realpath() { greadlink -f "$1"; } else # 最后fallback：使用Python realpath() { python3 -c "import os.path; print(os.path.abspath('$1'))"; } fi fi # 模式四：检测命令是否存在 if command -v python3 &>/dev/null; then PYTHON=python3 elif command -v python &>/dev/null; then PYTHON=python elif command -v py &>/dev/null; then # Windows Python Launcher PYTHON=py else echo "错误：未找到Python" exit 1 fi echo "使用Python: $PYTHON"

# Node.js实现跨平台路径和Shell命令执行 # 保存为 cross-platform-hook.js const os = require("os"); const path = require("path"); const fs = require("fs"); const { execSync } = require("child_process"); // 检测当前平台 const platform = os.platform(); // 'win32', 'darwin', 'linux' const homedir = os.homedir(); // 跨平台获取用户主目录 const tmpdir = os.tmpdir(); // 跨平台获取临时目录 // 跨平台路径处理 const configPath = path.join(homedir, ".config", "myapp", "config.json"); console.log(`配置文件路径: ${configPath}`); // 跨平台执行Shell命令 function runCommand(cmd) { const options = {}; if (platform === "win32") { options.shell = "powershell.exe"; // Windows使用PowerShell } else { options.shell = "/bin/bash"; // Unix使用Bash } return execSync(cmd, options).toString().trim(); } // 跨平台获取环境变量 const envVar = platform === "win32" ? process.env.USERPROFILE || process.env.HOMEDRIVE + process.env.HOMEPATH : process.env.HOME; // 跨平台文件权限检查 function isExecutable(filePath) { try { fs.accessSync(filePath, fs.constants.X_OK); return true; } catch { // Windows上X_OK总是返回true，改用扩展名判断 if (platform === "win32") { const ext = path.extname(filePath).toLowerCase(); return [".exe", ".bat", ".cmd", ".ps1"].includes(ext); } return false; } } // 跨平台创建临时文件 function createTempFile(prefix, content) { const tmpFile = path.join( tmpdir, `${prefix}_${Date.now()}_${Math.random().toString(36).slice(2)}` ); fs.writeFileSync(tmpFile, content, "utf8"); return tmpFile; } console.log(`当前平台: ${platform}`); console.log(`用户主目录: ${homedir}`); console.log(`临时目录: ${tmpdir}`); // 执行跨平台命令示例 if (platform === "win32") { console.log(runCommand("Get-ChildItem Env:USERNAME | Format-List")); } else { console.log(runCommand("whoami")); }

# Python实现跨平台Hook（推荐方案） # 保存为 cross-platform-hook.py import os import sys import platform import subprocess import tempfile import shutil from pathlib import Path # ============================================ # 跨平台环境检测 # ============================================ system = platform.system() # 'Windows', 'Darwin', 'Linux' machine = platform.machine() # 'x86_64', 'arm64' 等 is_windows = system == "Windows" is_macos = system == "Darwin" is_linux = system == "Linux" # ============================================ # 跨平台路径处理（推荐使用pathlib） # ============================================ # Pathlib跨平台路径构建 config_dir = Path.home() / ".config" / "myapp" config_file = config_dir / "settings.json" print(f"配置文件路径: {config_file}") # 自动使用正确的路径分隔符 # Python os.path也有跨平台能力 import os.path as osp config_dir = osp.join(os.path.expanduser("~"), ".config", "myapp") config_file = osp.join(config_dir, "settings.json") # 路径规范化（处理用户输入） raw_path = "C:/Users/name//project\\\\sub" normalized = osp.normpath(raw_path) print(f"规范化后: {normalized}") # ============================================ # 跨平台执行Shell命令 # ============================================ def run_command(cmd: str, shell: bool = True) -> str: """跨平台执行Shell命令""" try: result = subprocess.run( cmd, shell=shell, capture_output=True, text=True, check=False ) if result.returncode == 0: return result.stdout.strip() else: print(f"命令执行失败 (exit code: {result.returncode})") print(f"stderr: {result.stderr}") return "" except Exception as e: print(f"执行命令异常: {e}") return "" # 跨平台命令示例 if is_windows: # Windows上使用PowerShell username = run_command("powershell -Command \"[Environment]::UserName\"") else: username = run_command("whoami") print(f"当前用户: {username}") # ============================================ # 跨平台环境变量 # ============================================ def get_env_var(name: str, default: str = "") -> str: """跨平台获取环境变量（不区分大小写）""" if is_windows: # Windows环境变量名不区分大小写 for key in os.environ: if key.upper() == name.upper(): return os.environ[key] return os.environ.get(name, default) # 获取用户主目录（跨平台方法） home = os.path.expanduser("~") # 或者使用pathlib home = Path.home() # ============================================ # 跨平台文件操作 # ============================================ def set_executable(filepath: str) -> bool: """跨平台设置可执行权限""" if is_windows: # Windows不需要设置执行位 return True try: st = os.stat(filepath) os.chmod(filepath, st.st_mode | 0o111) # 添加执行权限 return True except Exception as e: print(f"设置执行权限失败: {e}") return False def get_temp_dir() -> str: """跨平台获取临时目录""" if is_windows: return os.environ.get("TEMP", os.environ.get("TMP", "/tmp")) else: return tempfile.gettempdir() # 创建临时文件（自动清理） with tempfile.NamedTemporaryFile( mode="w", suffix=".tmp", prefix="hook_", delete=False ) as f: f.write("跨平台临时文件内容") tmp_path = f.name print(f"临时文件: {tmp_path}") # ============================================ # 主逻辑 # ============================================ def main(): print(f"系统: {system} {machine}") print(f"Python: {sys.version}") print(f"用户主目录: {home}") print(f"临时目录: {get_temp_dir()}") # 跨平台Hook逻辑 if is_windows: print("执行Windows特定的Hook逻辑") run_command("powershell -Command \"Write-Host 'Hook执行成功'\"") elif is_macos: print("执行macOS特定的Hook逻辑") run_command("osascript -e 'display notification \"Hook执行成功\"'") elif is_linux: print("执行Linux特定的Hook逻辑") run_command('notify-send "Hook执行成功"') else: print(f"不支持的平台: {system}") sys.exit(1) if __name__ == "__main__": main()

#!/usr/bin/env python3 # ============================================= # 跨平台Git Pre-commit Hook（Python实现） # 功能：代码格式检查、敏感信息扫描 # 兼容：Windows / macOS / Linux # ============================================= import os import sys import subprocess import re import json from pathlib import Path # 配置 SENSITIVE_PATTERNS = [ r'password\s*=\s*['"'"'"]?\w+['"'"'"]?', r'api[_-]?key\s*=\s*['"'"'"]?\w+['"'"'"]?', r'secret\s*=\s*['"'"'"]?\w+['"'"'"]?', r'token\s*=\s*['"'"'"]?\w+['"'"'"]?', r'AKIA[0-9A-Z]{16}', # AWS Access Key ] SKIP_PATTERNS = [ r'\.md$', r'\.txt$', r'\.json$', ] def run_git_command(args): """跨平台运行Git命令""" try: result = subprocess.run( ['git'] + args, capture_output=True, text=True, check=True, shell=(os.name == 'nt') # Windows需shell=True ) return result.stdout.strip().split('\n') except subprocess.CalledProcessError as e: print(f"Git命令失败: {e}") sys.exit(1) def get_staged_files(): """获取暂存的文件列表（跨平台）""" files = run_git_command(['diff', '--cached', '--name-only', '--diff-filter=ACM']) return [f for f in files if f] # 过滤空字符串 def check_sensitive_info(file_path): """检查文件中的敏感信息""" try: with open(file_path, 'r', encoding='utf-8', errors='ignore') as f: content = f.read() except Exception as e: print(f" 无法读取文件: {e}") return False found = False for i, line in enumerate(content.split('\n'), 1): for pattern in SENSITIVE_PATTERNS: if re.search(pattern, line, re.IGNORECASE): print(f" [警告] 第{i}行可能包含敏感信息: {line.strip()[:60]}...") found = True return found def check_trailing_whitespace(file_path): """检查行尾多余空白（跨平台）""" ext = Path(file_path).suffix if any(re.match(p, file_path) for p in SKIP_PATTERNS): return False try: with open(file_path, 'r', encoding='utf-8', errors='ignore') as f: lines = f.readlines() except Exception: return False found = False for i, line in enumerate(lines, 1): stripped = line.rstrip('\n\r') if stripped != stripped.rstrip(): print(f" [风格] 第{i}行尾部有多余空白: {file_path}") found = True return found def check_executable_bit(file_path): """检查Shell脚本是否有可执行权限（跨平台）""" if os.name == 'nt': # Windows跳过检查 return False ext = Path(file_path).suffix if ext == '.sh' and not os.access(file_path, os.X_OK): print(f" [权限] Shell脚本缺少可执行权限: {file_path}") return True return False def main(): print("正在运行跨平台Pre-commit Hook检查...") print(f"当前平台: {sys.platform}") staged_files = get_staged_files() if not staged_files: print("没有需要检查的文件") return 0 print(f"检查 {len(staged_files)} 个文件...\n") errors = 0 for file_path in staged_files: if not os.path.exists(file_path): continue print(f"检查: {file_path}") # 敏感信息检查 if check_sensitive_info(file_path): errors += 1 # 行尾空白检查 if check_trailing_whitespace(file_path): errors += 1 # 可执行权限检查 if check_executable_bit(file_path): errors += 1 print() if errors > 0: print(f"发现 {errors} 个问题，请修复后重新提交") print("提示: 使用 git commit --no-verify 可跳过Hook检查") return 1 else: print("所有检查通过！") return 0 if __name__ == "__main__": sys.exit(main())

# PowerShell与Bash语法对照示例 # ---- Bash ---- #!/bin/bash NAME="World" echo "Hello, ${NAME}!" if [ -f "/etc/passwd" ]; then echo "文件存在" fi for i in 1 2 3; do echo "Number: $i" done # ---- PowerShell ---- # 保存为 script.ps1 $NAME = "World" Write-Host "Hello, $NAME!" if (Test-Path "C:\Windows\System32\drivers\etc\hosts") { Write-Host "文件存在" } foreach ($i in 1..3) { Write-Host "Number: $i" } # ---- CMD (传统Windows) ---- REM 保存为 script.cmd SET NAME=World ECHO Hello, %NAME%! IF EXIST "C:\Windows\System32\drivers\etc\hosts" ( ECHO 文件存在 ) REM CMD没有方便的for循环语法

# PowerShell中兼容运行Unix命令的多种方式 # 方式一：使用PowerShell原生替代命令 # grep → Select-String Get-Content "log.txt" | Select-String -Pattern "ERROR" # 等同于: grep "ERROR" log.txt # sed → -replace 操作符 (Get-Content "config.txt") -replace "foo", "bar" | Set-Content "config.txt" # 等同于: sed -i 's/foo/bar/g' config.txt # wc -l → Measure-Object Get-Content "log.txt" | Measure-Object -Line # 等同于: wc -l log.txt # sort → Sort-Object Get-Content "names.txt" | Sort-Object # 等同于: sort names.txt # head/tail → Select-Object Get-Content "log.txt" | Select-Object -First 10 # head -10 Get-Content "log.txt" | Select-Object -Last 10 # tail -10 # curl → Invoke-WebRequest / Invoke-RestMethod Invoke-RestMethod -Uri "https://api.example.com/data" -Method Get # 方式二：使用环境判断自动选择命令 function Invoke-CrossPlatformCommand { param( [string]$UnixCommand, [string]$PowerShellCommand ) if ($IsWindows -or $env:OS -eq "Windows_NT") { # 检查PowerShell等效命令是否存在 if (Get-Command $PowerShellCommand -ErrorAction SilentlyContinue) { return Invoke-Expression $PowerShellCommand } # 检查是否有Git Bash提供的Unix工具 $gitBashPath = "$env:ProgramFiles\Git\usr\bin" if (Test-Path "$gitBashPath\$UnixCommand.exe") { return & "$gitBashPath\$UnixCommand.exe" $args } } else { return & $UnixCommand $args } } # 方式三：使用WSL运行Unix命令（如果安装了WSL） function Invoke-WSLCommand { param([string]$Command) if (Get-Command wsl -ErrorAction SilentlyContinue) { return wsl -- $Command } else { Write-Warning "WSL未安装，请使用PowerShell原生命令" } } # 方式四：使用Git Bash中集成的Unix工具 # Git for Windows在安装时会包含MinGW64工具集 $unixTools = @( "$env:ProgramFiles\Git\usr\bin", "$env:ProgramFiles\Git\mingw64\bin", "${env:LOCALAPPDATA}\Programs\Git\usr\bin" ) function Find-UnixTool { param([string]$ToolName) foreach ($dir in $unixTools) { $toolPath = Join-Path $dir "$ToolName.exe" if (Test-Path $toolPath) { return $toolPath } } return $null } # 使用grep $grepPath = Find-UnixTool -ToolName "grep" if ($grepPath) { & $grepPath "ERROR" "log.txt" }

# ---- 不同平台/Shell的环境变量读取方式 ---- # Bash (Linux/macOS) # $HOME → /home/user 或 /Users/user # $USER → 用户名 # $PATH → 以冒号分隔的路径列表 # $PWD → 当前工作目录 # $SHELL → 当前Shell路径 # PowerShell (Windows) # $env:USERPROFILE → C:\Users\用户名 # $env:USERNAME → 用户名 # $env:PATH → 以分号分隔的路径列表 # $env:APPDATA → C:\Users\用户名\AppData\Roaming # $env:LOCALAPPDATA → C:\Users\用户名\AppData\Local # $env:TEMP → C:\Users\用户名\AppData\Local\Temp # CMD (Windows) # %USERPROFILE% → C:\Users\用户名 # %USERNAME% → 用户名 # %APPDATA% → C:\Users\用户名\AppData\Roaming # ---- 跨平台环境变量适配函数（PowerShell） ---- function Get-CrossPlatformHome { if ($IsWindows -or $env:OS -eq "Windows_NT") { return $env:USERPROFILE } else { return $env:HOME } } function Get-CrossPlatformPath { param([string[]]$PathComponents) if ($IsWindows -or $env:OS -eq "Windows_NT") { return $PathComponents -join "\" } else { return $PathComponents -join "/" } } # ---- 跨平台环境变量适配函数（Bash） ---- get_home_dir() { if [ -n "$HOME" ]; then echo "$HOME" elif [ -n "$USERPROFILE" ]; then echo "$USERPROFILE" else echo "$(cd ~ && pwd)" fi } # ---- Python跨平台环境变量读取 ---- function get_env_cross_platform() { python3 -c " import os # 跨平台获取指定环境变量（不区分大小写检查） def get_env(name): val = os.environ.get(name) if val is None and os.name == 'nt': # Windows环境变量名不区分大小写 for key in os.environ: if key.upper() == name.upper(): return os.environ[key] return val print(get_env('HOME') or get_env('USERPROFILE') or '') " }

# ---- Bash退出码处理 ---- #!/bin/bash some_command if [ $? -eq 0 ]; then echo "命令执行成功" else echo "命令执行失败，退出码: $?" exit 1 fi # ---- PowerShell退出码处理 ---- # 重要差异：PowerShell的错误处理更加复杂 # 方式一：使用$LASTEXITCODE（仅适用于外部程序） notepad.exe nonexistent.txt 2>$null Write-Host "退出码: $LASTEXITCODE" # 正确获取外部程序退出码 # 方式二：使用$?（自动变量，表示上一个命令是否成功） Test-Path "C:\Windows" Write-Host "上一个命令是否成功: $?" # True/False # 方式三：使用try/catch/finally（推荐） try { # 使用 -ErrorAction Stop 确保错误会被捕获 Get-Content "config.json" -ErrorAction Stop Write-Host "文件读取成功" } catch [System.IO.FileNotFoundException] { Write-Host "文件未找到: $_" exit 1 } catch { Write-Host "其他错误: $_" exit 2 } finally { Write-Host "无论成功或失败都会执行" } # 方式四：PowerShell中的错误处理偏好设置 # $ErrorActionPreference 控制错误处理行为 $ErrorActionPreference = "Stop" # 遇到任何错误立即停止 # $ErrorActionPreference = "Continue" # 默认行为：显示错误但继续执行 # $ErrorActionPreference = "SilentlyContinue" # 静默忽略错误 # 方式五：执行批处理文件并检查退出码 function Invoke-BatchFile { param([string]$FilePath) $process = Start-Process -FilePath $FilePath -NoNewWindow -Wait -PassThru return $process.ExitCode } # ---- 跨平台退出码处理（PowerShell版） ---- function Invoke-CrossPlatformScript { param( [string]$ScriptPath, [string[]]$Arguments ) $ext = [System.IO.Path]::GetExtension($ScriptPath).ToLower() switch ($ext) { ".sh" { # 执行Shell脚本 if (Get-Command "bash" -ErrorAction SilentlyContinue) { $result = bash $ScriptPath @Arguments return $LASTEXITCODE } elseif (Get-Command "wsl" -ErrorAction SilentlyContinue) { $result = wsl -- $ScriptPath @Arguments return $LASTEXITCODE } else { Write-Error "未找到Bash或WSL，无法执行Shell脚本" return 1 } } ".ps1" { # 执行PowerShell脚本 try { & $ScriptPath @Arguments -ErrorAction Stop return 0 } catch { Write-Error "PowerShell脚本执行失败: $_" return 1 } } ".py" { # 执行Python脚本 if (Get-Command "python" -ErrorAction SilentlyContinue) { $result = python $ScriptPath @Arguments return $LASTEXITCODE } else { Write-Error "未找到Python" return 1 } } default { Write-Error "不支持的脚本类型: $ext" return 1 } } } # ---- 关键注意事项 ---- # 1. PowerShell中，exit 0不一定表示成功 # 如果脚本之前发生了终止错误，exit 0可能不会被执行到 # 2. 外部程序（如git、node）的退出码通过$LASTEXITCODE获取 # PowerShell cmdlet不会设置$LASTEXITCODE # 3. 在PowerShell中，非零退出码不会自动停止脚本执行 # 需要显式检查 $LASTEXITCODE 并处理 # 4. 使用 trap 关键字可以捕获所有终止错误 trap { Write-Error "捕获到未处理的错误: $_" exit 1 }

# 跨平台手动测试清单 # 在每个目标平台上执行以下测试： # 1. 基本功能测试 ./hook-script.sh --help # 帮助信息是否正常显示 ./hook-script.sh --version # 版本信息 ./hook-script.sh dry-run # 试运行模式测试 # 2. 路径处理测试 ./hook-script.sh --config "./config/test.json" # 相对路径 ./hook-script.sh --config "/absolute/path/config.json" # 绝对路径 ./hook-script.sh --config "~/config.json" # 家目录路径 ./hook-script.sh --config "C:\Users\test\config.json" # Windows路径 # 3. 环境变量测试 HOME=/custom/home ./hook-script.sh # 自定义HOME USERPROFILE=/custom/profile ./hook-script.sh # 自定义USERPROFILE TEMP=/custom/tmp ./hook-script.sh # 自定义临时目录 # 4. 错误处理测试 ./hook-script.sh --config "/nonexistent/path" # 不存在的路径 ./hook-script.sh --invalid-flag # 无效参数 ./hook-script.sh # 缺少必要参数

# 跨平台测试脚本示例 # 保存为 test-cross-platform.sh #!/bin/bash # 跨平台测试脚本 - 在多个平台上验证Hook脚本的兼容性 TEST_SCRIPT="./cross-platform-hook.sh" PLATFORMS=("windows" "macos" "linux") TESTS_PASSED=0 TESTS_FAILED=0 # 颜色输出 RED='\033[0;31m' GREEN='\033[0;32m' NC='\033[0m' # No Color print_result() { local test_name="$1" local result="$2" if [ "$result" = "PASS" ]; then echo -e "${GREEN}[PASS]${NC} $test_name" TESTS_PASSED=$((TESTS_PASSED + 1)) else echo -e "${RED}[FAIL]${NC} $test_name" TESTS_FAILED=$((TESTS_FAILED + 1)) fi } # 测试1：检测平台是否正确 echo "=== 测试: 平台检测 ===" CURRENT_PLATFORM="" case "$(uname -s)" in Linux) CURRENT_PLATFORM="linux" ;; Darwin) CURRENT_PLATFORM="macos" ;; CYGWIN*|MINGW*|MSYS*) CURRENT_PLATFORM="windows" ;; esac print_result "平台检测 ($CURRENT_PLATFORM)" "PASS" # 测试2：路径分隔符处理 echo "=== 测试: 路径处理 ===" if [ "$CURRENT_PLATFORM" = "windows" ]; then # Windows上测试Python路径处理 python3 -c " import os p = os.path.join('config', 'settings.json') assert '\\\\' in p or '/' in p, '路径连接失败' print(f'路径连接测试通过: {p}') " print_result "路径分隔符处理" "PASS" else # Unix上测试路径处理 TEST_PATH="/tmp/test-dir" mkdir -p "$TEST_PATH" if [ -d "$TEST_PATH" ]; then print_result "路径创建测试" "PASS" fi rmdir "$TEST_PATH" fi # 测试3：环境变量读取 echo "=== 测试: 环境变量 ===" HOME_DIR="" if [ -n "$HOME" ]; then HOME_DIR="$HOME" elif [ -n "$USERPROFILE" ]; then HOME_DIR="$USERPROFILE" fi if [ -n "$HOME_DIR" ]; then print_result "环境变量读取 ($HOME_DIR)" "PASS" else print_result "环境变量读取" "FAIL" fi # 测试4：执行权限检测 echo "=== 测试: 执行权限 ===" if [ "$CURRENT_PLATFORM" != "windows" ]; then chmod +x "$TEST_SCRIPT" 2>/dev/null if [ -x "$TEST_SCRIPT" ]; then print_result "执行权限设置" "PASS" else print_result "执行权限设置" "FAIL" fi else print_result "执行权限（Windows跳过）" "PASS" fi # 测试5：退出码处理 echo "=== 测试: 退出码 ===" python3 -c "import sys; sys.exit(0)" if [ $? -eq 0 ]; then print_result "退出码（成功）" "PASS" else print_result "退出码（成功）" "FAIL" fi python3 -c "import sys; sys.exit(1)" if [ $? -ne 0 ]; then print_result "退出码（失败）" "PASS" else print_result "退出码（失败）" "FAIL" fi # 总结 echo "" echo "========== 测试结果 ==========" echo -e "${GREEN}通过: $TESTS_PASSED${NC}" echo -e "${RED}失败: $TESTS_FAILED${NC}" echo "==============================" if [ $TESTS_FAILED -eq 0 ]; then echo "所有测试通过！" exit 0 else echo "存在测试失败，请检查" exit 1 fi

# GitHub Actions 跨平台测试配置 # 保存为 .github/workflows/cross-platform-test.yml name: 跨平台Hook兼容性测试 on: push: branches: [ main, develop ] paths: - 'hooks/**' - '.github/workflows/**' pull_request: branches: [ main ] paths: - 'hooks/**' jobs: test: name: 测试 (${{ matrix.os }}) runs-on: ${{ matrix.os }} strategy: fail-fast: false # 一个平台失败不影响其他平台 matrix: os: [ubuntu-latest, macos-latest, windows-latest] shell: [bash, pwsh] exclude: # Windows上排除Bash测试（使用PowerShell替代） - os: windows-latest shell: bash include: # Windows上增加PowerShell测试 - os: windows-latest shell: pwsh # 也测试Windows上的PowerShell 5.1 - os: windows-latest shell: powershell steps: - name: 检出代码 uses: actions/checkout@v4 - name: 设置Python uses: actions/setup-python@v5 with: python-version: '3.12' - name: 设置Node.js uses: actions/setup-node@v4 with: node-version: '20' - name: 显示系统信息 shell: ${{ matrix.shell }} run: | echo "操作系统: $(uname -s 2>/dev/null || echo 'Windows')" echo "架构: $(uname -m 2>/dev/null || echo 'x86_64')" echo "Shell: $SHELL" echo "Python: $(python3 --version 2>/dev/null || python --version)" echo "Node.js: $(node --version 2>/dev/null || echo 'N/A')" - name: 设置Hook脚本执行权限 if: runner.os != 'Windows' shell: ${{ matrix.shell }} run: | chmod +x hooks/*.sh chmod +x hooks/**/*.sh - name: 运行Shell兼容性测试 shell: ${{ matrix.shell }} run: | if [ "${{ runner.os }}" = "Windows" ]; then # Windows使用PowerShell测试 powershell -ExecutionPolicy Bypass -File tests/run-tests.ps1 else # Unix使用Bash测试 bash tests/run-tests.sh fi - name: 运行Python跨平台测试 shell: ${{ matrix.shell }} run: | python3 tests/test_cross_platform.py - name: 运行Node.js跨平台测试 shell: ${{ matrix.shell }} run: | node tests/test_cross_platform.js - name: 路径兼容性测试 shell: ${{ matrix.shell }} run: | # 测试含空格的路径 python3 -c " import tempfile, os from pathlib import Path # 创建含空格的测试目录 test_dir = tempfile.mkdtemp(suffix=' test dir') test_file = Path(test_dir) / 'config file.json' test_file.write_text('{\"test\": true}') assert test_file.exists(), f'文件不存在: {test_file}' print(f'路径兼容性测试通过: {test_file}') os.rmdir(test_dir) " - name: 环境变量兼容性测试 shell: ${{ matrix.shell }} run: | python3 -c " import os home = os.path.expanduser('~') assert home and os.path.isdir(home), f'用户主目录无效: {home}' print(f'用户主目录: {home}') temp = tempfile.gettempdir() print(f'临时目录: {temp}') " - name: 收集测试结果 if: always() shell: bash run: | echo "## 跨平台测试结果 (${{ matrix.os }})" >> $GITHUB_STEP_SUMMARY echo "- Shell: ${{ matrix.shell }}" >> $GITHUB_STEP_SUMMARY echo "- 状态: ${{ job.status }}" >> $GITHUB_STEP_SUMMARY

# ============================================= # 跨平台Hook兼容性检查清单 # 在每个目标平台上逐一检查 # ============================================= # [ ] 1. 基本执行 # [ ] 脚本能否在目标平台上无错误执行 # [ ] shebang行正确（或用正确的解释器调用） # [ ] 文件权限正确（Unix上可执行） # [ ] 2. 路径处理 # [ ] 所有路径变量用引号包裹 # [ ] 没有硬编码的路径分隔符 # [ ] 使用os.path.join()或pathlib处理路径（Python） # [ ] 或使用path.join()处理路径（Node.js） # [ ] 测试了含空格的路径 # [ ] 测试了含Unicode字符的路径 # [ ] 用户主目录获取方式支持多平台 # [ ] 3. 环境变量 # [ ] 没有使用平台特定的环境变量名 # [ ] $HOME / %USERPROFILE% 有降级处理 # [ ] PATH分隔符正确处理（Unix: :, Windows: ;） # [ ] 环境变量读取有默认值 # [ ] 4. Shell命令 # [ ] 没有使用平台不存在的命令 # [ ] 或使用了条件判断/fallback机制 # [ ] grep/sed/awk等命令有跨平台替代方案 # [ ] curl/wget在Windows上有替代（Invoke-WebRequest） # [ ] 5. 退出码和错误处理 # [ ] 退出码在所有平台上语义一致 # [ ] 错误信息在不同平台都能正确显示 # [ ] stderr重定向行为正确 # [ ] 异常/错误被正确捕获和处理 # [ ] 6. 文件操作 # [ ] 文件读写使用跨平台方式（指定encoding） # [ ] 临时文件创建使用跨平台API # [ ] 文件权限处理有平台判断 # [ ] 换行符处理正确 # [ ] 7. 网络请求 # [ ] curl命令在Windows上有替代方案 # [ ] 或使用Python requests / Node.js fetch # [ ] SSL证书验证在所有平台上正常工作 # [ ] 代理设置兼容多平台 # [ ] 8. CI测试 # [ ] GitHub Actions（或等效CI）配置了多平台测试 # [ ] matrix中包含ubuntu/macos/windows # [ ] 同时测试Bash和PowerShell # [ ] 至少有一个平台运行了完整的端到端测试 # [ ] 9. 文档 # [ ] README中注明了支持的平台 # [ ] 列出了已知的兼容性限制 # [ ] 提供了各平台的安装/配置说明 # [ ] 有常见问题（FAQ）或排错指南 # [ ] 10. 回归测试 # [ ] 所有平台上的测试全部通过 # [ ] 代码变更后重新运行所有平台测试 # [ ] 第三方依赖更新后重新验证兼容性 # [ ] 操作系统大版本更新后重新测试