在 Go 程序里接收命令行传入的文件路径看似简单，但稍不注意就会写出有安全隐患或跨平台兼容问题的代码。很多初学者直接用字符串拼接构造路径，结果在 Linux 和 Windows 上表现不一致，甚至被用户传入的特殊路径绕过了访问限制。
使用 flag 包接收路径参数
Go 标准库中的 flag 包是处理命令行参数最直接的方式。我们可以定义一个字符串类型的变量来接收文件路径，flag 包会自动完成解析和默认值设置。不过要注意，flag 并不会对路径内容做任何校验，它只负责把字符串从命令行取出来。
下面是一段基础示例，演示如何定义一个路径参数并读取它：
package main
import (
"flag"
"fmt"
"os"
)
func main() {
// 定义文件路径参数，默认值为空字符串
path := flag.String("file", "", "要处理的文件路径")
flag.Parse()
if *path == "" {
fmt.Println("错误：未传入 -file 参数")
os.Exit(1)
}
fmt.Println("接收到的路径：", *path)
}
这段代码通过 flag.String 注册了一个名为 file 的参数。运行程序时加上 -file=./data.txt 即可传入路径。如果忘记传参，程序会提示错误并退出，避免后续逻辑使用空字符串导致崩溃。
路径规范化与安全检查
用户传入的路径可能包含 ../ 这类相对跳转片段，直接打开可能访问到预期目录之外的文件。我们需要用 filepath.Clean 先清理路径，再判断它是否落在允许的基目录中。
filepath.Rel 可以计算目标路径相对于基目录的相对路径，如果结果以 .. 开头，就说明发生了目录逃逸。以下示例展示如何安全地限制文件访问范围：
package main
import (
"path/filepath"
"strings"
"fmt"
)
func safeJoin(baseDir, inputPath string) (string, error) {
// 清理路径中的多余分隔符和跳转
cleaned := filepath.Clean(inputPath)
// 组合基目录与用户输入
fullPath := filepath.Join(baseDir, cleaned)
// 计算相对路径以判断是否在基目录内
rel, err := filepath.Rel(baseDir, fullPath)
if err != nil {
return "", err
}
if strings.HasPrefix(rel, "..") {
return "", fmt.Errorf("路径超出允许范围")
}
return fullPath, nil
}
在 Windows 上，filepath.Clean 和 Join 会自动处理盘符与反斜杠，比手动用字符串拼接可靠得多。即便用户输入 C:/foo/../../etc/passwd，经过处理后也会被准确识别为越界访问。
除了防越界，还应使用 os.Stat 确认路径指向的是普通文件而非目录或符号链接，避免后续读取逻辑出错。对符号链接可额外调用 filepath.EvalSymlinks 解析真实路径再做判断。
跨平台注意事项与完整示例
不同操作系统的路径分隔符和大小写规则不同。Go 的 path/filepath 包已经封装了这些差异，但开发者仍要避免使用 path 包（它只适用于斜杠分隔的 URL 风格路径）。另外，参数中可能混用单引号和双引号，flag 包能正确剥离外层引号。
下面的完整示例整合了参数解析、空值检查、路径安全校验与存在性验证：
package main
import (
"flag"
"fmt"
"os"
"path/filepath"
"strings"
)
func main() {
path := flag.String("file", "", "目标文件路径")
flag.Parse()
if *path == "" {
fmt.Println("请通过 -file 传入文件路径")
os.Exit(1)
}
baseDir, _ := os.Getwd()
cleaned := filepath.Clean(*path)
fullPath := filepath.Join(baseDir, cleaned)
rel, err := filepath.Rel(baseDir, fullPath)
if err != nil || strings.HasPrefix(rel, "..") {
fmt.Println("路径不合法或超出工作目录")
os.Exit(1)
}
info, err := os.Stat(fullPath)
if err != nil {
fmt.Println("文件无法访问：", err)
os.Exit(1)
}
if info.IsDir() {
fmt.Println("传入的是目录而非文件")
os.Exit(1)
}
fmt.Println("安全路径确认：", fullPath)
}
这个示例先取当前工作目录作为基目录，再将用户输入清理后拼接，通过相对路径前缀排查越界。最后用 os.Stat 确认文件存在且不是目录。整套逻辑在 Linux、macOS 和 Windows 下均可正常工作。
实际工程中，如果程序以服务形式运行，工作目录可能不稳定，建议将基目录显式配置为绝对路径常量。结合配置校验，可以进一步降低路径处理带来的风险。