gleam-lang/gleam

False positive `This imported module is never used` when aliasing

Open

#5,145 opened on Nov 20, 2025

View on GitHub
 (2 comments) (0 reactions) (1 assignee)Rust (960 forks)batch import
help wanted

Repository metrics

Stars
 (21,417 stars)
PR merge metrics
 (Avg merge 10d 19h) (69 merged PRs in 30d)

Description

import bar/foo
import foo as baz

pub fn main() -> Nil {
  foo.go()
  baz.thing()
}

When running gleam check (or build, or the language server) on this code, it incorrectly states:

warning: Unused imported module
  ┌─ /tmp/tmp.0xlJkPoggL/import_shadow/src/import_shadow.gleam:1:1
  │
1 │ import bar/foo
  │ ^^^^^^^^^^^^^^ This imported module is never used

Hint: You can safely remove it.

See https://github.com/bo0tzz/gleam_reproductions/blob/import-shadow/src/import_shadow.gleam for a minimal project that reproduces this.

Contributor guide

Research direction
Investigate the import resolution logic in Gleam's compiler, specifically how aliased imports are handled. Look at the 'unused import' warning check and ensure it correctly accounts for aliases.
Tech stack
rust
Domain
backenddeveloper experience
Issue type
Bug
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
Half day
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
RustGitGleam
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
50