Project Clice

English

简体中文

English

简体中文

Appearance

Inlay Hints ​

Parameter Name Hints ​

  • Named parameter hints at call sites

  • Skip when argument name matches parameter name

  • Skip for single-parameter calls with obvious semantics

  • Expand parameter packs (underlying_pack_type detection)

  • Resolve parameter names from definition (not just declaration)

  • Forwarding function parameter resolution — show the underlying constructor parameters for std::make_unique, emplace_back, etc. (clangd#2324)

    cpp
    struct Widget { Widget(int width, int height); };
auto p = std::make_unique<Widget>(800, 600);
//                                ^^^  ^^^
//                          width: 800, height: 600 (not __args: 800, __args: 600)

  • Function pointer and operator() parameter hints (clangd#1734, clangd#1742)

    cpp
    void (*callback)(int status, const char* msg);
callback(0, "ok");
//       ^   ^^
//  status: 0, msg: "ok"

auto cmp = [](int a, int b) { return a < b; };
cmp(1, 2);
//  ^  ^
//  a: 1, b: 2

  • Template parameter hints — show deduced/explicit template arguments (clangd#2583)

    cpp
    template<typename T, typename U>
auto convert(U val) -> T;
convert<float>(42);
//      ^^^^^  ^^
//   T: float, val: 42

  • Case-insensitive parameter name matching — aParam should suppress hint for argument param (clangd#2248)

  • Suppress hints when an inline comment already names the parameter (clangd#1877)

    cpp
    draw(/*x=*/10, /*y=*/20);  // no hints needed — inline comments serve the same purpose

  • Default argument value hints

Type Hints ​

  • auto deduced type hints

  • Structured binding type hints

  • Lambda return type hints

  • Range-based for loop variable type hints

  • Lambda init-capture type hints (clangd#1163)

    cpp
    auto f = [val = compute()] {};
//        ^^^ : int

  • Dependent auto type hints — show deduced type when useful even in template bodies (clangd#2275)

  • Don't show type hint when deduction fails (clangd#1475)

  • Don't show type hint when the type is explicitly specified (clangd#1749)

    cpp
    auto x = static_cast<int>(val);  // no type hint — already explicit
auto y = int{42};                 // same

  • Prefer desugared types — show std::vector<int> rather than a typedef alias (clangd#1298, clangd#1668)

    cpp
    using IntVec = std::vector<int>;
IntVec create();
auto v = create();
//   ^ : std::vector<int>  (not IntVec)

  • Configurable type hint length limit (clangd#1357)

  • Abbreviated type hints with expandable label parts — use LSP InlayHintLabelPart to allow expanding truncated types (clangd#2269)

    auto it = map.begin();
//   ^^ : map<str…, int>::iterator  [click to expand]

  • Shorten hints by suppressing obvious scopes (clangd#2270)

    cpp
    // inside namespace foo:
auto x = create();
//   ^ : Bar  (not foo::Bar)

Designator Hints ​

  • Aggregate initializer designators (.field =) — show field names for positional aggregate initialization

    cpp
    struct Point { int x, y, z; };
Point p = {1, 2, 3};
//         ^  ^  ^
//    .x = 1, .y = 2, .z = 3

  • Parenthesized aggregate initialization (C++20) (clangd#2540)

    cpp
    Point p(1, 2, 3);
//      ^  ^  ^
// .x = 1, .y = 2, .z = 3

  • Compact array designator formatting (clangd#2303)

    cpp
    int arr[] = {10, 20, 30};
//           ^^  ^^  ^^
//      [0]= 10, [1]= 20, [2]= 30

Implicit Conversion Hints ​

  • Show implicit type conversions at call sites and assignments (clangd#2254)

    cpp
    void process(double val);
process(42);
//      ^^
//      (double) 42  — implicit int→double conversion

std::string s = "hello";
//              ^^^^^^^
//    (std::string) "hello"  — implicit const char*→string conversion

Reference / Pointer Hints ​

  • Show & / && to indicate the argument is passed by mutable reference (clangd#1123)

    cpp
    void sort(std::vector<int>& v);
sort(data);
//   ^^^^
//   &data  — passed by mutable reference

Template Argument Hints ​

  • CTAD deduced template arguments (clangd#2331)

    cpp
    std::pair p(1, 3.14);
//        ^ <int, double>

Block End Hints ​

  • Show the declared name after a closing brace for long blocks (clangd#1634)

    cpp
    void Widget::processData(const Config& cfg) {
    // ... 50+ lines ...
} // Widget::processData

  • #endif hints — show the corresponding macro condition (clangd#2487)

    cpp
    #ifdef _WIN32
    // ...
#endif // _WIN32

Interactive Hints ​

  • Range-filtered results (hints outside the requested range are discarded; AST traversal is not range-limited)

  • Left-anchored hints (parameter names before argument)

  • Right-anchored hints (types after variable name)

  • Clickable type names — go-to-definition on hinted type names via LSP InlayHintLabelPart (clangd#1535)

    auto widget = create();
//   ^^^^^^ : Widget  ← click "Widget" to go to Widget's definition

Hint Correctness ​

Known issues that should be handled correctly:

  • Nested macro invocations must not produce incorrect parameter name hints (clangd#2620)
  • No duplicate hints in the presence of explicit function template instantiation (clangd#1034)
  • Parameter hints for inherited constructors called from derived classes (clangd#1364)
  • Parameter hints must not be lost when a coroutine returns a template type (clangd#2437)
  • C++23 deducing this — strip explicit object parameter from hint display (clangd#1777)

Changelog ​

DateChangePR
—Parameter name hints, type hints, range-scoped queries—

Copyright © 2024-2026