Go range 遍历整数怎么写：从 1 到 n 的边界、变量作用域与版本兼容

如果项目已经使用 Go 1.22 或更新版本，写一个“重复执行 n 次”的循环可以直接写成 for i := range n。它遍历的是从 0 到 n-1 的整数序列，不是从 1 到 n；当 n 小于等于 0 时循环一次也不执行。真正容易踩坑的地方在于版本兼容、边界表达和循环变量的作用域。

range n 是 Go 1.22 引入的整数遍历语法：正整数 n 产生 n 次迭代，变量从 0 开始；需要显示业务序号 1 到 n 时，应在循环体中使用 i + 1，或者继续使用三段式 for。

先看清 range n 到底产生什么

很多刚用上 Go 1.22 以上版本的开发者，都想试试用 range 直接遍历连续整数，省去手写传统 for 循环自增的步骤，最基础的写法直接在 range 后接整数常量或变量就能跑通。最小的可用示例如下：

package main

import "fmt"

func main() {
    for i := range 4 {
        fmt.Println(i)
    }
}

输出是 0、1、2、3。可以把它理解成“从零开始，最多拿到 n 个位置”，而不是把右端点也包含进来。这个规则与切片下标的习惯一致，适合生成批次编号、重试次数和测试样本下标。

从 1 到 n 时不要把右边界写错

面向普通用户展示的序号一般从1开始，这种场景下有两种可读性很高的写法。

for i := range n {
    page := i + 1
    fmt.Printf("处理第 %d 页\n", page)
}

for page := 1; page 

第一种写法保留了整数 range 的零基语义，第二种写法直接表达“从 1 到 n”。如果循环变量会被传给日志、分页参数或外部接口，我更建议优先使用第二种，避免读代码的人还要脑补一次加一操作。语法更短不等于语义更清楚。

零值和负数会让循环直接跳过

如果循环的整数范围来自配置项或者前端请求参数，要先明确非正数对应的业务逻辑：

func repeat(n int) {
    for i := range n {
        fmt.Println(i)
    }
}

repeat(3)  // 0, 1, 2
repeat(0)  // 没有输出
repeat(-1) // 没有输出

如果业务规则本身就要求输入次数不能为负，那就应该在进入循环前显式做参数校验，直接返回对应错误，不要把负数静默处理成无需执行。反过来如果零和负数本身的含义就是没有需要处理的项，直接跳过循环就是符合需求的正常行为。只要提前和调用方对齐这个约定就没问题。

整数 range 只能提供一个迭代值

遍历整数的时候不存在键和值两个维度，所以循环里只能声明一个循环变量：

for i := range 3 {
    fmt.Println(i)
}

下面这种写法是对range语法的错误理解，并不是同时拿到下标和元素值：

// 错误：整数 range 最多允许一个迭代变量
// for i, value := range 3 {}

如果确实需要用到第二个变量，应该先提前构造对应的切片或者其他可迭代数据结构，再按切片、数组、字符串或者map的常规规则去遍历。没必要为了硬凑出第二个变量，专门写一个很难读懂的临时结构来做整数遍历。

循环变量的作用域要看声明方式

用 := 声明时，变量属于循环语句，并且在 Go 1.22 的新语义下每次迭代都有自己的变量。下面的闭包会捕获当前迭代对应的值：

var jobs []func()
for i := range 3 {
    jobs = append(jobs, func() {
        fmt.Println(i)
    })
}

for _, job := range jobs {
    job()
}

在 Go 1.22 及之后的语言语义下，输出是 0、1、2。不过，如果循环变量是预先声明后再赋值，语义就不同：

var i int
var jobs []func()
for i = range 3 {
    jobs = append(jobs, func() {
        fmt.Println(i)
    })
}

这种写法让所有闭包共享外部的 i，不应该拿来收集异步任务。要表达“每轮保存一个值”，使用 := 声明，或者在循环体中创建一个新的局部副本，并在团队代码规范中保持一致。

旧版本项目如何选择写法

整数 range 属于 Go 1.22 的语言变化。项目要支持更早的编译器时，使用传统三段式循环最稳妥：

for i := 0; i 

如果模块已经把 go 版本设为 1.22 或更高，并且构建环境也使用相应工具链，就可以采用新写法。不要只在本机升级 Go 后提交代码，还要在 CI 或发布环境执行 go version，检查模块实际编译工具链。

做版本迁移的时候可以对照三个点来验证是否符合预期：

1. 循环总次数是否和之前保持一致，n为0或者负数时的执行逻辑是否还符合业务要求。
2. 代码里后续用到的是从0开始的下标，还是直接面向用户展示的从1开始的序号，两者不要搞混。
3. 循环体里有没有创建闭包、启动goroutine或者保存函数引用，循环变量是不是需要每轮迭代都生成独立副本。

把选择规则记成一张小表

最后用一个小测试锁住边界

这类写法语法很短，但边界逻辑最好用单测把约定固定下来：

func collect(n int) []int {
    got := make([]int, 0, max(n, 0))
    for i := range n {
        got = append(got, i)
    }
    return got
}

func TestCollect(t *testing.T) {
    if got := collect(3); !reflect.DeepEqual(got, []int{0, 1, 2}) {
        t.Fatalf("collect(3) = %v", got)
    }
    if got := collect(0); len(got) != 0 {
        t.Fatalf("collect(0) = %v", got)
    }
}

写测试的目的不是验证语法能不能正常编译，而是把「是否包含n」「负数输入怎么处理」「展示序号起始值是多少」这类很容易在后续重构中改跑偏的逻辑明确下来。之后不管选短写法还是传统的for循环写法，都是可以用测试用例验证的正常工程决策。

相关问题

Go 1.21 能直接写 range n 吗？

不能把整数直接作为 range 对象使用。需要兼容 Go 1.21 或更早工具链时，使用 for i := 0; i 。

range n 会遍历到 n 吗？

不会。n 为正数时最后一个值是 n-1；如果业务序号从 1 开始，需要使用 i + 1 或从 1 开始的三段式循环。

为什么闭包里打印出的循环变量不一样？

Go 1.22 改进了用 := 声明的循环变量捕获语义，每轮有独立变量；预先声明后再赋值的外部变量仍可能被所有闭包共享。