Go strconv.ParseComplex 怎样读取复数字符串

Go 可以用 strconv.ParseComplex(text, 128) 将复数字符串读成 complex128；目标若是 complex64 精度，则传入 64。无论选择哪一种精度，函数返回类型都是 complex128，同时返回 error，读取后应先处理错误再使用结果。

复数配置不适合简单地按加号或减号切分：指数记法内部也可能出现符号。把文本解析交给 ParseComplex，把空白处理、精度和业务范围留在调用方明确规定。

官方文档：https://pkg.go.dev/strconv#ParseComplex。下面以信号计算中的 gain 配置为原创示例，围绕数值输入展开，不涉及文件格式解析或计算算法。

让标准库接管复数格式

假设配置项 gain 最初只接受 2.75-0.5i，处理器通过寻找减号把文本切成两段。后来用户输入 1e+2+3e-1i，其中的符号既有复数分隔符，也有指数符号，原先的切分方法就不再可靠。

这个场景需要的是识别完整复数文本，而不是逐个字符修补分隔规则。ParseComplex 已经提供了对应的标准库入口，可以把调用点简化为“文本、目标精度、结果与错误”四个部分。它是现有能力，本文没有将其描述为近期发布的新功能。

示例把读取 gain 的业务函数命名为 parseGain。函数允许配置首尾有空白，但拒绝数值内部的空白；同时规定实部、虚部必须是有限值。这些是示例接口选择，不能与标准库接受的全部范围混为一谈。

先确定允许的输入文本

常见形式可以概括为实数、带 i 的纯虚数，以及实部加虚部；完整形式也可以包在一对圆括号中。下面的表格给出本文示例要表达的输入含义，作为阅读与自行运行时的参考，而非实测输出。

不要把数学排版里的 i、j 或省略系数等写法随意混进接口。本文按带数字系数的 i 形式传入，例如 1i；需要接受其他语法时，应先把接口约定写清楚。TrimSpace 只去掉两端空白，不会替用户修正内部表达式。

按目标精度调用 ParseComplex

下面是完整的 main.go 示例。它逐条读取预设配置，并把格式错误、范围错误和业务限制分开报告；代码未在这里执行。

package main

import (
    "errors"
    "fmt"
    "math"
    "strconv"
    "strings"
)

// parseGain 接受有限的复数配置；仅允许输入两端出现空白。
func parseGain(text string, bits int) (complex128, error) {
    if bits != 64 && bits != 128 {
        return 0, fmt.Errorf("gain: unsupported bit size %d", bits)
    }
    input := strings.TrimSpace(text)
    z, err := strconv.ParseComplex(input, bits)
    if err != nil {
        // 保留底层错误，调用方可以用 errors.Is 区分错误种类。
        return 0, fmt.Errorf("gain: %w", err)
    }
    if math.IsNaN(real(z)) || math.IsNaN(imag(z)) ||
        math.IsInf(real(z), 0) || math.IsInf(imag(z), 0) {
        return 0, fmt.Errorf("gain: finite components required")
    }
    return z, nil
}

func main() {
    // 同一组输入展示实部、虚部、指数记法及错误分支。
    inputs := []string{"2.75-0.5i", "1e+2+3e-1i", "4i", "3 + 2i", "1e100+2i"}
    for _, input := range inputs {
        z, err := parseGain(input, 64)
        switch {
        case err == nil:
            fmt.Printf("%q: real=%g imag=%g\n", input, real(z), imag(z))
        case errors.Is(err, strconv.ErrSyntax):
            fmt.Printf("%q: invalid format\n", input)
        case errors.Is(err, strconv.ErrRange):
            fmt.Printf("%q: component out of range\n", input)
        default:
            // 与标准库格式错误分开报告业务限制或参数错误。
            fmt.Printf("%q: %v\n", input, err)
        }
    }
}

bitSize 选择的是复数的目标精度：64 对应 complex64，128 对应 complex128。complex64 的实部与虚部各采用 float32 精度，complex128 的两个分量各采用 float64 精度。因此传 64 不是让两个分量都获得 float64 精度。

ParseComplex 在 bitSize 为 64 时仍返回 complex128，但其中的值已经按 complex64 精度确定，可以再转换成 complex64。若后续存储就是 complex64，应在解析时选择 64；先按 128 解析、随后再缩窄，会把范围与精度决策推迟到转换处。

示例中的 1e100+2i 在 64 精度下用于说明分量范围错误；换成 128 时不能沿用相同的预期判断。一次配置读取应由接口固定目标精度，而不是根据字符串看起来是否“大”临时切换。

把格式错误与范围错误分开

错误分类有助于给用户可执行的反馈。语法不成立对应 ErrSyntax；分量超出目标精度可表示的范围，对应 ErrRange。标准库通过 NumError 携带输入信息，示例用 fmt.Errorf 的 %w 包装错误后，仍可由 errors.Is 判断种类。

遇到非空 error，示例直接返回，不继续用随错误返回的数值参与计算。范围错误可能伴随相应分量的无穷值，忽略错误会把坏配置带进后续计算。另一方面，显式的特殊值输入与溢出错误并不是同一个概念，所以 parseGain 还在解析成功后检查两个分量是否为 NaN 或 Inf。

业务提示可以分别写成“格式不支持”“超出目标精度范围”和“该字段要求有限分量”。这样既保留技术错误，也不会把业务拒绝包装成标准库解析失败。若输入来自外部用户，还应按字段要求设置长度上限并控制错误日志内容。

替换手工切分并保留业务约束

迁移旧处理器时，可以保留原字段名与配置来源，只把手写数值解析替换为 parseGain。先明确是否允许首尾空白、目标类型和特殊值，再调整调用点。不要为了适配旧输入直接删除全部空格，因为这可能把原本不合法的文本悄悄变成另一个输入。

能不能用 ParseFloat 两次代替？

可以在输入本来就是两个独立字段时分别读取；如果输入是一段完整复数字符串，还需要正确识别分隔位置。这个场景直接使用 ParseComplex 更清楚。

返回 complex128，为什么还要传 64？

返回类型与目标精度是两件事。传 64 可以让解析阶段就按 complex64 的精度和范围处理，避免调用点误以为之后的缩窄转换不会改变判断。

是否应该把解析成功的值全部接受？

取决于字段含义。标准库负责读取数字，gain 配置还可以限制有限值、模长或其他领域条件；这些约束应明确写在业务函数里。

在这个配置场景中，重要的改动是去掉手工查找正负号，把完整文本交给 ParseComplex，同时保留明确的精度与错误分支。读者可以用表格中的输入自行观察结果，本文的结构图不代表运行证据。

API 说明：https://pkg.go.dev/strconv#ParseComplex；复数类型定义：https://go.dev/ref/spec#Complex_types。