Alias Jump

中文文档

A VS Code extension that enables navigation to alias path definitions with Ctrl+Click. Perfect for projects using path aliases like @/components/Button.

Features

Alias Path Navigation: Jump to files using path aliases (e.g., @/components/Button)
Resolved Path Hover: Hover an alias or relative path to see the resolved file path
Relative Path Support: Also works with ./ and ../ relative paths
Multi-language Support: Works with Vue, JavaScript, TypeScript, JSX, TSX, CSS, SCSS, Less, Svelte, and uni-app (.nvue, .uvue)
Automatic Config Detection: Reads aliases from VS Code settings, Vite, Webpack, tsconfig.json, and jsconfig.json
tsconfig/jsconfig Extends Support: Reads aliases inherited from extended config files
Auto Suffix Resolution: Automatically resolves file extensions (.js, .vue, .ts, .css, .scss, .less, .nvue, .uvue, etc.)
Nested Project Root Detection: Finds the closest configured root marker, useful for monorepos
Performance Optimized: Caches resolved project configs for faster navigation

Usage

Use aliases in VS Code settings, Vite, Webpack, tsconfig.json, or jsconfig.json
Hold Ctrl (or Cmd on macOS) and click on an alias path
The editor will navigate to the target file
Hover the same path to inspect the resolved absolute file path

Example

// With alias configured as { "@": "src" }
import Button from '@/components/Button'  // Ctrl+Click to navigate
import { utils } from '@/utils'           // Ctrl+Click to navigate

.logo {
  background-image: url(@/assets/logo);
}

Extension Settings

This extension contributes the following settings:

Setting	Type	Default	Description
`alias-jump-pro.mappings`	object	`{ "@": "/src" }`	Path mappings. Key is the alias, value is the path relative to project root.
`alias-jump-pro.rootpath`	string	`"package.json"`	File name used to find the closest project root from the current file.
`alias-jump-pro.allowedsuffix`	array	`["js", "vue", "jsx", "ts", "tsx", "svelte", "css", "scss", "less", "nvue", "uvue"]`	File extensions used when resolving paths without an extension.

Configuration Example

Add to your settings.json:

{
  "alias-jump-pro.mappings": {
    "@": "src",
    "@components": "src/components",
    "@utils": "src/utils",
    "@assets": "src/assets"
  },
  "alias-jump-pro.allowedsuffix": ["js", "vue", "jsx", "ts", "tsx", "svelte", "css", "scss", "less", "nvue", "uvue"]
}

Automatic Config Sources

Alias Jump uses the following priority order:

VS Code setting alias-jump-pro.mappings
Vite resolve.alias
Webpack resolve.alias
tsconfig.json / jsconfig.json compilerOptions.paths, including local extends chains
uni-app pages.json (detects src/ directory to determine mapping)
Fallback { "@": "src" }

uni-app: The extension automatically detects uni-app projects by pages.json. If src/ directory exists, maps @ → src; otherwise maps @ → project root. This covers HBuilderX, Vue CLI, and Vite created projects. .nvue and .uvue files are fully supported.

Commands

Command	Description
`Alias Jump: Reload Configuration`	Clear cache and reload configuration

Supported Languages

Vue (.vue)
JavaScript (.js)
TypeScript (.ts)
JSX (.jsx)
TSX (.tsx)
CSS (.css)
SCSS (.scss)
Less (.less)
Svelte (.svelte)
uni-app (.nvue, .uvue)

License

MIT

Alias Jump Pro

SeptWong